Libraries

Libraries tell Odeion where your media files are on disk and what type of content they contain. Each library has a name, a type, and one or more filesystem paths.

Library Types

Type	Description
Movies	Standalone films. Each file or folder is a separate movie.
Series	TV shows organized in a show/season/episode folder hierarchy.
Anime	Anime series. Uses AniList for metadata in addition to TMDB, and supports absolute episode numbering.

Directory Structure

Odeion uses filename parsing to identify content, so following a consistent folder structure helps it match files correctly.

Movies

Each movie should be in its own folder named with the title and year. The video file inside can be named anything.

/media/movies/
  The Matrix (1999)/
    The Matrix.mkv
  Inception (2010)/
    Inception.mp4

Loose files in the root of the library path (not in a subfolder) will also be picked up, but using folders is preferred because it keeps related files (subtitles, artwork) grouped together.

Series

TV shows use a three-level hierarchy: show name, season folder, episode files. Episode files should include season and episode numbers in standard S01E01 format.

/media/tv/
  Breaking Bad/
    Season 1/
      S01E01.mkv
      S01E02.mkv
    Season 2/
      S02E01.mkv

Anime

Anime libraries follow the same structure as series but also support absolute episode numbering (e.g., episode 150 across all seasons rather than season-relative numbering).

Adding a Library

In the admin panel, go to Libraries and click Add Library. Select the type, give it a name, and specify one or more paths where the media files are located. If you run Odeion in Docker, these paths refer to the container filesystem, so make sure your volume mounts match (for example, /media/movies inside the container mapped to /path/to/movies on the host).

Scanning

When a library is first created, Odeion immediately scans the configured paths for media files. After the initial scan, libraries are rescanned automatically on a configurable interval (set per library). You can also trigger a manual scan from the library’s admin page at any time.

During a scan, Odeion walks the filesystem, discovers new or changed files, removes records for deleted files, and enqueues background processing tasks for anything new. See Processing for details on what happens after files are discovered.

Managing Libraries

From the admin panel you can edit a library’s name, paths, and scan interval, or delete a library entirely. Deleting a library removes all associated metadata and watch history from the database but does not touch the files on disk.