Command Line Interface (CLI)

The command line interface can be executed as an alternative application. The CLI is used to process a single action defined by the given command line options. The general command line format is:

cli [<options>]* <command> [<command parameters>]*

cli is a wrapper script, delivered in the platform specific shell script format of currently installed operating system (*.sh for Linux, *.cmd for Windows). The script calls the eezUPnP executable with modified parameters to execute the CLI application.

options:
--timeout=<seconds>
The maximum number of seconds to wait for finishing the defined command. If the command couldn't be executed before the timeout happens then the command is canceled. The default timeout is 30sec.

commands:
--scan It's recommended to increase the default timeout to at least 45sec. For every found device multiple lines are logged:
  • The name of device and some more human readable information to identify the device.
  • The Unique Device Name (UDN): This is an identifier starting with "uuid:". This identifier must be used for several other commands expecting the UDN as source or target identifier.
  • The type of device: must be "Server" to be usable as source and "Player" for targets.
--stop <UDN> A STOP command can be send without error also to an device that is nothing playing...
<UDN> The UDN of player device (see --scan command) to stop.
--streamURL <URL> <UDN>
<URL> The URL pointing to the stream to play.
<UDN> The UDN of player device (see --scan command) to stream to.

URL's for resources are displayed in the Info-Popup dialog opened by an click on the information-icon in the server or player list of tracks.