How to use FbZip2Blue

Take control of your online presence. Use the browser app at /webv/ to recover Meta (Facebook, Instagram, Threads) or X archive posts and messages, review them on Post Review, and (with a paid licence) publish to Bluesky — how you want, where you want, when you want.

Migration guides (2026)

What you need

  • Account — Sign in with the identity provider configured for this site (for example Auth0). You must be signed in to upload and convert archives.
  • Archive export ZIP — A ZIP from one supported platform export flow (Facebook, Instagram, Threads, or X/Twitter). Very large exports are supported because uploads are sent in chunks.
  • Bluesky (optional) — Only if you will publish: your handle (for example you.bsky.social) and either Sign in with Bluesky (OAuth, when enabled) or an App Password from Bluesky (Settings → App passwords). Prefer a dedicated app password, not your main login password.

Supported platforms and export guides

Main areas of the app

After opening /webv/, use the left sidebar:

  • Start
    • Import + Convert (home) — Upload your export ZIP once, then Convert posts and/or Build chat archive ZIP from that same session.
    • My packages — Open a downloaded .fbzpkg or pick a file; resume review without re-uploading the Facebook ZIP.
  • Review
    • Post Review — Full-screen post editor: paging, sorting, bulk edits, Bluesky controls, and per-post save/publish.
  • Download Tools
    • Chat Archive — Desktop apps, licence status, and web extract for a conversion already loaded on Import + Convert (optional ?session= link).
    • Posts Archive — Browse-only timeline for a sealed package (search, hashtags, media). Use Download for desktop, then the free desktop app (Windows or Linux).
  • Account
    • Licenses — Plan, Bluesky tier, linked account slots, and publish destinations.
    • Feedback — Signed-in survey: what works, what to improve.

Language chips (EN / FR / ES / PT) and sign-in live in the top bar, not the sidebar.

End-to-end workflow

1. Load and convert your export

On Import + Convert, choose one or more ZIP archives and click Upload export. When files are on the server, choose what you need: Convert posts, Build chat archive ZIP, or both — no second upload.

2. Conversion details (optional)

Under Advanced options, set a conversion name, status, and notes; click Save conversion details (paid plans).

3. Review and edit posts

When post conversion completes, open Post Review (sidebar → Review).

  • Choose a conversion — From Recent conversions on Post Review (still on the server while you work), or open a .fbzpkg from My packages to resume later.
  • Paging — Set page size (within allowed limits), use First/Previous/Next/Last, or jump to a post number. Turn on Included only to hide posts excluded from publishing.
  • Per post — Edit text, set group selector (a label you can use for organization or filtering), toggle Include in upload, adjust hashtags via the picklist and/or quick-add field, then Save to persist changes (when your plan allows saving).
  • Bluesky preview — Approximate appearance, a character counter, and hints for long posts (hosted article, thread, or shorten). Open Preview for a larger modal with media and navigation.
  • Public article — Optional per-row checkbox when your site requires it for hosted pages; otherwise long posts can use articles without extra marking.
  • Sort — Click column headers where supported to sort by index, time, include flag, group, text, media counts, or posted status.

4. Download .fbzpkg (required to keep your work)

On Post Review (or on Import + Convert after convert), use Download .fbzpkg after saving your edits. The file is encrypted for this browser profile only (device-held keys) — it will not open in another browser or on another computer. Re-open from My packages in the same profile. Server-side data is temporary — removed after download or within 72 hours. See the .fbzpkg guide.

5. Publishing and bulk actions

On Post Review, use row checkboxes or Select all on page. Then you can:

  • Apply bulk hashtags (add and/or remove) to all selected posts.
  • Bulk text edit — Find & replace, add to start, add to end, or remove text across selected posts (optional case-sensitive find).
  • Include or Exclude selected posts from the publishing set.
  • Set a group selector for many posts at once (optionally only when empty).
  • With publishing enabled: Bulk publish to Bluesky up to a capped number of selected posts per run, respecting credentials and dry-run settings.

Account page

Open Licenses under Account in the sidebar (or the top-bar Account menu) to see your plan, Bluesky tier, linked account slots used, and publish destinations. Agency tiers can link multiple Bluesky handles from the publish panel on Post Review.

Publishing to Bluesky (paid licence)

If your account has publishing enabled, the Post Review page shows a Bluesky card. Always test with Dry run first: no live post is created, but the app validates the flow and logs what would happen.

  • Sign in with Bluesky — When OAuth is enabled, click Sign in with Bluesky to authorize publish without typing an app password. A session badge shows your linked handle until you sign out or revoke the session. App password remains a fallback.
  • Handle + App password — Enter your Bluesky handle and app password. These are sent to the server only for the publish request; use a dedicated app password and revoke it later if needed.
  • Who can reply — After a real post is created, the app can set Bluesky’s reply audience (everyone, followers only, following only, mentioned users only, or nobody) using Bluesky’s thread gate rules.
  • Force republish — When Dry run is off, live publishes are normally skipped for rows already marked posted; check Force republish only if you intentionally want to attempt posting again (use with care).
  • Lists — Load lists fetches your Bluesky lists; you can assign a chosen list to selected posts (optional “only when group selector empty”). This helps downstream organization on Bluesky where supported.
  • Long post publish mode — For text over ~300 characters: Auto, Short post only, Article + link, or Thread split (see section below).
  • Single post — Publish on a row (or from the preview modal when available) publishes that post if it is included and credentials are valid.
  • Publish log — Scroll the log for success, skip, and error lines; use Clear log when you want a fresh view. Long-post article publishes include an Article: URL line.

Posts marked Posted show a badge once a live publish succeeded for that row.

Post dates

The original date from the export is saved in the .fbzpkg and shown in the Timestamp column on Post Review. Publishing sends that same date to Bluesky as the post date. Bluesky may still order the profile by when it received the post. If the export has no date, the app uses the time the archive was parsed. Check Timestamp and leave those unpublished if that matters. Open the export again if an older package still shows the time it was parsed. Post Review has no separate date-repair tool. To show the date in the wording, edit Text on the row, or Post text in Preview, before you publish.

Long posts and publish modes (paid)

Bluesky feed posts are limited to about 300 characters. For longer imported text, use Long post publish mode on the Bluesky card:

  • Auto — Hosted article + Bluesky link card when allowed; otherwise a Bluesky thread split.
  • Short post only — Publish is blocked until you shorten the text.
  • Article + link — Always uses a hosted article page plus teaser on Bluesky (paid; requires article publishing on your account).
  • Thread split — Splits text into a reply chain on Bluesky; images on the first part only; no hosted article page.

Use Dry run first to confirm article URLs or thread behavior before going live.

Where your data lives (2026)

While you work: export ZIPs and parsed posts are staged on FbZip2Blue’s backend so you can review in the browser. After download: an encrypted .fbzpkg on your device holds your conversion; server copies may be purged. Chat archives follow the same pattern — download the ZIP promptly; server copies are short-lived. Entitlements and device public keys stay on the server; we do not keep long-term plaintext post libraries when ephemeral mode is enabled.

Posts Archive workflow (offline posts)

After you have a sealed .fbzpkg (or an active conversion), open Download Tools → Posts Archive in /webv/:

  • Browse the timeline privately in the browser (search, sort, media).
  • Download for desktop — creates a portable posts archive ZIP (not a sealed .fbzpkg).
  • Install the free desktop app (Windows or Linux): downloads page → File → Open posts archive ZIP….
  • Languages: EN / FR / ES / PT. Export ZIP/HTML includes images; Copy pastes text + images; Email downloads a ZIP to attach in your mail app.

Publishing to Bluesky still happens on Post Review in the browser. Sealed .fbzpkg files do not open in the desktop app.

Chat Archive workflow (Messenger / WhatsApp)

Use the same Import + Convert upload as posts — there is no separate Chat Archive upload:

  1. Download desktop app (free) — choose Windows or Linux on the downloads page (also under Download Tools → Chat Archive; macOS is not available yet).
  2. On Import + Convert, Upload export your Facebook or WhatsApp ZIP (same session as posts if your Meta download includes Messages).
  3. On that page, click Build chat archive ZIP — free accounts get a preview; licensed accounts get the full archive.
  4. When status shows Ready, click Download ZIP and open it in the free desktop app or bundled viewer.

Server copies of chat extract files are short-lived (download promptly). The offline viewer never requires a paid licence. Details: chat archive guide.

Invite your Messenger group to Bluesky

After opening an archive in the offline viewer, open a conversation and click Invite to Bluesky. Your browser opens /webv/ to map archive names to Bluesky handles and send invite DMs and/or create a Bluesky group. Requires a paid Bluesky licence (Standard, Agency, or Complete). Private chat history is not republished. Walkthrough: invite guide.

My packages (this device)

Use My packages under Start to open a .fbzpkg you downloaded earlier, or choose a package file from disk — always in the same browser profile that sealed it. That is how you resume review and publish later — there is no separate online “My conversions” list. Packages are not portable between browsers or machines.

Privacy and data

Your ZIP and parsed content are staged temporarily on the platform while you convert and review. Download .fbzpkg to keep an encrypted copy on your device. Do not upload archives you are not allowed to process. Use strong, unique app passwords for Bluesky.

Hosted article pages for long posts are reachable by URL (with an unguessable token). Use the per-row Public article checkbox when your operator requires explicit consent for public pages.

Self-help

Start with the expandable FAQ (Q&A by topic). Step-by-step workflows live in this guide and under /guides/. Free users: FAQ, documentation, and email. Paid licence holders: in-app support chat at /webv/.

Troubleshooting

  • 403 — Authentication or permission issue: sign out and sign in again; ensure your account is allowed to use the API.
  • 413 — Request too large: reverse proxy or host upload limit may be smaller than your file; the server or proxy limit may need to be raised for multi-GB ZIPs.
  • Failed to fetch — Browser could not reach the API (network, CORS, or offline). Retry; check VPN or firewall.
  • Logout error — Logout or callback URL mismatch in identity configuration; contact the site operator.
  • Conversion stuck or failed — Refresh conversion status status; re-queue after fixing the ZIP; check that the export is a supported Meta or X archive format. If a job is already running, wait for it to finish before queueing again.
  • Long post / 300 characters — Change Long post publish mode, use Thread split or Article + link, or shorten text; try Dry run and read the log.
  • Bluesky publish errors — Verify handle/password, caps and 2FA (use app password), post length and media limits on Bluesky; read the publish log line for the specific error.
  • Actions disabled — Often due to free plan restrictions or missing “Include in upload” / credentials / conversion save rights; read the yellow or gray notices on the page.

Quick checklist

  1. Open /webv/ and sign in.
  2. Import + Convert → choose ZIP → Upload export.
  3. Click Convert posts and/or Build chat archive ZIP as needed.
  4. Open Post Review, select your upload, review paging and filters.
  5. Edit text, hashtags, group, include flag; save rows (if your plan allows).
  6. Test Bluesky with Dry run, then publish (single or bulk) with reply audience as needed.
  7. Download a .fbzpkg, then use My packages to resume later. Use Download Tools for Chat / Posts Archive downloads.
  8. Share product feedback at /webv/feedback (signed in).

Open Web App Desktop downloads FAQ Feedback (beta)