Skip to content

Jellyfin - Libraries

Configuration options for jellyfin libraries.

Available Options

This page documents 42 configuration options.

nixflix.jellyfin.libraries

Jellyfin media libraries to manage declaratively.

By default, libraries are automatically created for enabled Arr services: - Shows: Created when Sonarr is enabled - Movies: Created when Radarr is enabled - Music: Created when Lidarr is enabled - Anime: Created when either Sonarr anime or Radarr anime is enabled

Default libraries can be removed with the following: - nixflix.jellyfin.libraries.Movies = lib.mkForce {};

Typeattribute set of (null or (submodule))
Default
{ }
Example
{
  "Family Photos" = {
    collectionType = "homevideos";
    enablePhotos = true;
    paths = [
      "/mnt/photos"
    ];
  };
  Movies = {
    collectionType = "movies";
    enableRealtimeMonitor = true;
    metadataCountryCode = "US";
    paths = [
      "/mnt/movies"
    ];
    preferredMetadataLanguage = "en";
  };
  Shows = {
    collectionType = "tvshows";
    paths = [
      "/mnt/tv"
    ];
    seasonZeroDisplayName = "Specials";
  };
}
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.allowEmbeddedSubtitles

Control which types of embedded subtitles to allow: - AllowAll: Allow all embedded subtitles - AllowText: Allow only text-based embedded subtitles - AllowImage: Allow only image-based embedded subtitles - AllowNone: Don't allow any embedded subtitles

Typeone of "AllowAll", "AllowText", "AllowImage", "AllowNone"
Default
"AllowAll"
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.automaticRefreshIntervalDays

Days between automatic metadata refreshes (0 to disable)

Typesigned integer
Default
0
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.automaticallyAddToCollection

Automatically add items to collections based on metadata

Typeboolean
Default
false
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.collectionType

The type of media library. - movies: Movie library - tvshows: TV Shows library - music: Music library - musicvideos: Music Videos library - homevideos: Home Videos (and Photos) library - boxsets: Box Sets library - books: Books library - mixed: Mixed Movies and TV Shows library

Typeone of "movies", "tvshows", "music", "musicvideos", "homevideos", "boxsets", "books", "mixed"
Example
"movies"
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.customTagDelimiters

Custom delimiters for parsing tags

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.delimiterWhitelist

Whitelist of delimiters to preserve

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.disabledLocalMetadataReaders

List of local metadata readers to disable

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.disabledLyricFetchers

List of lyric fetchers to disable

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.disabledMediaSegmentProviders

List of media segment providers to disable

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.disabledSubtitleFetchers

List of subtitle fetchers to disable

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enableAutomaticSeriesGrouping

Automatically group series together

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enableChapterImageExtraction

Extract chapter images from video files

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enableEmbeddedEpisodeInfos

Use embedded episode information from media files

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enableEmbeddedExtrasTitles

Use embedded titles for extras

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enableEmbeddedTitles

Use embedded titles from media files

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enableLUFSScan

Enable LUFS (Loudness Units Full Scale) audio normalization scanning

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enablePhotos

Enable photo support in this library

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enableRealtimeMonitor

Monitor the library folders for file changes in real-time

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enableTrickplayImageExtraction

Extract trickplay images (thumbnails for seeking)

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.enabled

Whether this library is enabled

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.extractChapterImagesDuringLibraryScan

Extract chapter images during library scan (vs on-demand)

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.extractTrickplayImagesDuringLibraryScan

Extract trickplay images during library scan (vs on-demand)

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.localMetadataReaderOrder

Order in which to use local metadata readers

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.lyricFetcherOrder

Order in which to use lyric fetchers

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.mediaSegmentProviderOrder

Order in which to use media segment providers

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.metadataCountryCode

Country code for metadata (e.g., 'US', 'GB', 'FR')

Typenull or string
Default
null
Example
"US"
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.metadataSavers

List of metadata savers to enable

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.paths

List of media folder paths for this library

Typelist of string
Default
[ ]
Example
[
  "/mnt/movies"
  "/media/films"
]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.preferNonstandardArtistsTag

Prefer non-standard artist tags in music files

Typeboolean
Default
false
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.preferredMetadataLanguage

Preferred language for metadata (e.g., 'en', 'fr', 'de')

Typenull or string
Default
null
Example
"en"
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.requirePerfectSubtitleMatch

Requiring a perfect match will filter subtitles to include only those that have been tested and verified with your exact video file. Unchecking this will increase the likelihood of subtitles being downloaded, but will increase the chances of mistimed or incorrect subtitle text.

Default is false because the requirements are pretty strict and make it difficult to actually find any subtitles at all.

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.saveLocalMetadata

Save metadata to .nfo files alongside media

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.saveLyricsWithMedia

Save downloaded lyrics alongside media files

Typeboolean
Default
false
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.saveSubtitlesWithMedia

Save downloaded subtitles alongside media files

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.saveTrickplayWithMedia

Save trickplay images alongside media files

Typeboolean
Default
false
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.seasonZeroDisplayName

Display name for season 0 (specials)

Typestring
Default
"Specials"
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.skipSubtitlesIfAudioTrackMatches

Uncheck this to ensure all videos have subtitles, regardless of audio language.

Typeboolean
Default
false
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.skipSubtitlesIfEmbeddedSubtitlesPresent

Keeping text versions of subtitles will result in more efficient delivery and decrease the likelihood of video transcoding.

Typeboolean
Default
true
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.subtitleDownloadLanguages

Languages to download subtitles for

Typelist of string
Default
[ ]
Example
[
  "eng"
  "fra"
]
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.subtitleFetcherOrder

Order in which to use subtitle fetchers

Typelist of string
Default
lib.optional config.nixflix.jellyfin.plugins."Open Subtitles".enable "Open Subtitles"
++ lib.optional config.nixflix.jellyfin.plugins."subbuzz".enable "subbuzz";
Declared inmodules/jellyfin/libaries/options.nix

nixflix.jellyfin.libraries.<name>.useCustomTagDelimiters

Use custom tag delimiters for parsing metadata

Typeboolean
Default
false
Declared inmodules/jellyfin/libaries/options.nix