Simkl Import

Simkl Import

Import your whole Simkl library - movies, TV shows and anime - in one run. Sign-in is a short code, so there is no password and no API token to paste.

What gets imported

Simkl data	Tonkatsu Box
Movies	Movies (animated films land as Anime)
TV shows	TV Shows (animated series land as Anime)
Anime section	Anime items from the anime catalog, with the episode tracker
watching	Status "In Progress"
plantowatch	Status "Planned"
completed	Status "Completed"
dropped	Status "Dropped"
hold	Status "Planned" plus the on-hold tag
Rating (1-10)	Your rating, same scale
Notes (memos)	The item's personal note, under a link back to the Simkl page
Watched episodes	Individual episode marks, each keeping its Simkl watch date
Watch dates	Added / started / completed dates on the item

How to import

1. Go to Settings → Import → Simkl Import
2. Tap Get code. The app shows a five-character code and a link to simkl.com/pin. A copy button next to the code puts it on the clipboard, so it does not have to be retyped by hand
3. Open the link (right in the browser on desktop, on the phone or from another device), type the code and allow access
4. The screen keeps checking on its own. As soon as you confirm, it shows Connected account: your-name
5. Pick the import mode:
   • Add new only - items already in the collection stay untouched
   • Overwrite existing - status, rating and note are refreshed on items you already have
6. Pick the target collection - a new one (named after your Simkl account) or an existing one
7. Tap Start Import

The code

The code lives 15 minutes. If it runs out before you confirm, the screen says so and offers Get a new code.

Stay connected on this device keeps the access token in the app settings, so the next import starts straight away without a code. Leave it off and the token lives only until you close the screen - the next import asks for a new code. When a token is stored, Disconnect next to the account name erases it.

If the stored token stops working (revoked on Simkl), the screen drops it and asks for a code again.

Where each section goes

• Movies and TV shows are filled in from TMDB by the id Simkl already carries, so no title guessing happens. Films and series with the Animation genre become Anime items.
• The anime section is matched by id against the anime catalog: first by the catalog id Simkl sends, then through its MyAnimeList and AniDB ids. Anime films from that section are imported as anime too.

Watched episodes

Episode marks arrive one by one with the date you watched them on Simkl, not the import date. Existing marks keep their own dates.

A title marked completed on Simkl arrives without the per-episode detail, so the importer fills in every episode from the source data and dates them by the last watch date. Specials (season 0) are left out.

Anime episodes are numbered straight through on Simkl (Bleach: 1-366) and land in the right season of the tracker automatically.

Restoring the watch history is the longest part of the run, so the progress panel names the title it is working on.

Import progress

During the run you'll see the current stage - fetching the library, fetching details, adding entries, restoring watch history - a progress bar, and the running counts of imported and updated items. The usual result screen closes the run.

What if items are not found?

Anything the importer cannot match - no id on the Simkl side, a failed lookup, a stale mapping - goes to your Wishlist as text with its media type, tagged with this import. The item's Simkl note travels with it. Nothing is dropped silently, and the counts on the result screen show it.

Requirements

• A TMDB API key (or the built-in one) - for movie and show details
• Nothing for anime - the anime catalog needs no key

💡 Builds from F-Droid or built from source have no app key baked in and show a Simkl app key (client_id) field on the import screen. Create one at simkl.com/settings/developer and paste it once - "Remember the app key" is on by default. Official releases never show this field.

Tips

• Re-running the import is a normal thing to do: pick Overwrite existing and statuses, ratings and notes catch up with Simkl. A status is never downgraded, and the earliest start date and latest completion date win.
• One account covers what used to take three imports (films and shows from Trakt, anime from MyAnimeList or AniList).
• Held titles are easy to separate from ordinary plans later - filter the collection by the on-hold tag.