Mobile Integrations
This page covers external-service integrations configured from the Social Archiver mobile app: Immich, Raindrop, Notion, Reader, and Karakeep. For Instagram capture and its device-local signed-in session, see the Instagram platform guide.
Instagram has moved
Instagram now has its own platform guide, covering mobile and desktop sessions, Chrome imports, stories, subscriptions, and Immich export.
Overview
| Integration | Status | Best for | Connect with |
|---|---|---|---|
| Immich | Available | Sending archived photos and videos to a self-hosted media library | Immich server URL, API key, and album |
| Raindrop | Available when shown in your mobile app | Importing bookmarks and exporting new archive links | Raindrop OAuth |
| Notion | Available | Building a Notion database of archived posts and pages | Notion OAuth from the mobile app |
| Reader | Available when shown in your mobile app | Sending archives to Readwise Reader | Readwise access token |
| Karakeep | Beta, available when shown in your mobile app | Saving archives to a self-hosted bookmark manager | Karakeep server URL and API key |
Reader means Readwise Reader in the mobile app. If an integration does not appear in your settings, update the mobile app first. Some integrations can also depend on rollout or build availability.
Before You Connect
- Install and sign in to the Social Archiver mobile app.
- Open Settings -> Integrations.
- Keep Auto-sync enabled if you want completed archives to sync to Notion and other connected clients automatically.
- Use each integration's automatic setting for Immich, Raindrop, Reader, and Karakeep.
- Turn on WiFi only if you want client sync to wait for WiFi.
Each service needs its own authorization, token, or API key.
Immich
The Immich integration sends media from completed Social Archiver archives to an album on your self-hosted Immich server. You can save one archive manually, automatically upload media from new mobile archives, or use a server-synced connection for subscription exports.
Connect Immich on mobile
- In Immich, create an API key under Account Settings → API Keys.
- Open Settings → Integrations → Immich in the Social Archiver mobile app.
- Enter the Immich server URL and API key.
- Enter or select an album. Social Archiver can create the album if it does not exist.
- Tap Connect. The app verifies the credentials before saving them.
Private-network, Tailscale, and http:// addresses can be used for manual saves and mobile auto-upload while the phone can reach that address. A bare hostname defaults to HTTPS, so include http:// explicitly when required.
Save media
- Use Save to Immich from an archive action menu for one archive.
- Select multiple archives and use the bulk Immich export action.
- Enable Auto-upload new media and choose allowed platforms to send media from new mobile archives automatically.
- Select or create a default album from the connected Immich settings.
The archive must contain downloadable media. Immich duplicate checks prevent the same asset from being uploaded again when it can be identified; the app reports already-saved items instead of creating another copy.
Mobile-only and server-synced connections
| Connection status | Manual mobile save | Mobile auto-upload | Subscription auto-export |
|---|---|---|---|
| Mobile only | Yes, while the phone can reach Immich | Yes, while the phone can reach Immich | No |
| Server synced | Yes | Yes | Yes |
Subscription jobs run on Social Archiver servers. They require an Immich URL those servers can reach, such as a public HTTPS endpoint, Cloudflare Tunnel, or Tailscale Funnel. If a private or Tailscale-only URL works on your phone but not from the server, the app keeps the connection mobile-only instead of disabling manual export.
For local-only use, the API key is stored in mobile secure storage. If server sync succeeds, a copy is stored encrypted at rest so scheduled subscription exports can run. API keys are not included in analytics or logs.
Use Immich from Chrome
The Chrome extension has its own direct Immich connection under Settings → Immich Direct Upload. Enter the server URL and API key, select or create an album, and then upload media from supported direct-upload surfaces such as Instagram imports. The extension stores the API key in that Chrome profile; it does not require a Social Archiver server connection for direct uploads.
For sources that expose separate high-quality video and audio streams, Local Media Helper can merge them before upload.
Disconnect Immich
Disconnecting removes the saved credentials and stops future exports. Assets already uploaded to Immich are not deleted.
Raindrop
The Raindrop integration works in both directions: archive selected Raindrop bookmarks in Social Archiver, and save new Social Archiver archive links back to Raindrop.
Connect and configure
- Open Settings → Integrations → Raindrop.
- Tap Connect and approve the Raindrop OAuth request.
- Choose whether to check Raindrop automatically for new bookmarks.
- Enable Save new archives to Raindrop if you want automatic export, including subscription archives.
- Keep Exclude exported items enabled to avoid importing links that Social Archiver previously sent to Raindrop.
Use Import now to preview, search, filter by collection, and choose bookmarks to archive immediately. From an archive action menu, use Save to Raindrop for one item, or use the bulk export action for several items. Exported links include Social Archiver and platform tags.
Disconnecting stops future import and export but does not delete existing Raindrop bookmarks or Social Archiver archives.
Notion
The Notion integration syncs completed archives from the mobile app to a Notion workspace. Social Archiver can create or reuse a Social Archives database, then write each archive as a Notion page.
What It Sends
- Archive title, platform, original URL, archive ID, and archived date
- Available metadata such as author, handle, published date, likes, comments, shares, and views
- Archive content blocks and available media references
- Video upgrade processing where supported by the backend and Notion file limits
Connect Notion
- Open the mobile app.
- Go to Settings -> Integrations.
- Tap Connect on the Notion row.
- Authorize Social Archiver in the Notion browser flow.
- Grant access to the workspace or page where the database can be created.
- Return to Social Archiver after authorization completes.
After connection, the Notion row shows the connected workspace. New completed archives can sync automatically when Auto-sync is enabled.
Disconnect Notion
Tap the connected Notion row in Settings -> Integrations, then confirm disconnect. Syncing to that workspace stops, but existing Notion pages are not deleted.
Reader
The Reader integration saves completed archives to Readwise Reader. It is useful when you want Social Archiver captures to enter the same reading queue as articles, newsletters, and saved web pages.
What It Sends
- Original URL and archive title
- Author, summary, content or HTML, image URL, and notes when available
- Tags, including your default tags and optional platform tag
- Reader category based on the source, such as article, social post, or video
Connect Reader
- Open readwise.io/access_token and copy your access token.
- Open the Social Archiver mobile app.
- Go to Settings -> Integrations.
- Tap Connect on the Reader row.
- Paste the token and connect.
Reader Settings
Tap the connected Reader row to configure:
- Auto-save: save to Reader when archives complete
- Save Location: send items to Later or New
- Default Tags: tags added to Reader saves
- Include platform tag: add tags such as the source platform name
- Platforms: choose which mobile archive sources are allowed to save to Reader
You can also use Save to Readwise from an archive action menu when the archive has an original URL and the platform is allowed.
Disconnecting Reader removes the saved token from the mobile app. Existing Reader items are not deleted.
Karakeep
The Karakeep integration saves completed archives as bookmarks in a Karakeep server. It is useful if you run a self-hosted read-it-later or bookmark workflow.
What It Sends
- Original URL and archive title
- Summary or note content when available
- Default tags and optional platform tag
- Archive metadata that can be represented in a Karakeep bookmark
Connect Karakeep
- In Karakeep, create an API key from Settings -> API Keys.
- Open the Social Archiver mobile app.
- Go to Settings -> Integrations.
- Tap Connect on the Karakeep row.
- Enter your Karakeep server address, such as
https://bookmarks.example.com. - Paste the API key and connect.
The mobile app accepts a base server URL and normalizes it for the Karakeep API. You do not need to add /api/v1.
Karakeep Settings
Tap the connected Karakeep row to configure:
- Auto-save: save to Karakeep when archives complete
- Default Tags: tags added to Karakeep bookmarks
- Include platform tag: add tags such as the source platform name
- Platforms: choose which mobile archive sources are allowed to save to Karakeep
You can also use Save to Karakeep from an archive action menu when the archive has an original URL and the platform is allowed.
Disconnecting Karakeep removes the saved credentials from the mobile app. Existing Karakeep bookmarks are not deleted.
Auto-save and Manual Save
Automatic exports run after an archive completes. Manual save actions are available from archive action menus for Immich, Raindrop, Reader, and Karakeep when the item has the data required by that integration.
For URL-based services such as Raindrop, Reader, and Karakeep:
- The integration is connected and enabled
- The archive has an original URL
- The archive platform is not excluded in that integration's settings
- The mobile device is online
Immich requires downloadable media and a reachable server. Raindrop, Reader, and Karakeep can report that an item already exists. In that case, the mobile app shows an already-saved message instead of creating a duplicate.
Troubleshooting
| Problem | What to check |
|---|---|
| Integration row is missing | Update the mobile app. Reader and Karakeep may only appear in supported builds or rollout groups. |
| Immich rejects the connection | Check the full server URL and create a fresh API key under Immich Account Settings → API Keys. Confirm the phone can reach the server. |
| Immich works on mobile but not for subscriptions | The connection is mobile-only. Use an Immich public HTTPS URL reachable by Social Archiver servers, then retry server sync. |
| Immich upload contains no assets | Confirm the archive has photos or video and that the source media URLs have not expired. |
| Raindrop connection expired | Reconnect Raindrop through OAuth under Settings → Integrations → Raindrop. |
| Raindrop imports exported links again | Enable Exclude exported items in the Raindrop settings. |
| Notion connect fails | Confirm the browser authorization completed and that Social Archiver has access to at least one Notion page where a database can be created. |
| Reader token fails | Generate a fresh token from readwise.io/access_token, then paste it again. |
| Karakeep connect fails | Check the server URL, API key, HTTPS access, and whether the Karakeep server is reachable from your phone. |
| Notion sync did not run | Confirm Auto-sync is enabled and the Notion connection is active. |
| Reader or Karakeep auto-save did not run | Confirm that integration's Auto-save setting is enabled, the platform is allowed, the archive has an original URL, and the phone is online. |
| Sync waits too long | Check whether WiFi-only sync is enabled and whether the phone is currently on WiFi. |