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 (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/options/libraries.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/options/libraries.nix

nixflix.jellyfin.libraries.<name>.automaticRefreshIntervalDays

Days between automatic metadata refreshes (0 to disable)

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

nixflix.jellyfin.libraries.<name>.automaticallyAddToCollection

Automatically add items to collections based on metadata

Typeboolean
Default
false
Declared inmodules/jellyfin/options/libraries.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/options/libraries.nix

nixflix.jellyfin.libraries.<name>.customTagDelimiters

Custom delimiters for parsing tags

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

nixflix.jellyfin.libraries.<name>.delimiterWhitelist

Whitelist of delimiters to preserve

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

nixflix.jellyfin.libraries.<name>.disabledLocalMetadataReaders

List of local metadata readers to disable

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

nixflix.jellyfin.libraries.<name>.disabledLyricFetchers

List of lyric fetchers to disable

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

nixflix.jellyfin.libraries.<name>.disabledMediaSegmentProviders

List of media segment providers to disable

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

nixflix.jellyfin.libraries.<name>.disabledSubtitleFetchers

List of subtitle fetchers to disable

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

nixflix.jellyfin.libraries.<name>.enableAutomaticSeriesGrouping

Automatically group series together

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

nixflix.jellyfin.libraries.<name>.enableChapterImageExtraction

Extract chapter images from video files

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

nixflix.jellyfin.libraries.<name>.enableEmbeddedEpisodeInfos

Use embedded episode information from media files

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

nixflix.jellyfin.libraries.<name>.enableEmbeddedExtrasTitles

Use embedded titles for extras

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

nixflix.jellyfin.libraries.<name>.enableEmbeddedTitles

Use embedded titles from media files

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

nixflix.jellyfin.libraries.<name>.enableLUFSScan

Enable LUFS (Loudness Units Full Scale) audio normalization scanning

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

nixflix.jellyfin.libraries.<name>.enablePhotos

Enable photo support in this library

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

nixflix.jellyfin.libraries.<name>.enableRealtimeMonitor

Monitor the library folders for file changes in real-time

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

nixflix.jellyfin.libraries.<name>.enableTrickplayImageExtraction

Extract trickplay images (thumbnails for seeking)

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

nixflix.jellyfin.libraries.<name>.enabled

Whether this library is enabled

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

nixflix.jellyfin.libraries.<name>.extractChapterImagesDuringLibraryScan

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

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

nixflix.jellyfin.libraries.<name>.extractTrickplayImagesDuringLibraryScan

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

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

nixflix.jellyfin.libraries.<name>.localMetadataReaderOrder

Order in which to use local metadata readers

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

nixflix.jellyfin.libraries.<name>.lyricFetcherOrder

Order in which to use lyric fetchers

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

nixflix.jellyfin.libraries.<name>.mediaSegmentProviderOrder

Order in which to use media segment providers

Typelist of string
Default
[ ]
Declared inmodules/jellyfin/options/libraries.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/options/libraries.nix

nixflix.jellyfin.libraries.<name>.metadataSavers

List of metadata savers to enable

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

nixflix.jellyfin.libraries.<name>.paths

List of media folder paths for this library

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

nixflix.jellyfin.libraries.<name>.preferNonstandardArtistsTag

Prefer non-standard artist tags in music files

Typeboolean
Default
false
Declared inmodules/jellyfin/options/libraries.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/options/libraries.nix

nixflix.jellyfin.libraries.<name>.requirePerfectSubtitleMatch

Only download subtitles that perfectly match the media file

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

nixflix.jellyfin.libraries.<name>.saveLocalMetadata

Save metadata to .nfo files alongside media

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

nixflix.jellyfin.libraries.<name>.saveLyricsWithMedia

Save downloaded lyrics alongside media files

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

nixflix.jellyfin.libraries.<name>.saveSubtitlesWithMedia

Save downloaded subtitles alongside media files

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

nixflix.jellyfin.libraries.<name>.saveTrickplayWithMedia

Save trickplay images alongside media files

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

nixflix.jellyfin.libraries.<name>.seasonZeroDisplayName

Display name for season 0 (specials)

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

nixflix.jellyfin.libraries.<name>.skipSubtitlesIfAudioTrackMatches

Skip downloading subtitles if audio track matches preferred language

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

nixflix.jellyfin.libraries.<name>.skipSubtitlesIfEmbeddedSubtitlesPresent

Skip downloading external subtitles if embedded subtitles are present

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

nixflix.jellyfin.libraries.<name>.subtitleDownloadLanguages

Languages to download subtitles for

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

nixflix.jellyfin.libraries.<name>.subtitleFetcherOrder

Order in which to use subtitle fetchers

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

nixflix.jellyfin.libraries.<name>.useCustomTagDelimiters

Use custom tag delimiters for parsing metadata

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