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
• History + Ratings, where the selected format supports a combined export

You choose:

• provider
• feature
• media types
• export format
• rows (select all or pick manually)

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

Media type filters

Exporter can filter by media type before writing the CSV.

Supported filters:

• Movies
• Shows
• Seasons
• Episodes

Movies stay enabled by default.

Use these filters to narrow the export to the item types you need.

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)

Format-specific notes

• History + Ratings can be exported together in one pass where the selected format supports it.
• Letterboxd supports an optional WatchedDate column. It is enabled by default.
• Yamtrack exports use Yamtrack’s native CSV layout.

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.

Preview

Exporter previews the file using your current selections.

That includes provider, feature, media types, format, and search filters.

Check the preview before you export when you switch formats or narrow rows.

How to use the UI

1. Open Tools → Exporter.
2. Select a Provider and Feature.
3. Choose the Media types you want to include.
4. Select an export Format.
5. Use Search to filter rows (example: imdb:tt1234567 or 2024).
6. Review the preview to confirm rows and columns.
7. Select rows (or Select all (filtered)).
8. Click Export to download the CSV.

Where to import the file

• TMDb: use TMDb’s import screen.
• Letterboxd: import on Letterboxd. WatchedDate is included by default when supported.
• 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.