Skip to main content

Library Management

Why isn't my media showing up?​

Check:

  1. Root folder path is correct (use container path in Docker)
  2. Cinephage has read permissions
  3. Files are in supported format (.mkv, .mp4, .avi, etc.)
  4. Run Library Scan: Library → Movies/TV → Scan Library

How do I add my existing library?​

  1. Go to Library → Movies or Library → TV
  2. Click Import
  3. Select folder containing your media
  4. Review and confirm matches
  5. Cinephage will organize and add to library

See Import Existing Files for details.

Can I have multiple root folders?​

Yes! You can create multiple root folders:

/media/movies      (Movies root)
/media/tv          (TV Shows root)
/media/anime       (Anime root)
/media/kids        (Kids content root)

Each must be dedicated to one media type (don't mix movies and TV).

What's the difference between Monitored and Unmonitored?​

  • Monitored: Cinephage actively searches for this content
  • Unmonitored: Item is in library but won't be auto-searched

Use cases:

  • Monitored: Content you want to download/upgrade
  • Unmonitored: Content you already have, don't need more

How do I organize my files?​

Cinephage can organize files automatically:

  1. Configure naming patterns in Settings → Media Management → Naming
  2. Use tokens like {Movie Title}, {Release Year}, {Quality}
  3. Cinephage applies patterns during import
  4. Use "Organize" feature to rename existing files

See Organize Files for patterns and examples.

Why are my movies/shows matched incorrectly?​

Common causes:

  1. No year in filename - Add release year
  2. Ambiguous title - Similar movies with same name
  3. Foreign title - Different names in different regions

Solutions:

  1. Rename files with year: Movie Title (2024).mkv
  2. Use TMDB ID: Movie Title {tmdb-12345}.mkv
  3. Manually correct match during import

Quick Command Reference​

Scan library:

# Trigger via web UI: Library → Movies/TV → Scan Library

Check file permissions:

ls -la /path/to/media
docker compose exec cinephage ls -la /path/to/media

View library stats:

# In Cinephage web UI: Library → Movies/TV shows count

See Also​