Settings reference

Every setting Loombre's settings screen lets you change, grouped the way the screen groups them, generated directly from the same source the settings screen itself reads — so this page can never drift from what you actually see there.

How to read this page

• Applies immediately means the change takes effect right away.
• Applies after a restart means Loombre saves your change now but keeps using the old value until the server restarts — you'll see a reminder banner in the meantime. Nothing currently playing is ever interrupted by this.
• Can be locked means whoever installed Loombre can fix a setting to one value from outside the settings screen. When that's done, this screen shows the setting as controlled by the environment and you can't change it here — ask them if you need it changed.

Video conversion & playback quality

How Loombre converts video for playback, and how much of it happens at once.

Maximum simultaneous conversions

Setting key: transcode.maxSimultaneousTranscodes

How many videos this server will convert at the same time. Lowering it never interrupts anything already playing — it only makes the next person wait for a free slot.

• Default: 1 (Tier 0) / 2 (Tier 1) / 4 (Tier 2) (varies by hardware tier — see Install: system requirements for what Tier 0/1/2 mean)
• Applies: immediately — no restart needed.
• Note: Setting this too high can overload the server if several videos convert at once — raise it gradually and keep an eye on how the machine handles it.
• Can be locked: if LOOMBRE_MAX_TRANSCODES is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Prefer efficient video format when converting

Setting key: transcode.hevcEncodePreferred

When converting, prefer the newer, more efficient video format (HEVC) over the older, more compatible one (H.264). Only used when your hardware supports it.

• Default: On
• Applies: immediately — no restart needed.

Allow software HDR color adjustment

Setting key: transcode.allowToneMapCpu

Advanced: whether Loombre may convert high-dynamic-range (HDR) video to standard range using the processor when the video hardware can't do it directly. Processor conversion is slower and uses more of the server's resources. By default this is only allowed on more capable servers; it can also be switched on everywhere or off entirely.

• Default: tier-gated
• Applies: immediately — no restart needed.

Quality levels used when converting

Setting key: transcode.ladderRungs

The set of quality levels Loombre can switch between while converting, best first. Loombre picks the highest one your connection can keep up with.

• Default: the standard quality ladder (6 levels, highest first)
• Applies: immediately — no restart needed.

Pause conversion when far ahead of playback

Setting key: transcode.segmentAheadSuspendThreshold

Advanced: how far ahead of what's currently playing Loombre is allowed to convert before it pauses conversion to save resources, measured in a few seconds of video at a time. Applies for the rest of the current viewing session — a change takes effect the next time someone starts watching something that needs converting.

• Default: 10
• Applies: immediately — no restart needed.

Resume conversion after pausing

Setting key: transcode.segmentAheadResumeThreshold

Advanced: how far the paused conversion above has to catch back down to before Loombre resumes it. Applies the same way as the setting above — the next time someone starts watching something that needs converting.

• Default: 5
• Applies: immediately — no restart needed.

Library scanning

How Loombre watches and scans your library folders.

Library scan speed

Setting key: scanner.concurrency

How many files Loombre examines at once while scanning. Higher is faster but works the machine harder; takes effect on the next scan. When you haven't changed it, Loombre uses half your processor cores (minimum 2).

• Default: 2
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_SCAN_CONCURRENCY is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Grace period for missing files

Setting key: scanner.missingFileGraceHours

How long a file can be missing before Loombre removes it from your library. The delay protects your watch history when a network drive drops out briefly.

• Default: 72
• Applies: immediately — no restart needed.

Image quality

Quality and format settings for poster/thumbnail images Loombre generates.

Generate modern image format (AVIF)

Setting key: images.avifEnabled

Also save each poster and thumbnail in a newer, smaller image format (AVIF) alongside the standard one, when this server is able to create it. Turning this off only stops new AVIF copies from being made — images already created are untouched. Takes effect the next time an image is generated or a scan re-processes one.

• Default: On
• Applies: immediately — no restart needed.

Image quality (WebP)

Setting key: images.webpQuality

Image quality for posters and thumbnails, from 1 (smallest file, lowest quality) to 100 (largest file, highest quality). Already-created images are untouched — this only affects new images and ones a future scan re-creates.

• Default: 80
• Applies: immediately — no restart needed.

Image quality (AVIF)

Setting key: images.avifQuality

Image quality for the smaller AVIF copies of posters and thumbnails (see the setting above), from 1 to 100, used when that setting is turned on and this server can create them. Already-created images are untouched — this only affects new images and ones a future scan re-creates.

• Default: 50
• Applies: immediately — no restart needed.

Restricted content

Server-wide restricted-content settings — see the User Guide's Restricted content page for what this looks like for someone using the account.

Enable restricted content

Setting key: restricted.enabled

Turns the restricted-content feature on for this server. Off by default. While off, no restricted libraries or restricted content can be created.

• Default: Off
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_RESTRICTED_ENABLED is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Minimum age for restricted content

Setting key: restricted.majorityAgeYears

The minimum age for restricted content. Can be raised, never lowered — 18 is a hard floor the server enforces in several independent places.

• Default: 18
• Applies: immediately — no restart needed.

How long restricted content stays unlocked

Setting key: restricted.defaultUnlockDurationMs

How long restricted content stays unlocked after someone enters their PIN, before it locks itself again.

• Default: 30 minutes
• Applies: immediately — no restart needed.
• Note: Longer times mean the PIN is asked for less often — on a shared device that means restricted content stays available to whoever picks it up.

Playback sessions

When an inactive playback session is treated as ended or paused.

End inactive playback sessions after

Setting key: sessions.staleCutoffMs

How long Loombre waits after a device stops responding before treating that person's playback as finished and freeing up the resources.

• Default: 15 minutes
• Applies: immediately — no restart needed.

Pause conversion for inactive sessions after

Setting key: sessions.heartbeatSuspendCutoffMs

How long Loombre waits after a device goes quiet before pausing its conversion. Playback isn't ended — it resumes when the device comes back.

• Default: 90 seconds
• Applies: immediately — no restart needed.

Update checking

Whether Loombre checks for newer versions. Never installs anything automatically.

Check for updates

Setting key: updateCheck.mode

Whether Loombre checks for a newer version. 'daily' checks at startup and once a day; 'manual' only when you ask; 'off' never. Nothing identifying is ever sent, in any mode. Loombre never installs an update by itself.

• Default: daily
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_UPDATE_CHECK is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Security & sign-in logging

Local logging of suspicious sign-in activity.

Log suspicious sign-in activity

Setting key: security.loginAnomalyLogEnabled

Record suspicious sign-in activity — failed passwords, wrong PINs, too many attempts — to a log file on this machine. Nothing is ever sent anywhere.

• Default: On
• Applies: immediately — no restart needed.

Sign-in & request limits

How many attempts or requests are allowed in a given time window, per person or device — protects against automated guessing without locking anyone out under normal use.

Sign-in attempt limit

Setting key: rateLimit.login

How many sign-in attempts one device may make per minute before Loombre starts turning it away. Guards against password guessing.

• Default: 10
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_RATE_LOGIN is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Session refresh limit

Setting key: rateLimit.refresh

How many session-refresh requests one device may make per minute. Guards against a device flooding the server with requests for new sign-in tokens.

• Default: 30
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_RATE_REFRESH is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Restricted-content PIN attempt limit

Setting key: rateLimit.unlock

How many PIN attempts one person may make per minute when unlocking restricted content. Guards against someone guessing the PIN.

• Default: 5
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_RATE_UNLOCK is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Setup wizard request limit

Setting key: rateLimit.setup

How many requests one device may make per minute to the first-time setup screen, before any account exists. Guards against abuse of that screen.

• Default: 20
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_RATE_SETUP is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Capability check request limit

Setting key: rateLimit.capabilities

How many times one device may ask the server what it supports, per minute. This is checked often during normal use, so the limit is set high.

• Default: 120
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_RATE_CAPABILITIES is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Data export request limit

Setting key: rateLimit.export

How many full library exports one person may download per hour (not per minute — exports are heavy).

• Default: 5
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_RATE_EXPORT is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.

Media playback request limit

Setting key: rateLimit.mediaToken

How many media requests one person may make per minute — posters, video, and subtitles combined. Set this high: normal viewing makes many small requests.

• Default: 600
• Applies: immediately — no restart needed.
• Can be locked: if LOOMBRE_RATE_MEDIA_TOKEN is set by whoever installed Loombre, this setting becomes fixed to that value and shows as controlled by the environment here — ask them, or see the Operator Guide's environment reference.