Command-line reference (Windows / Linux)

The PC edition of CS Player is driven by the cityscreen-player binary (on Windows — cityscreen-player.exe in C:\Program Files\CSPlayer\lib\player). In a typical installation you do not need any of these arguments: the player is configured from your CS Play account. Use them for kiosk-style deployments, troubleshooting and development.

Logging

Argument Description Values

--enable-file-logs

Enables logging into a file

--logs-period

Log rotation period

hourly / dayly

--logs-zip-days-period

After how many days logs are compressed

int, days

--logs-remove-days-period

After how many days logs are removed

int, days

--verbose-level

Verbosity level

int, 0–4

--super-logs

Extended logging of surface positions into the file

Window and geometry

Argument Description Values

--xpos

Player window X position

int, px

--ypos

Player window Y position

int, px

--width

Player window width

int, px

--height

Player window height

int, px

--rwidth

Real screen width

int, px

--rheight

Real screen height

int, px

--background-color

Player window background color

string

--fillmode

Default content fill mode in frames

fit / crop / stretch

--splashscreen

Enables the splash screen

--ontop-kills-taskbar

Always-on-top mode closes the taskbar (default: false)

--ontop-autohides-taskbar

Always-on-top mode auto-hides the taskbar (default: false)

--enable-window-update

Periodically re-raises the window on top

--window-update-period

Period of re-raising the window on top

int, msec

Video playback

Argument Description Values

--video-backend

Video backend (see Video codecs)

native / vlc / ffmpeg / mpv, default: native

--video-decoder

Hardware video decoder

DXVA / D3D11 / CUDA / FFMpeg, default: DXVA

--video-end-mode

What is shown when the ad slot is longer than the video

LAST_FRAME / BLACK / REPEAT

--video-preload-shift

Shift in video preload

int, ms

--opengl-backend

OpenGL backend

desktop / gles / software

--mpv-web

Enables/disables web content in the MPV backend (default: true)

true / false

--mpv-d3d11-flip

Enables d3d11-flip, disables transparent borders

--mpv-preload

Enables real MPV preload

--qml-images-smooth-disabled

Disables smoothing of images

--qml-images-mipmap-disabled

Disables mipmapping of images

Network

Argument Description Values

--proxy-type

Proxy connection type

none / http / socks

--proxy-url

Proxy server host

string

--proxy-port

Proxy server port

int

--proxy-user

Proxy server username

string

--proxy-pass

Proxy server password

string

Web content

Argument Description Values

--webdebug

Logs console messages of web content

--webpropsdebug

Logs injection of web properties

--web-reset-limit

Number of shows after which the web view is reinitialized

int

--web-video-frame

Uses the web engine for video playback

Single play and debugging

Argument Description Values

--singleplay

Enables single-play mode

--singleplaypath

Media path for single-play mode

file

--framesdebug

Colors frame backgrounds for debugging

--dev-package

Interactive ad debug mode: path to the ad folder

string

--inject-json

Debug mode: path to the injected JSON

string

--slot-duration

Debug mode: playback duration

int, ms

--preload-duration

Debug mode: preload duration

int, ms

--debug-remote-port

Debug mode: Chrome remote debugging port

int

The debug-mode arguments are described in detail in Interactive ads debug mode.

Environment variables

Variable Description Values

QT_PLAYER_SUPERLOGS

Extended logging of surface positions into the file

0/1

Keyboard shortcuts

Shortcut Function

kbd:[Ctrl+T]

Toggle the always-on-top mode