Jellyfin

Jellyfin is a media server, forked from Emby.

Installation and Setup

Most Linux distributions offer a jellyfin package.

Containers

A Docker container image is available for most releases. These are available from DockerHub as docker.io/jellyfin/jellyfin (or simply jellyfin/jellyfin when using docker(1) specifically).

Start the container with:

docker run --detach --name my-jellyfin \
  --user=$(id -u):$(id -g) \
  --net=host \
  --mount type=bind,/path/to/config:/config \
  --mount type=bind,/path/to/cache:/cache \
  --mount type=bind,source=/path/to/media,target=/media,readonly \
  --restart=unless-stopped \
  jellyfin/jellyfin

Configuration

Library Structure

Shows

TV Shows should be organized like:

• Shows
  • Series A (2001)
    • Season 01

      • Episode !S01E01.mkv

      • Episode !S01E02-E03.mkv

    • Season 02

      • Episode !S02E01.mkv

  • Series B (2002)

    • Episode !S01E01.mkv

    • Episode !S01E02-E03.mkv

    • Episode !S02E01.mkv

Series should be the top-level directory in all cases. Seasons can be parsed from either directory structure or filenames.

Movies

Movies should be organized like:

• Movies
  • Film A (2011).mp4
  • Film B (2012)
    • Film B.mp4
  • Film C (2013)
    • Film C (2013) - Version 1.mp4
    • Film C (2013) - Version 2.mp4

Film should the the top-level label, whether that is a directory or a singular file name.

Alternate versions of a film can be offered by storing them in a directory named as X and naming the versions as X - Y. A hyphen is the only recognized delimiter.

Subtitles

Subtitle files are searched for based on the video file's name. Language codes and keywords can be embedded as well.

• Movies
  • Film A (2020)
    • Film A.mkv
    • Film A.vtt
    • Film A.default.vtt
    • Film A.de.vtt
    • Film A.german.vtt

Image Metadata

Images can be interpreted as related metadata. They will be used hierarchically, so an image in a season's folder will apply to only that season, while an image in a series' folder will apply to all seasons except those that have a seasonal image.

Posters should be named as ^poster\..+$ or -poster\..+$. Alternate keywords are folder, cover, and default.

Backdrops should be named as ^backdrop\..+$ or -backdrop\..+$. Alternate keywords are fanart, art, and background. Specifically for fanart, additional images should be saved as ^extrafanart/fanart[0-9]+\..+$.

Banners should be named as ^banner\..+$ or -banner\..+$.

Thumnails should be named as ^thumb\..+$ or -thumb\..+$. An alternate keyword is landscape.

Logos should be named as ^logo\..+$ or -logo\..+$.

CategoryRicottone