Simon/Yamtrack
1
0
Fork 0
mirror of https://github.com/FuzzyGrim/Yamtrack.git synced 2026-06-27 22:35:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

document yamtrack csv tv row ordering #1419

Browse Source
This commit is contained in:
FuzzyGrim
2026-05-24 14:08:32 +02:00
parent f8763f5318
commit c23f0e6c73
1 changed files with 3 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/media-imports.md
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. 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 | | 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`. | | 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`. | | 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`. | | 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`. | | 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`. | | season_number | Cond. | 2 | Required when `media_type = season`; also required (together with `episode_number`) when `media_type = episode`. |