document yamtrack csv tv row ordering #1419

This commit is contained in:
FuzzyGrim
2026-05-24 14:08:32 +02:00
parent f8763f5318
commit c23f0e6c73

View File

@@ -86,11 +86,13 @@ Steam import requires a Steam API key and your Steam ID 64.
Use this format to bulk-import media into YamTrack. Every row represents a single media instance.
The order of rows matters for TV data: import `tv` rows first, then `season` rows, then `episode` rows. Episodes depend on their parent season, and seasons depend on their parent TV show.
| Column Title | Required? | Example Value | Notes |
| -------------- | --------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| media_id | No | 12345 | ID of the item on the chosen provider. Must be unique per `(source, media_type)`. Leave blank to let YamTrack fetch the title from the provider automatically with the `title`. |
| source | **Yes** | tmdb | One of: `tmdb`, `mal`, `mangaupdates`, `igdb`, `openlibrary`, `hardcover`, `comicvine`, `manual`. |
| media_type | **Yes** | movie | One of: `tv`, `season`, `episode`, `movie`, `anime`, `manga`, `game`, `book`, `comic`. |
| media_type | **Yes** | movie | One of: `tv`, `season`, `episode`, `movie`, `anime`, `manga`, `game`, `book`, `comic`. For TV data, rows must be ordered as `tv`, then `season`, then `episode`. |
| title | No | Inception | Leave blank to let YamTrack fetch the title from the provider automatically with the `media_id`. |
| image | No | <https://image.tmdb.org/t/p/w500/qmDpIH...jpg> | Public poster/cover URL. Leave blank to auto-fetch from the provider automatically with the `media_id` or `title`. |
| season_number | Cond. | 2 | Required when `media_type = season`; also required (together with `episode_number`) when `media_type = episode`. |