App settings

Every setting you can change in JellyRock, grouped as in the app’s Settings screen. Each entry shows its default, its options and the name JellyRock stores it under.

Generated from settings/settings.json by npm run docs:settings. To change this page, edit that file and run the command.

• Global
• Playback
• User Interface

Global

Global settings that affect everyone that uses this Roku device.

• Remember Me?
• Splash Screen Image
• Sign-in Screen Language

Remember Me?

Global › Remember Me?

Remember the currently logged in user and try to log them in again next time you start the JellyRock app.

Property	Value
Setting Name	globalRememberMe
Type	bool
Default	false

Splash Screen Image

Global › Splash Screen Image

Control whether the server’s splash screen image is displayed on the User Select screen. Server admin must enable this feature in branding settings.

Property	Value
Setting Name	globalSplashScreen
Type	radio
Default	enabled
Options	Name ID Enabled enabled Disabled disabled

Sign-in Screen Language

Global › Sign-in Screen Language

Language for the sign-in screens, shown before anyone logs in. ‘Automatic’ uses the Roku device language. Takes effect next time you sign in.

Property	Value
Setting Name	globalTranslationLocale
Type	languagePicker
Default	“

⬆️ Back to top

Playback

Settings relating to playback and supported codec and media types.

• Bitrate Limit
  • Enable Limit
  • Maximum Bitrate
• Cinema Mode
• Custom Subtitles
• Decode Multichannel Audio
• Language Preferences
  • Audio Language Preference
  • Custom Audio Language Code
  • Subtitle Language Preference
  • Custom Subtitle Language Code
• Maximum Resolution
• Media Segments
  • Commercial Action
  • Intro Action
  • Outro Action
  • Preview Action
  • Recap Action
  • Unknown Action
• Instant Replay Duration
• Next Episode Button Time
• Play Default Audio Track
• Play Next Episode Automatically
• Preferred Surround Audio Codec
• Preserve DoVi
• Still Watching Prompt
• SyncPlay Time Offset
• Text Subtitles Only
• Video Codec Support
  • Force Transcode Anamorphic Video
  • MPEG-2
  • MPEG-4
• Video Profile Level Support
  • H.264
  • HEVC

Cinema Mode

Playback › Cinema Mode

Bring the theater experience straight to your living room with the ability to play custom intros before the main feature.

Property	Value
Setting Name	playbackCinemaMode
Type	bool
Default	false

Custom Subtitles

Playback › Custom Subtitles

Use custom subtitle rendering for external VTT subtitle files. Enables fallback fonts from the server and removes some formatting tags from misformatted subtitles. Note: May not fully support all Roku caption preferences.

Property	Value
Setting Name	playbackSubsCustom
Type	bool
Default	true

Decode Multichannel Audio

Playback › Decode Multichannel Audio

When enabled (default), Roku decodes multichannel audio itself (Opus, AAC, FLAC, ALAC, PCM, Vorbis). Disable to make the server transcode instead — try this if surround audio sounds garbled or distorted, or to force surround passthrough (EAC3/AC3/DTS).

Property	Value
Setting Name	playbackDecodeMultichannelAudio
Type	bool
Default	true

Maximum Resolution

Playback › Maximum Resolution

Configure the maximum resolution when transcoding video files to this device.

Property	Value
Setting Name	playbackResolutionMax
Type	radio
Default	auto
Options	Name ID Off - Attempt to direct play all resolutions off Auto - Use TV resolution auto 360p 360 480p 480 720p 720 1080p 1080 4k 2160 8k 4320

Instant Replay Duration

Playback › Instant Replay Duration

How many seconds the instant replay button (and the “replay” voice command) jumps backward during video playback.

Property	Value
Setting Name	playbackInstantReplaySeconds
Type	integer
Default	10

Next Episode Button Time

Playback › Next Episode Button Time

Set how many seconds before the end of an episode the Next Episode button should appear. Set to 0 to disable.

Property	Value
Setting Name	playbackNextUpButtonSeconds
Type	integer
Default	30

Play Default Audio Track

Playback › Play Default Audio Track

Override web client audio preference. When enabled, use the IsDefault flag to select audio track. When disabled, prefer language match and ignore IsDefault.

Property	Value
Setting Name	playbackPlayDefaultAudioTrack
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Enabled enabled Disabled disabled

Play Next Episode Automatically

Playback › Play Next Episode Automatically

When finished playing a single episode, play the next one automatically.

Property	Value
Setting Name	playbackPlayNextEpisode
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Enabled enabled Disabled disabled

Preferred Surround Audio Codec

Playback › Preferred Surround Audio Codec

When transcoding multichannel audio, prefer this codec. EAC3 supports up to 7.1 channels with better compression. AC3 is more widely compatible. DTS is an alternative for systems that prefer it. This only affects 6 and 8 channel transcoding profiles.

Property	Value
Setting Name	playbackPreferredMultichannelCodec
Type	radio
Default	eac3
Options	Name ID Dolby Digital Plus (EAC3) eac3 Dolby Digital (AC3) ac3 DTS dts

Preserve DoVi

Playback › Preserve DoVi

Preserve Dolby Vision content when possible by forcing remux instead of direct playback when using MKV container files. This ensures proper Dolby Vision playback on supported devices.

Property	Value
Setting Name	playbackPreserveDovi
Type	bool
Default	true

Still Watching Prompt

Playback › Still Watching Prompt

Ask if you’re still watching when videos keep playing on their own with no button pressed. If nobody answers, playback pauses.

Property	Value
Setting Name	playbackStillWatching
Type	radio
Default	default
Options	Name ID Disabled disabled 2 videos or 60 minutes short 3 videos or 90 minutes default 5 videos or 150 minutes long 8 videos or 240 minutes veryLong

SyncPlay Time Offset

Playback › SyncPlay Time Offset

How many milliseconds ahead of the group this Roku plays while in a SyncPlay group, to make up for the delay your TV or sound system adds. Raise it if this Roku sounds behind the others. 0 keeps it on the group’s clock.

Property	Value
Setting Name	playbackSyncPlayTimeOffsetMs
Type	integer
Default	0
Range	0 to 500

Text Subtitles Only

Playback › Text Subtitles Only

Only display text subtitles to minimize transcoding.

Property	Value
Setting Name	playbackSubsOnlyText
Type	bool
Default	false

Bitrate Limit

Configure the maximum playback bitrate.

Enable Limit

Playback › Bitrate Limit › Enable Limit

Enable or disable the ‘Maximum Bitrate’ setting.

Property	Value
Setting Name	playbackBitrateMaxLimited
Type	bool
Default	false

Maximum Bitrate

Playback › Bitrate Limit › Maximum Bitrate

Set the maximum bitrate in Mbps. 0 means no limit. This setting must be enabled to take effect.

Property	Value
Setting Name	playbackBitrateLimit
Type	integer
Default	0

Language Preferences

Override the web client’s audio and subtitle language preferences for this device.

Audio Language Preference

Playback › Language Preferences › Audio Language Preference

Override the web client’s audio language preference. Controls which language audio track is preferred during playback.

Property	Value
Setting Name	playbackAudioLanguagePreference
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Use Roku Language roku Custom custom

Custom Audio Language Code

Playback › Language Preferences › Custom Audio Language Code

Enter a 3-letter ISO 639-2 language code (e.g., eng, jpn, fra, deu, spa).

Property	Value
Setting Name	playbackAudioLanguageCustom
Type	alpha
Default	“

Subtitle Language Preference

Playback › Language Preferences › Subtitle Language Preference

Override the web client’s subtitle language preference. Controls which language subtitle track is preferred during playback.

Property	Value
Setting Name	playbackSubtitleLanguagePreference
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Use Audio Language audio Use Roku Language roku Custom custom

Custom Subtitle Language Code

Playback › Language Preferences › Custom Subtitle Language Code

Enter a 3-letter ISO 639-2 language code (e.g., eng, jpn, fra, deu, spa).

Property	Value
Setting Name	playbackSubtitleLanguageCustom
Type	alpha
Default	“

Media Segments

Control how media segments (Intro, Outro, etc.) are handled during playback. Requires Jellyfin server 10.10.0 or newer with segment detection configured.

Commercial Action

Playback › Media Segments › Commercial Action

Action to take when a Commercial segment is detected during playback.

Property	Value
Setting Name	playbackSegmentActionCommercial
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Auto Skip skip Show Skip Button askToSkip Do Nothing none

Intro Action

Playback › Media Segments › Intro Action

Action to take when an Intro segment is detected during playback.

Property	Value
Setting Name	playbackSegmentActionIntro
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Auto Skip skip Show Skip Button askToSkip Do Nothing none

Outro Action

Playback › Media Segments › Outro Action

Action to take when an Outro segment is detected during playback.

Property	Value
Setting Name	playbackSegmentActionOutro
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Auto Skip skip Show Skip Button askToSkip Do Nothing none

Preview Action

Playback › Media Segments › Preview Action

Action to take when a Preview segment is detected during playback.

Property	Value
Setting Name	playbackSegmentActionPreview
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Auto Skip skip Show Skip Button askToSkip Do Nothing none

Recap Action

Playback › Media Segments › Recap Action

Action to take when a Recap segment is detected during playback.

Property	Value
Setting Name	playbackSegmentActionRecap
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Auto Skip skip Show Skip Button askToSkip Do Nothing none

Unknown Action

Playback › Media Segments › Unknown Action

Action to take when an Unknown segment type is detected during playback.

Property	Value
Setting Name	playbackSegmentActionUnknown
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Auto Skip skip Show Skip Button askToSkip Do Nothing none

Video Codec Support

Enable or disable Direct Play support for certain codecs.

Force Transcode Anamorphic Video

Playback › Video Codec Support › Force Transcode Anamorphic Video

Force transcoding of anamorphic video (non-square pixels). Enable this if you see squished or stretched video during playback.

Property	Value
Setting Name	playbackForceTranscodeAnamorphic
Type	bool
Default	false

MPEG-2

Playback › Video Codec Support › MPEG-2

Direct Play MPEG-2 video instead of transcoding it, which uses significantly more bandwidth. Does not apply to Live TV or other MPEG-TS sources, which are always transcoded.

Property	Value
Setting Name	playbackMpeg2
Type	bool
Default	false

MPEG-4

Playback › Video Codec Support › MPEG-4

Support Direct Play of MPEG-4 content. This may need to be disabled for playback of DIVX encoded video files.

Property	Value
Setting Name	playbackMpeg4
Type	bool
Default	true

Video Profile Level Support

Attempt Direct Play of potentially unsupported profile levels

H.264

Playback › Video Profile Level Support › H.264

Attempt Direct Play for H.264 media with unsupported profile levels before falling back to transcoding if it fails.

Property	Value
Setting Name	playbackTryDirectH264ProfileLevel
Type	bool
Default	false

HEVC

Playback › Video Profile Level Support › HEVC

Attempt Direct Play for HEVC media with unsupported profile levels before falling back to transcoding if it fails.

Property	Value
Setting Name	playbackTryDirectHevcProfileLevel
Type	bool
Default	false

⬆️ Back to top

User Interface

Settings relating to how the application looks.

• General
  • Display Language
  • Backdrop Images
  • Episode Images Next Up
  • Fallback Fonts
  • Hide Clock
  • Home Row Size
  • Max Days Next Up
  • Rewatching Next Up
  • Row Layout
  • Theme
  • Custom Theme Colors
    • Background - Primary
    • Background - Secondary
    • Primary
    • Secondary
    • Text - Disabled
    • Text - Primary
    • Text - Secondary
  • Use Web Client’s Home Section Arrangement
• Libraries
  • General
    • Grid View Settings
      • Item Count
      • Item Titles
    • Hide Taglines
    • Return to Top
  • Movies
    • Community and Critical Ratings
    • Default View
  • TV Shows
    • Blur Unwatched Episodes
    • Disable Community Rating for Episodes
    • Disable Unwatched Episode Count

General

Settings relating to the appearance of the Home screen and the program in general.

Display Language

User Interface › General › Display Language

Choose the language for all app text. ‘Automatic’ uses your Jellyfin server or Roku device language. Changes take effect after leaving Settings.

Property	Value
Setting Name	translationLocale
Type	languagePicker
Default	“

Backdrop Images

User Interface › General › Backdrop Images

Control display of backdrop images throughout the app. Enable for full visual experience, disable for better performance or accessibility.

Property	Value
Setting Name	uiShowBackdrop
Type	radio
Default	enabled
Options	Name ID Enabled enabled Disabled disabled

Episode Images Next Up

User Interface › General › Episode Images Next Up

What type of images to use for Episodes shown in the ‘Next Up’ and ‘Continue Watching’ sections.

Property	Value
Setting Name	uiGeneralEpisodeImages
Type	radio
Default	webclient
Options	Name ID Use Web Client Setting webclient Use Episode Image episode Use Show Image show

Fallback Fonts

User Interface › General › Fallback Fonts

Replace Roku’s system font with the fallback font provided by the Jellyfin server. Fallback fonts must be configured and enabled by the server admin for this to work. JellyRock will need to be restarted.

Property	Value
Setting Name	uiFontFallback
Type	bool
Default	false

Hide Clock

User Interface › General › Hide Clock

Hide all clocks in JellyRock. JellyRock will need to be closed and reopened for changes to take effect.

Property	Value
Setting Name	uiDesignHideClock
Type	bool
Default	false

Home Row Size

User Interface › General › Home Row Size

Sets how many items the Recently Added, On Now and Active Recordings rows load; Continue Watching and Next Up always show your full list. Higher values load more slowly, especially on older devices or with many libraries. Applies next time Home loads.

Property	Value
Setting Name	uiHomeRowLimit
Type	integer
Default	32
Range	1 to 100

Max Days Next Up

User Interface › General › Max Days Next Up

Set the maximum amount of days a show should stay in the ‘Next Up’ list without watching it.

Property	Value
Setting Name	uiDetailsMaxDaysNextUp
Type	integer
Default	0

Rewatching Next Up

User Interface › General › Rewatching Next Up

Show already watched episodes in ‘Next Up’ sections.

Property	Value
Setting Name	uiDetailsEnableRewatchingNextUp
Type	bool
Default	false

Row Layout

User Interface › General › Row Layout

Choose how rows are displayed throughout the app.

Property	Value
Setting Name	uiRowLayout
Type	radio
Default	fullwidth
Options	Name ID Original original Full Width fullwidth

Theme

User Interface › General › Theme

Select a color theme. Choose ‘Custom’ to manually set individual colors.

Property	Value
Setting Name	uiTheme
Type	radio
Default	jellyrock
Options	Name ID JellyRock jellyrock JellyRock (Black) jellyrock-black Emerald emerald Ember ember Rose rose Ocean ocean Dusk dusk Midnight midnight High Contrast high-contrast Custom custom

Use Web Client's Home Section Arrangement

User Interface › General › Use Web Client’s Home Section Arrangement

Make the arrangement of the Roku home view sections match the web client’s home screen. JellyRock will need to be closed and reopened for change to take effect.

Property	Value
Setting Name	uiHomeUseWebArrangement
Type	bool
Default	true

Custom Theme Colors

Manually set individual theme colors.

Background - Primary

User Interface › General › Custom Theme Colors › Background - Primary

The app’s main background behind all content.

Property	Value
Setting Name	uiThemeColorBackgroundPrimary
Type	text
Default	0D1117

Background - Secondary

User Interface › General › Custom Theme Colors › Background - Secondary

Background for cards, panels, buttons, and popups.

Property	Value
Setting Name	uiThemeColorBackgroundSecondary
Type	text
Default	161B22

Primary

User Interface › General › Custom Theme Colors › Primary

Focus borders and highlights that show where you are.

Property	Value
Setting Name	uiThemeColorPrimary
Type	text
Default	8B5CF6

Secondary

User Interface › General › Custom Theme Colors › Secondary

Selected tabs, progress bars, and visual accents.

Property	Value
Setting Name	uiThemeColorSecondary
Type	text
Default	3B82F6

Text - Disabled

User Interface › General › Custom Theme Colors › Text - Disabled

Text color for disabled or inactive elements.

Property	Value
Setting Name	uiThemeColorTextDisabled
Type	text
Default	4A4A4A

Text - Primary

User Interface › General › Custom Theme Colors › Text - Primary

Primary text color used throughout the app.

Property	Value
Setting Name	uiThemeColorTextPrimary
Type	text
Default	F0F0F0

Text - Secondary

User Interface › General › Custom Theme Colors › Text - Secondary

Subtitles, hints, and less prominent text.

Property	Value
Setting Name	uiThemeColorTextSecondary
Type	text
Default	A8A8A8

Libraries

Settings relating to the appearance of Library pages.

General

Settings relating to the appearance of pages in all Libraries.

Hide Taglines

User Interface › Libraries › General › Hide Taglines

Hides tagline text on details pages.

Property	Value
Setting Name	uiDetailsHideTagline
Type	bool
Default	false

Return to Top

User Interface › Libraries › General › Return to Top

Use the replay button to slowly animate to the first item in the folder. (If disabled, the folder will reset to the first item immediately).

Property	Value
Setting Name	itemGridReset
Type	bool
Default	true

Grid View Settings

Settings that apply when Grid views are enabled.

Item Count

User Interface › Libraries › General › Grid View Settings › Item Count

Show item count in the library and index of selected item.

Property	Value
Setting Name	itemGridShowItemCount
Type	bool
Default	false

Item Titles

User Interface › Libraries › General › Grid View Settings › Item Titles

Select when to show titles.

Property	Value
Setting Name	itemGridTitles
Type	radio
Default	showalways
Options	Name ID Show On Hover showonhover Always Show showalways Always Hide hidealways

Movies

Settings relating to the appearance of pages in Movie Libraries.

Community and Critical Ratings

User Interface › Libraries › Movies › Community and Critical Ratings

Ratings for how good a movie is.

Property	Value
Setting Name	uiMoviesShowRatings
Type	bool
Default	true

Default View

User Interface › Libraries › Movies › Default View

Default view for Movie Libraries.

Property	Value
Setting Name	itemGridMovieDefaultView
Type	radio
Default	moviesgrid
Options	Name ID Movies (Presentation) Movies Movies (Grid) MoviesGrid

TV Shows

Settings relating to the appearance of pages in TV Libraries.

Blur Unwatched Episodes

User Interface › Libraries › TV Shows › Blur Unwatched Episodes

Blur images of unwatched episodes.

Property	Value
Setting Name	uiTvShowsBlurUnwatched
Type	bool
Default	false

Disable Community Rating for Episodes

User Interface › Libraries › TV Shows › Disable Community Rating for Episodes

Hide the star and community rating for episodes of a TV show. This is to prevent spoilers of an upcoming good/bad episode.

Property	Value
Setting Name	uiTvShowsDisableCommunityRating
Type	bool
Default	false

Disable Unwatched Episode Count

User Interface › Libraries › TV Shows › Disable Unwatched Episode Count

If enabled, the number of unwatched episodes in a series/season will be removed.

Property	Value
Setting Name	uiTvShowsDisableUnwatchedCount
Type	bool
Default	false

⬆️ Back to top