Skip to content

Jellyfin - System - Trickplay Options

Configuration options for jellyfin system trickplayOptions.

Available Options

This page documents 12 configuration options.

nixflix.jellyfin.system.trickplayOptions.enableHwAcceleration

Whether to enable hardware acceleration.

Typeboolean
Default
false
Example
true
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.enableHwEncoding

Whether to enable hardware encoding.

Currently only available on QSV, VA-API, VideoToolbox and RKMPP, this option has no effect on other hardware acceleration methods.

Typeboolean
Default
false
Example
true
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.enableKeyFrameOnlyExtraction

Whether to enable key frame only extraction.

Extract key frames only for significantly faster processing with less accurate timing. If the configured hardware decoder does not support this mode, will use the software decoder instead.

Typeboolean
Default
false
Example
true
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.interval

Interval of time (ms) between each new trickplay image.

Typesigned integer
Default
10000
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.jpegQuality

The JPEG compression quality for trickplay images.

Typeinteger between 0 and 100 (both inclusive)
Default
90
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.processPriority

Setting this lower or higher will determine how the CPU prioritizes the ffmpeg trickplay generation process in relation to other processes. If you notice slowdown while generating trickplay images but don't want to fully stop their generation, try lowering this as well as the thread count.

Typeone of "High", "AboveNormal", "Normal", "BelowNormal", "Idle"
Default
"BelowNormal"
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.processThreads

The number of threads to pass to the '-threads' argument of ffmpeg.

Typesigned integer
Default
1
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.qscale

The quality scale of images output by ffmpeg, with 2 being the highest quality and 31 being the lowest.

Typeinteger between 2 and 31 (both inclusive)
Default
4
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.scanBehavior

The default behavior is non blocking, which will add media to the library before trickplay generation is done. Blocking will ensure trickplay files are generated before media is added to the library, but will make scans significantly longer.

Typeone of "NonBlocking", "Blocking"
Default
"NonBlocking"
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.tileHeight

Maximum number of images per tile in the X direction.

Typesigned integer
Default
10
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.tileWidth

Maximum number of images per tile in the X direction.

Typesigned integer
Default
10
Declared inmodules/jellyfin/options/system.nix

nixflix.jellyfin.system.trickplayOptions.widthResolutions

List of the widths (px) that trickplay images will be generated at. All images should generate proportionally to the source, so a width of 320 on a 16:9 video ends up around 320x180.

Typelist of signed integer
Default
[
  320
]
Declared inmodules/jellyfin/options/system.nix