Exporter

Export watchlist, history, and ratings from state.json to import-friendly CSV files.

Exporter converts your runtime state (state.json) into import-friendly CSV files. It does not write to providers.

Use it to move data into other services.

What it exports

Exporter reads these datasets:

• Watchlist

• History

• Ratings

You choose:

• provider

• feature

• export format

• rows (select all or pick manually)

TMDb import supports Watchlist and Ratings only. History export to TMDb is blocked on purpose.

Supported formats

• TMDb (auto dialect): chooses the CSV layout TMDb expects

  • Trakt source → Trakt v2 CSV

  • SIMKL source → SIMKL v1 CSV

  • Other sources → IMDb v3 CSV

• Letterboxd

• IMDb (list) (no official IMDb import, but useful for list workflows)

• JustWatch

• Yamtrack (superset for custom workflows)

What you need

• At least one sync run (so state.json exists).

• For TMDb exports: IMDb IDs are strongly recommended.

If state.json is missing, Exporter opens with an empty list.

How to use the UI

1. Open Tools → Exporter.

2. Select a Provider and Feature.

3. Select an export Format.

4. Use Search to filter rows (example: imdb:tt1234567 or 2024).

5. Select rows (or Select all (filtered)).

6. Click Export to download the CSV.

Where to import the file

• TMDb: use TMDb’s import screen.

• Letterboxd: import on Letterboxd (watchlist is movies-only by design).

• IMDb (list): no official import; use it for tooling or scripts.

Troubleshooting

• Empty list: run a sync first, or check provider/feature filters.

• Export button disabled: no rows selected.

• TMDb import failed: ensure rows have IMDb IDs and you chose the right format.