Run Play ISR from the Command Line

Play ISR can be run and configured from the command line. This page provides you with the specific commands supported by the player, followed by a few examples of how to use these commands on your OS.

Settings configured using the command line are not saved beyond the current session. To ensure settings will persist in future launches of Play ISR, configurations and settings must be adjusted and saved manually from the settings area of the application. See Access the Play ISR Settings.

OS Differences

When using standard installation methods for macOS and Windows, the Play ISR application is accessed with slight differences.

macOS

On macOS, the Play ISR application is installed by dragging the application into the Applications folder at the root of the primary drive at /Applications. The executable for Play ISR is available to be launched from the macOS terminal (or equivalent) at:

CODE

/Applications/Play\ ISR.app/Contents/MacOS/Play\ ISR

Aliases can be created manually as needed within macOS for the current user.

Windows

On Windows, the Play ISR application as installed by the MSIX package into the protected WindowsApps folder within the system’s Program Files directory. The application is given the execution_alias of playisr within the MSIX installer package.

The playisr alias can be used from the cmd.exe or powershell terminal applications.

Linux

No explicit package or installer is provided for the Linux runtime environment at this time. It is left to the user to place the installer at a desired location within the Linux distribution of choice, and create relevant aliases to suit the use case.

Supported command line parameters

The commands supported include:

Name	Option	Description
Help	`-h` `--help`	Print help.
Version	`--version`	Print the version of Play ISR.
Input	`-i` `--input-url=<URL>`	Specify the input url for playback. Supports SRT and UDP URL’s. Supports local file paths.
Latency Buffer	`-l`	Set the input latency buffer for network streams.
Audio	`--disable-audio`	Explicitly disable audio decoding. Useful in removing intrinsic buffering used to synchronize audio-video playback and lower overall latency in video-only ISR scenarios.
Audio Volume	`--volume`	Set the playback volume of the primary audio channel. [0..100]

Open UDP Stream Example

Windows

CODE

playisr -i udp://234.5.5.5:8208

Linux

CODE

/path/to/PlayISR -i udp://234.5.5.5:8208

MacOS

CODE

/Applications/Play\ ISR.app/Contents/MacOS/Play\ ISR -i udp://234.5.5.5:8202

Tune for low latency example

Windows

CODE

playisr -i udp://234.5.5.5:8208 --disable-audio -l 20

Linux

CODE

/path/to/PlayISR -i udp://234.5.5.5:8208 --disable-audio -l 20

MacOS

CODE

/Applications/Play\ ISR.app/Contents/MacOS/Play\ ISR -i udp://234.5.5.5:8202 --disable-audio -l 20