Documentation

Library Layout

How to organize files so Mythos understands them.

Mythos infers as much as it can from filenames and folder structure. The conventions below are the same ones used by Plex, Jellyfin, and Emby — so an existing library should work out of the box.

Movies

/media/films/
├── The Princess Bride (1987)/
│   ├── The Princess Bride (1987).mkv
│   └── poster.jpg
├── My Neighbor Totoro (1988)/
│   └── My Neighbor Totoro (1988).mp4
└── Spirited Away (2001)/
    ├── Spirited Away (2001).mkv
    └── Spirited Away (2001).en.srt

Each film lives in its own folder, named Title (Year). External subtitles, posters, and trailers picked up automatically.

TV shows

/media/shows/
└── Bluey/
    ├── Season 01/
    │   ├── Bluey - S01E01 - Magic Xylophone.mkv
    │   └── Bluey - S01E02 - Hospital.mkv
    └── Season 02/
        └── Bluey - S02E01 - Dance Mode.mkv

Seasons are folders, episodes follow Title - SXXEYY - Episode Name.

Music

/media/music/
└── Nick Drake/
    └── Pink Moon (1972)/
        ├── 01 Pink Moon.flac
        ├── 02 Place To Be.flac
        └── cover.jpg

Mythos reads tags first and falls back to folder structure. Both work.

Sidecar files

FilePurpose
poster.jpg / cover.jpgLibrary art
fanart.jpg / backdrop.jpgBackground art
<basename>.srt, .ass, .vttExternal subtitles
<basename>.nfoLocal metadata override
.mythosignoreGlob list of paths to skip