BirdSafeFor BirdSafe 1.2.4 and later
Turn scattered saves into a library built to last
Start here
BirdSafe is a local-first browser extension. Post content, authors, media indexes, and your organization data are written to your browser database first. You do not need to hand a complete archive to a third-party server before you can use the product.
Install and first backup
Install BirdSafe and sync bookmarks and likes for the first time.
Browse, search, and organize
Use gallery, table, and masonry views with search, folders, and tags.
Backup, export, and restore
Understand JSON, CSV, and Excel and build a recoverable backup routine.
Connect your tools
Send selected saves to Notion or query your library through MCP.
01
Install and make your first backup
- 1
Install the extension
Install BirdSafe in Chrome or Edge and pin it to the toolbar. A paid subscription is not required to begin.
- 2
Sign in to Twitter/X
Sign in to Twitter/X in the same browser window, then open BirdSafe. It uses your current session to read saves you are allowed to access.
- 3
Start syncing
Choose bookmarks, likes, or both. Keep the browser open for a large first import; an interrupted job can continue from its checkpoint.
- 4
Review the result
Check totals, failed items, and media cache status. Failed work can be retried without blocking completed items.
If Twitter/X asks you to sign in again or shows an access check, complete it in the regular website first. Return to BirdSafe afterward and avoid repeated rapid retries.
Browse, search, and organize
The same local data can be presented differently for different tasks. Switching views does not duplicate or alter the original post.
Gallery
A media-first grid for scanning images, videos, and visual inspiration.
Table
A structured view of authors, summaries, dates, and engagement for precise filtering.
Masonry
A reading-oriented layout that preserves more of each post's original rhythm.
- Search post text and authors
- Build your own system with folders and tags
- Sort by time, author, or engagement
- Select items in bulk to organize, export, or delete
Backup, export, and restore
- 1
Export JSON regularly
Store JSON backups on a disk or encrypted cloud location you control. Export again after important organization work.
- 2
Verify the snapshot
Check the filename, export time, and item count so an empty or old library is not mistaken for the latest backup.
- 3
Restore when needed
Choose the JSON file in Data Management. Back up the current library first, then verify totals, folders, and settings after import.
| Format | Best for | Full restore |
|---|---|---|
| JSON | Migration, disaster recovery, device transfer | Yes. Includes saves, folders, and portable settings |
| CSV | Analysis and lightweight table access | No. View and analysis only |
| Excel | Manual filtering, review, and sharing | No. View and analysis only |
Cloud media mirroring is opt-in and off by default. When it is off, media follows the local cache policy. Review the privacy and pricing rules of your cloud storage before enabling it.
Notion sync
Notion sync is designed for sending selected saves into a writing or research workflow. BirdSafe requests only the permissions needed for the connection you authorize.
- 1
Connect Notion
Open Settings, choose Notion, finish authorization, and select the pages or databases BirdSafe may access.
- 2
Choose a destination
Map the destination fields. Test with a few saves before sending a larger collection.
- 3
Choose a sync workflow
Sync on demand or use the available incremental workflow. Revoking authorization prevents future writes.
Pages already created in Notion are controlled by your Notion workspace. Disconnecting BirdSafe does not automatically delete them.
Account and billing
Core features remain available without purchasing a subscription. Pro unlocks advanced capabilities; checkout and subscription management require a BirdSafe account.
- The website never embeds or exposes a payment API key
- The BirdSafe backend creates a secure checkout session before redirecting to Dodo Payments
- Subscription state is read from BirdSafe's server-side ledger
- After cancellation, access generally continues until the end of the current paid period, as shown during checkout
Troubleshooting
| Symptom | Check first | Recommended action |
|---|---|---|
| Sync count stops | Twitter/X sign-in, network, access checks | Confirm the account works on the regular website, then continue from the checkpoint |
| Media is missing | Cache status and source availability | Retry failed media; deleted source media may no longer be recoverable |
| New saves are not searchable | Job completion and index status | Wait for indexing, then search again |
| Notion write fails | Authorization scope and database access | Reconnect and test with one save |
| Subscription is stale | Signed-in account, payment result, network | Refresh the subscription page, then contact support if needed |
When contacting support, include your BirdSafe and browser versions, the approximate time, and a redacted error. Never send a Twitter/X password, full card details, or a complete access token.