How to use FbZip2Blue

This guide describes the browser web app at /webv/: importing Meta (Facebook, Instagram, Threads) or X (Twitter) archive ZIPs, reviewing parsed posts, and (with a subscription) publishing to Bluesky.

Migration guides (2026)

Pricing (CAD, one-time)

Free — Explore parsing: limited included posts; chat preview (1 conversation, 500 messages) + free viewer app
Bluesky Standard (~$5) — Full save, edit, publish, and group invites for 1 Bluesky account
Chat Archive Standard (~$69) — Full Messenger / WhatsApp archive ZIP download (no Bluesky invites)
FbZip Complete (~$89) — Full chat archive + Agency posts + group invites (up to 10 Bluesky accounts)
Bluesky Agency (~$30) — Multi-account posts + invites → Bluesky (no chat archive)

Purchase links appear in /webv/ after sign-in. Use the same email at checkout and sign-in so your license activates automatically.

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 converts and upload data.
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

Facebook — Export guide: Download your Facebook information
Instagram — Export guide: Access and download your Instagram information
Threads — Export guide: Download your Threads information
X (Twitter) — Export guide: How to download your X archive
Destination publishing — Bluesky is live today. Gander appears as coming soon in the app; native publish to Gander will ship when their ATProto OAuth is ready.

Main areas of the app

After opening /webv/, use the left navigation:

Import & review (home) — Load export ZIP(s), click Upload and convert, then review a preview table when conversion finishes.
Parsed posts — Full-screen review: paging, sorting, bulk edits, Bluesky controls, and per-post save/publish.
My packages (this device) — Open a downloaded .fbzpkg or pick a file; resumes review without re-uploading the Facebook ZIP.
Account — Plan, Bluesky tier, linked account slots, and publish destinations. Manage linked handles on Parsed posts.
Feedback (beta) — Signed-in survey: what works, what to improve. Product evolves quickly; we read every submission.
Language — Switch UI language (for example EN / FR / ES / PT) from the sidebar when available.

End-to-end workflow

1. Load and convert your export

On Import & review, choose one or more ZIP archives and click Upload and convert. The app creates a conversion automatically, uploads your files, and starts conversion in the background.

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 conversion completes, open Parsed posts.

Choose a conversion — From Recent conversions on Parsed posts (still on the server while you work), or open a .fbzpkg from My packages (this device) 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 Parsed posts, 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 (this device) 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 Parsed posts, 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.

From home (section 4), you can also apply a group selector across the current upload’s loaded page with similar “only empty” behavior.

Account page

Open Account in the sidebar 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 Parsed posts.

Publishing to Bluesky (subscribers)

If your account has publishing enabled, the Parsed posts 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.

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.

Free plan vs paid

The app may show an entitlement banner. Typically, the free plan lets you explore parsing and mark a limited number of posts as included, while saving conversion metadata, saving edits, bulk tools, and publishing require a Bluesky license. Full chat archive download requires Chat Archive Standard or FbZip Complete. Exact limits are shown in the product UI.

Chat Archive workflow (Messenger / WhatsApp)

On Import & review (/webv/), use the Chat Archive access card at the top of the page:

Download desktop app (free) — Windows: FbZipChatArchive-win-x64.zip (macOS / Linux builds coming soon).
Upload and convert your Facebook or WhatsApp export ZIP on Import & review (same conversion as posts, or chat-only).
Click Build chat archive ZIP — free accounts get a preview; licensed accounts get the full archive.
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 subscription. 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 (this device) 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 subscribers: 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

Open /webv/ and sign in.
Choose Facebook ZIP → Upload and convert → wait until conversion completes.
Open Parsed posts, select your upload, review paging and filters.
Edit text, hashtags, group, include flag; save rows (if your plan allows).
Test Bluesky with Dry run, then publish (single or bulk) with reply audience as needed.
Download a .fbzpkg, then use My packages (this device) to resume later.
Share product feedback at /webv/feedback (signed in).

Open Web App FAQ Feedback (beta)