Support

For version 1.6. Questions go to GitHub issues.

Most failed exports come down to one of a handful of causes, and the fixes below take a minute. If none of them helps, the last section shows what to send so the problem can be tracked down.

Start here

• Sign in to X and open x.com/i/bookmarks, or x.com/i/history if that is where your bookmark tags live.
• Keep that tab in front while the export runs. The extension scrolls the page to load your bookmarks, and a background tab may stop loading new ones.
• Reload the page and run the export once more. A page that has been open for a long time is the most common cause of an empty result.

Common problems

"Please navigate to x.com/i/bookmarks"

The extension runs on https://x.com/i/bookmarks and https://x.com/i/history only. Addresses on twitter.com, and any other page on X, are not supported. Open the bookmarks page itself and click the icon again.

The export is empty, or misses posts you expected

The date range filters on the date the post was written, not the day you bookmarked it. A post from 2023 that you bookmarked yesterday falls outside a range covering this week. Clear both date fields to export everything, then narrow down from there.

It stops before reaching the end

The extension scrolls the timeline itself and waits for X to deliver the next batch of posts. If the tab goes to the background, or the connection stalls, X stops sending posts and the export finishes early. Bring the tab to the front and run it again — re-exporting simply rebuilds the same files.

Nothing is exported at all

X changes the markup of its timeline regularly, and a change there can stop the reader script from recognising posts. Reload and retry first. If the result is still empty, that is a bug in the extension rather than a mistake on your side, so please report it.

Images and videos are not in the ZIP

Media is recorded as links to the originals on X, not downloaded. Images appear as Markdown image links under a ## Media heading, and videos link back to the post. The files stay small, but the media stays on X.

The filenames look cut off

Each file is named after the first 50 characters of the post plus its post ID, and characters that Windows and macOS forbid in filenames are replaced with underscores. The full text is inside the file; only the name is shortened.

The browser asks where to save every time

That prompt is deliberate: the extension hands the ZIP to your browser and lets you choose the destination, rather than writing anywhere on its own.

Report a problem

Open an issue on GitHub. Copying this outline into the issue gives enough to reproduce it:

Extension version: 1.6
Browser and OS:     e.g. Chrome on Windows 11
Page used:          x.com/i/bookmarks or x.com/i/history
Date range:         From and To, or left empty
What happened:      what you expected, and what you got
Console errors:     DevTools, Console tab, anything in red

Please do not paste the contents of your bookmarks. Nothing about the posts themselves is needed to fix an export bug, and issues on GitHub are public.

What to expect

This is a free, MIT-licensed project maintained in spare time, so replies come when time allows. GitHub issues are the only support channel — there is no support address — which keeps every answer public, so the next person with the same problem can find it.

Feature requests and pull requests are welcome in the same place. The whole extension is a few hundred lines of JavaScript, so it is a small codebase to change.

New releases are announced on X, at @___nix___. Bugs still belong in an issue rather than a reply there, so they do not get lost.