DocsChangelogPrivacyTermsSecurity

How to install BirdSafe?

This guide helps you finish installation, authentication, and first sync in 5 minutes.

Before you start

Please verify your browser and account status before setup to reduce first-sync failures.

  • Use Chrome or Chromium-based browsers, preferably one of the latest 3 stable versions.
  • Make sure Twitter/X is accessible and your account is logged in.
  • Keep your browser and network stable during first sync; do not close the browser midway.
01

Step 1: Install extension

Install BirdSafe from the Chrome Web Store. Use the official listing so your extension version matches the latest sync protocol.

Open Chrome Web Store
BirdSafe installation page screenshot
02

Step 2: Account authentication

After installation, click the BirdSafe icon in the browser toolbar and complete sign-in. BirdSafe initializes local database and permissions after successful authentication.

03

Step 3: First sync

Once signed in, BirdSafe performs a handshake and starts the sync engine. After status becomes ready, you can run incremental or full sync for bookmarks and likes.

Usage guide

Incremental vs full sync: use incremental sync daily to process only new/changed content. Run full scan when you need historical backfill.

Search and filtering: start with keywords, then narrow down by author and time range.

View mode: Gallery is better for visual browsing, while table view is better for sorting and batch operations.

Notion sync: this is for collaboration and online review. It is not a local restore channel.

Export & migration

Format guide: JSON works best for archival and development pipelines; CSV/Excel are best for analysis and collaboration.

Free plan migration: export/import between devices or re-crawl history on a new device.

Pro plan migration: sign in and cloud sync will write data back to local automatically.

Media scope: Pro supports local original-image/video mirror. Cloud sync currently includes text and original images.

Settings & personalization

  • Theme mode: supports dark mode for long reading sessions.
  • Sync strategy: choose incremental-first or periodic full backfill.
  • Media strategy: tune media mirroring by storage and network conditions.
  • Notion mapping: align fields with your database schema for consistent indexing.

FAQ & troubleshooting

  • Cannot see sync controls: refresh the extension page and verify you are signed in and permissions are granted.
  • Sync is slow: background scheduler controls pacing for safety; keep network stable and resume from checkpoint if interrupted.
  • How to restore data on a new device: Free uses import/export or re-crawl; Pro uses cloud sync restore.
  • Can Notion be used for full restore: no. Notion is for collaboration, not local recovery.
  • What if extension is uninstalled: local data may be removed; use regular exports or enable Pro cloud sync.