All settings reference

Most users don't need this page. It is the exhaustive list; for the settings you would normally change see Device settings reference.

Settings are values that stay on the screen until you change them. For the one-off actions you send to a screen — reboot, screenshot, display on or off — see All remote commands (reference) instead.

The complete list of settings the impressPlayer actually implements, taken from the player's own configuration source. Settings are delivered to a screen from the gateway (and on Electron can be overridden by environment variables). Defaults and platform notes are shown where they matter.

Not every setting applies to every screen. Some are platform-specific (Electron / WebOS / Tizen / Orsay) or only relevant to special hardware (LED walls, cameras). Where a setting isn't supported on a platform, it's simply ignored.

Settings priority (highest wins): 1) platform mandatory adjustments → 2) environment variables (Electron) → 3) gateway settings → 4) built-in defaults.

Display & hardware

  • Backlight / brightness (DEVICE.display.BACKLIGHT) — 0–100, default 50. This is the real per-device brightness. (Automatic sunrise/sunset brightness is computed in the manage layer and applied through this value.)

  • Rotation (DEVICE.display.display_rotate) — 0 / 90 / 180 / 270, default 0.

  • Scaling mode (DEVICE.display.mode) — how content fits the screen: CONTAIN (fit, keep ratio — default), STRETCH (fill, may distort), COVER (fill, may crop).

  • LED walls (Electron): cabinet width/height, panel width/height (px), video display width/height, plus self-test thresholds for "may be broken" / "broken" pixel percentages.

Audio

  • Volume (DEVICE.audio.sound_volume) — 0–100, default 0.

Power & wake (Tizen / WebOS)

  • Scheduled power on/off (USE_ON_OFF_TIMERS) — default on. Disable it if a screen should never auto-power.

  • Disable power-off timer (DISABLE_OFF_TIMER).

  • Wake-on-LAN / Wake-on-WLAN (WebOS).

  • Check firmware on init (CHECK_FIRMWARE, WebOS).

Playback behaviour

  • Gapless (PLAYER.GAPLESS, default on) — seamless transitions between tracks.

  • Disable graceful — switch playlists without finishing the current track (default off).

  • Stream timeout — live-stream timeout in seconds (default 30).

  • Loop (Electron/VLC) — repeat at end.

  • Require time sync (default on) — date-restricted content only plays if the device clock is NTP-synchronized. Important: a screen with no time sync won't show date-limited content (see Advanced playback restrictions).

  • Don't play without NTP (Electron) — stop entirely if time sync fails.

  • Proxy remote tracks — download remote files via proxy.

  • HTML behaviour — always reload HTML between plays; ignore clicks/touches on HTML; use source URL instead of rendered HTML (templates).

Player viewport & position

  • Position (PLAYER.POSITION) — the player's size and placement on the screen using CSS-like values (width/height + top/right/bottom/left, e.g. "100px", "5%", "auto"). Use this to inset or place the player within an unusual screen. (The older PLAYER.PADDING is deprecated.)

Reliability automations (self-healing)

  • Playback-error reboot — auto-reboot after repeated playback errors (default on; triggers after 3 errors).

  • Track-skip reboot — auto-reboot if too many tracks skip (default off).

  • Black-screen watchdog — detect a black screen during video and recover (default off).

Playlist

  • Always load current — fetch the current playlist on startup.

  • Seek to scheduled time on play — start a playlist at the position matching its scheduled time rather than the beginning.

  • Emergency playlist — switch to a fallback playlist on failure: emergency identifier and emergency volume (0–100).

  • Track location — which source to use for files: DEFAULT or UPLOAD.

Schedule

  • Schedule items (SCHEDULE.items) — the timed actions for the device (display on/off and timed playback), as managed from the Schedules view (see Recurring daily display on/off).

Advertising

  • Strategy — how ads are inserted into playback: SKIP (an ad after every N items), TIME (an ad after every N seconds, min 5), or END.

  • Fallback device id — a backup identifier used to fetch ads, with an optional "force until" datetime.

Synchronized playback (master / slave)

The old gateway sync fields are deprecated — set up sync from the admin panel instead. For reference, sync supports a method (webrtc default, or websocket), a master and slave role, and a group name. See Synchronized playback (master / slave).

On-screen extras

  • Running line — a moving text banner over content: text, color, background, font size, scroll speed, vertical shift, and an optional clock (off by default).

  • HTML overlay — a custom HTML layer over the player: content, fit, opacity, colors, and CSS-like position. Off by default.

Status & analytics

  • Status interval — how often the device reports status (seconds, min 3, default 10).

  • Statistics — send playback analytics (default on), with batch size and reduced-sending "flushing hours" (start/end hour) to ease network load overnight.

Time

  • NTP server and time zone — keep these correct, since date restrictions and schedules depend on accurate time.

Logging

  • Log level — DEFAULT or DEBUG.

On-device services (advanced)

The player can run local services, each with an enable flag and a port:

  • HTTP API service (off by default; has its own auth — change the default credentials if you enable it).

  • Watchdog service (on) — automatic app restart.

  • Control service (off) — for the Control App.

  • Proxy service (off).

  • Health service (on).

Integrations (advanced / special hardware)

  • MQTT — broker integration (URL, user, password, topic).

  • UDP triggers — listen/send UDP to trigger playback, with an optional delay.

  • Hikvision camera — camera-event triggers (IP, port, credentials, trigger payloads).

  • AI inference (camera analytics) — camera-based audience insights: image vs stream mode, processing interval, image size, camera FOV/position, screen dimensions.

  • LED monitoring & self-test (Electron) — health checks and defect thresholds for LED walls.

  • Beanstaller (WebOS) — remote TV-app installation.

Connection & config (advanced)

  • Manage URL / Gateway URL / STOMP (RabbitMQ WebSocket) URL — the backend endpoints (auto-downgraded to HTTP on Orsay/Tizen where required).

  • Remote config file — a URL the player can pull extra configuration from, with a timeout.

  • Debug mode — verbose diagnostics.

Environment variables (Electron only)

On Electron players, env vars override gateway settings (and revert when removed). The common ones cover device id/pin, manage/gateway/STOMP URLs, debug, enabling the HTTP/health services, audio and video handlers, audio normalization, video scaling mode, and a custom window size/position (IMPRESSBOX_VIDEO_DISPLAY_WIDTH/HEIGHT, ..._POSITION_X/Y). See Custom resolution, width & height.

Account-level settings (manage app)

The settings above live on the device. Your account also has settings (content conversion, bitrate, AI options, interface toggles, watchdog) — those are covered separately in User settings.