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 {};
| Type | attribute set of (null or (submodule)) |
| Default | |
| Example | |
| Declared in | modules/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
| Type | one of "AllowAll", "AllowText", "AllowImage", "AllowNone" |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.automaticRefreshIntervalDays¶
Days between automatic metadata refreshes (0 to disable)
| Type | signed integer |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.automaticallyAddToCollection¶
Automatically add items to collections based on metadata
| Type | boolean |
| Default | |
| Declared in | modules/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
| Type | one of "movies", "tvshows", "music", "musicvideos", "homevideos", "boxsets", "books", "mixed" |
| Example | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.customTagDelimiters¶
Custom delimiters for parsing tags
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.delimiterWhitelist¶
Whitelist of delimiters to preserve
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.disabledLocalMetadataReaders¶
List of local metadata readers to disable
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.disabledLyricFetchers¶
List of lyric fetchers to disable
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.disabledMediaSegmentProviders¶
List of media segment providers to disable
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.disabledSubtitleFetchers¶
List of subtitle fetchers to disable
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enableAutomaticSeriesGrouping¶
Automatically group series together
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enableChapterImageExtraction¶
Extract chapter images from video files
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enableEmbeddedEpisodeInfos¶
Use embedded episode information from media files
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enableEmbeddedExtrasTitles¶
Use embedded titles for extras
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enableEmbeddedTitles¶
Use embedded titles from media files
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enableLUFSScan¶
Enable LUFS (Loudness Units Full Scale) audio normalization scanning
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enablePhotos¶
Enable photo support in this library
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enableRealtimeMonitor¶
Monitor the library folders for file changes in real-time
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enableTrickplayImageExtraction¶
Extract trickplay images (thumbnails for seeking)
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.enabled¶
Whether this library is enabled
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.extractChapterImagesDuringLibraryScan¶
Extract chapter images during library scan (vs on-demand)
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.extractTrickplayImagesDuringLibraryScan¶
Extract trickplay images during library scan (vs on-demand)
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.localMetadataReaderOrder¶
Order in which to use local metadata readers
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.lyricFetcherOrder¶
Order in which to use lyric fetchers
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.mediaSegmentProviderOrder¶
Order in which to use media segment providers
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.metadataCountryCode¶
Country code for metadata (e.g., 'US', 'GB', 'FR')
| Type | null or string |
| Default | |
| Example | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.metadataSavers¶
List of metadata savers to enable
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.paths¶
List of media folder paths for this library
| Type | list of string |
| Default | |
| Example | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.preferNonstandardArtistsTag¶
Prefer non-standard artist tags in music files
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.preferredMetadataLanguage¶
Preferred language for metadata (e.g., 'en', 'fr', 'de')
| Type | null or string |
| Default | |
| Example | |
| Declared in | modules/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.
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.saveLocalMetadata¶
Save metadata to .nfo files alongside media
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.saveLyricsWithMedia¶
Save downloaded lyrics alongside media files
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.saveSubtitlesWithMedia¶
Save downloaded subtitles alongside media files
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.saveTrickplayWithMedia¶
Save trickplay images alongside media files
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.seasonZeroDisplayName¶
Display name for season 0 (specials)
| Type | string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.skipSubtitlesIfAudioTrackMatches¶
Uncheck this to ensure all videos have subtitles, regardless of audio language.
| Type | boolean |
| Default | |
| Declared in | modules/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.
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.subtitleDownloadLanguages¶
Languages to download subtitles for
| Type | list of string |
| Default | |
| Example | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.subtitleFetcherOrder¶
Order in which to use subtitle fetchers
| Type | list of string |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |
nixflix.jellyfin.libraries.<name>.useCustomTagDelimiters¶
Use custom tag delimiters for parsing metadata
| Type | boolean |
| Default | |
| Declared in | modules/jellyfin/libaries/options.nix |