User interface

Control theme, visibility, and HTTP/HTTPS mode for the web app.

Choose which dashboard elements stay visible and how CrossWatch serves the UI.

Most changes apply after you click Save.

Theme and visibility changes apply immediately.

Protocol and TLS changes need a restart.

Visibility

These controls only change the UI.

They do not change sync, scrobble, or provider behavior.

Watchlist

Show or hide the Watchlist preview card on the main dashboard.

Playing card

Show or hide the footer Now Playing card.

This does not disable Watcher or playback tracking.

Recent activity

Show or hide the Recent Activity widget on the main dashboard.

Hiding it does not stop local activity logging.

Recent activity display

Choose how much Recent Activity the main dashboard shows.

Options:

• Last 3 items

• Last 4 items

• Last 5 items

• Last 24 hours, max 5

• Last 48 hours, max 5

• Last 72 hours, max 5

Default:

• Last 3 items

Guide: Recent Activity

Recent syncs display

Choose how many recent sync items the dashboard shows.

Help ASK AI

Show or hide the ASK AI entry in the help UI.

Desktop Quick Add

Show or hide the desktop Quick Add entry in the UI.

Mobile Quick Add

Show or hide the mobile Quick Add entry in the UI.

Theme

Theme

Choose the theme for the full web interface.

Theme changes affect presentation only.

They do not change sync settings or provider behavior.

Options:

• Flat dark — default theme with dark backgrounds, flat panels, reduced effects, and clear contrast

• Flat light — light version of the flat theme with light backgrounds, dark text, and adjusted borders and status colors

• Original — restores the classic CrossWatch look and removes the flat-theme styling layer

To change the theme:

1. Open Settings.

2. Open UI settings → User interface.

3. Locate Theme.

4. Choose Flat dark, Flat light, or Original.

5. Click Save.

The selected theme applies immediately.

No page reload or CrossWatch restart is required.

CrossWatch also stores the current selection in the browser.

This keeps the same theme active when you open the page again.

Clicking Save writes the value to ui.theme in the CrossWatch configuration.

On startup, CrossWatch applies the stored theme before the main UI finishes loading.

This reduces visible theme switching while the page opens.

Missing or unsupported values fall back to Flat dark.

Protocol

UI protocol

Choose how CrossWatch serves the web app.

• HTTP — best when a reverse proxy already handles HTTPS

• HTTPS (self-signed) — CrossWatch serves HTTPS directly with its own certificate

If you switch between HTTP and HTTPS, update any webhook or callback URL that points to CrossWatch.

Advanced TLS

Use Advanced next to the protocol setting for certificate controls.

That includes:

• self-signed vs custom certificate mode

• hostname and SAN values

• cert and key file paths

• certificate download and regeneration

• path validation and TLS status

Restart CrossWatch after changing protocol, certificate mode, hostname, SANs, or cert paths.

Use HTTPS/TLS for the full TLS guide, including certificate trust, reverse proxy setup, and troubleshooting.