= Jellyfin =

'''Jellyfin''' is a media server, forked from [[Emby]].

<<TableOfContents>>

----



== Installation and Setup ==

Most [[Linux]] distributions offer a `jellyfin` package.



=== Containers ===

A [[Docker]] container image is available for most releases. These are available from [[Docker/Hub|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 \
  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