The settings hub

Everything an owner configures is in one place, reached from the 🛠 Server button in the top bar of a browser.

Server administration is deliberately a mouse-and-keyboard job. It does not appear in the TV interface or on phones, because filling in folder paths and provider credentials with a remote control is nobody’s good time. Consuming the results, of course, happens everywhere.

Who can get in: the owner, and anyone on the same network as the server. If you have set an admin PIN, it is asked for once when you open the hub.

The sections

A rail down the left side, one section at a time, and every section has its own address so you can bookmark the one you keep coming back to.

General

The server’s display name, which is what people see when they pick it in an app. Also the launcher for the theme editor, and audio output options.

Users and Profiles

Create, rename, and delete profiles. Set PINs and rating caps. Invite people and remove their access.

Account and Remote

Link this server to your account, see the state of its connection to the outside world, and unlink. Covered in Connect your server to your account.

Libraries

Every library with its own settings dialog, plus New library and the settings that apply to all of them:

Setting	What it does
Scan interval	How often the server looks for new files by itself
Analysis parallelism	How many files it probes at once during a scan. Higher is faster and busier
TMDB token	Your own metadata key, if you would rather not use the one that comes with your account
Ratings country	Which country’s age-rating system is displayed

Import from Plex is here too.

IPTV

Live TV sources, credentials, the channel manager, and the master switch that hides live TV everywhere. See Live TV and recording.

Optimize Media

Files that are hard work to play, and a queue for pre-encoding them. See Getting the details right.

File management

Where recordings and prepared downloads are written, plus a read-only panel of facts about how this server was started:

• The data directory
• The port it is listening on
• Where its media tools are and what version they are
• Which hardware encoders it found on this machine

Those are set when the server launches, not here, which is why they are shown rather than editable.

Backups

Scheduled snapshots and one-step restore. See Backups and updates.

Integrations

Two things.

Webhooks

Send events to a URL of your choosing. Discord, Home Assistant, a script on your own machine, or anything that accepts an HTTP POST.

Events fire on:

• Playback starting
• Playback finishing
• A new item being added to a library
• A scan completing

Add a webhook, choose which events it should get, and it starts posting. Use them for a light that dims when a film starts, a channel that announces new arrivals, or your own log of what the household watches.

API tokens

Your server speaks a documented REST API, the same one our own apps use. Create token gives you one, with a choice of scope:

• Read for browsing, searching, and reading library data
• Full to also control playback on connected devices

The token is shown once. Copy it then; it is stored hashed and cannot be shown again. Revoke any token at any time.

The full reference, with a console for trying calls against your own server, is at the API reference.

Privacy and Diagnostics

Two switches, and it is worth knowing which is which because most products are not honest about this:

	Default	What leaves the box
Crash reports	On	A stack trace, your OS and architecture, and the version. Turn it off and nothing does
Anonymous usage statistics	Off	Nothing unless you turn it on. Then: version, platform, coarse counts of which features are in use

Neither carries your account, your server’s identity, or anything about your library. Reports are tagged with a random installation identifier you can reset, and are not tied to a person. It is collected by us rather than by a third-party analytics company.

There is also a switch for verbose HTTP logging, which is off by default and is there for when you are chasing a problem.

About

Version, this server’s identity, and the update card. See Backups and updates.

Also here: the legal notices, which list the open-source components the server ships with and their licences, including the written offer for the source of the media tools it bundles.

Advanced

The tuning knobs, behind a warning banner. Everything in there defaults to exactly what the server does today, so opening the section and touching nothing changes nothing. There is a full reference for every one of them.

Things that live outside the hub

Not everything is an owner setting, and two things people go looking for here are somewhere else:

• Your own preferences, meaning your theme, home screen arrangement, quality, and autoplay, are in ⚙ Settings rather than the server hub. They are per person and available on every device.
• Stats, meaning who is watching what right now and what the household has been watching, is its own page from the top bar. It is for watching, not for configuring.