PRODUCTS
DOWNLOADS
SUPPORT
ZOOM PLAYER GUIDE
CONTACT

Command line parameters

Zoom Player's command line features are extensive, including everything from specifying which media files to play all the way to setting custom configuration profiles. When Zoom Player is already running, the command line parameters can still be used to trigger certain actions like switching to fullscreen on a specific monitor.

To open a media, simply specify a file name, file mask (e.g. "*.mp3") or URL.

The following command line parameters are supported:

/Z

Start in Zoom mode (/Z:2 will zoom on the second monitor).

/F

Start in Fullscreen mode (/F:2 will fullscreen on the second monitor).

/M

Start with the playback window minimized.

/Max

Start with the playback window maximized.

/FMax

Start with the Player set to fullscreen across all connected monitors.

/Q

Quit after playback completes (entire playlist).

/LockFS

Lock Zoom Player in Fullscreen mode (prevent exit to window mode).

/Media

Force Zoom Player to start in Media Mode.

/DVD

Force Zoom Player to start in DVD Mode.

/AudBar

Force Zoom Player to start in Audio Mode.

/CBar

Show the control bar on startup.

/Play

Auto-Play (if there is files in a previous Playlist or a disc in DVD Mode).

/CDPlay

Scan all drives for CD-Audio content and play.

/MainNav

Start Zoom Player within the Main home theater interface.

/LastNav

Start Zoom Player within the previously used home theater interface.

/FileNav

Start Zoom Player within the File home theater interface.

/PlayNav

Start Zoom Player within the Playlist home theater interface.

/MediaNav

Start Zoom Player within the Media Library's home theater interface's media list ("/MediaNav:MyAudio" will start with the "MyAudio" category).

/MediaCat

Start Zoom Player within the Media Library's home theater interface category list ("/MediaCat:MyVideo" will start in the "MyVideo" category selected).

/MediaFilter:[number]

Set the media library's filter mode, valid values are:

  1. ALL
  2. Movies
  3. TV Shows
  4. Videos
  5. Audio
  6. Pictures
  7. Executables

/MouseOff

Hide the Mouse Cursor on start.

/Close

Close any currently running instance of Zoom Player.

/TCP:[Port]

Start Zoom Player with TCP/IP interface enabled (/TCP:4096 will start Zoom Player with the TCP/IP server enabled on Port 4096).

/ConnectTCP:[address or IP]:[port]

By default, The TCP/IP interface works as a server by waiting for 3rd party applications to connect to Zoom Player.

With the "/ConnectTCP" parameter, Zoom Player initiates the connection itself with a local or remote server right as it launches. A server must be listening on the specified address and port for a connection from Zoom Player.

Example:
"zplayer.exe" /CONNECTTCP:127.0.0.1:4770

/InfoJSON

Query a running instance of Zoom Player for information. The results are returned in the windows clipboard as a UTF8 encoded JSON string.

This feature can be used in combination with Window's Powershell to monitor and control Zoom Player entirely through the command line, without requiring a TCP/IP connection to access the more advanced API.

Special characters are encoding using standard JSON character encoding.

If no additional parameters are specified, all fields are returned. To get specific results, you can use a combination of one or more of the following:

PlayState

A number representing the current play state where :

  1. Closed
  2. Stopped
  3. Paused
  4. Playing

MediaName

UTF8 string containing the playing file name or URL.

Title

UTF8 string containing the playing media's title.

Position

The playing position in seconds.

Duration

The playing duration in seconds.

PlayIndex

The current playlist play index.

Playlist

UTF8 string containing the current playlist, each media entry is specified as a part of a JSON array.

AudTrack

The current audio track number.

SubTrack

The current subtitle track number.

Example:

Get the playing media name, title, duration and position:
zplayer.exe /infojson:MediaName,Title,Duration,Position

/ShowOSD:[Text]

Show a pop-up OSD on an already running instance of Zoom Player.

/MultInst

Allows starting a new instance of Zoom Player even if Zoom Player is already running.

/Blank

Start Zoom Player with Video Blanking enabled.

/AR:[number]

Set specific video aspect ratio at run time.

  1. Disabled (fit to window)
  2. Source (pixel width / height)
  3. Derived (aspect ratio reported by media engine)
  4. Fullscreen (4:3)
  5. Widescreen (16:9)
  6. Anamorphic (corrects for badly encoded DVD source content)
  7. Custom (specified in Zoom Player's options)

Example:

"zplayer.exe" /ar:0 "myvideo.avi"

/PR:[number]

Set a fullscreen video positioning preset at run time. Note that this setting can't be used in combination with the "/F" parameter as they conflict, use "/Z" instead.

The number value can range from 0-9 and will set the numbered preset accordingly.

Example:

"zplayer.exe" /pr:3 "myvideo.avi

/PR:[number]

Set a color preset at run time. The number value can range from 0-9 and will set the numbered preset accordingly.

Example:

"zplayer.exe" /cpr:3 "myvideo.avi

/CD:[drive letter]

Set the active CD/DVD drive.

Example:

"zplayer.exe" /cd:F

/Eject:[drive letter]

Ejects the specified CD/DVD drive.

Example:

"zplayer.exe" /eject:F

/Rand:[0/1]

Disables/Enables Random Play (Shuffle Play). A Value of 0 disables Random Play while a value of 1 enables it.

Example:

"zplayer.exe" /rand:0

/Vol:[number]

Set Zoom Player's volume level on start-up. Value can be 0-100.

Example:

"zplayer.exe" /vol:75

/Speaker:[number]

The speaker parameter allows you to set the Windows Speaker setting temporarily (until Zoom Player exits), possible values are:

  1. Direct Out
  2. Headphone
  3. Mono
  4. Quad
  5. Stereo
  6. Surround
  7. 5.1
  8. 7.1

Example:

"zplayer.exe" /speaker:6

/Audio:[number]

Play a media with the specified Audio track enabled. Valid values are numbers from 0 onward (0 being the first audio track).

Example:

"zplayer.exe" /audio:2

/ExAudio:[filename/url]

Specify an external audio track file name or URL.

Example:

"zplayer.exe" "/exaudio:c:\media\audiotrack.mp3" "c:\media\myvideo.mp4"

/Sub:[number]

Play a media with a specified Subtitle track enabled. Valid values are numbers from 0 onward (0 being the first subtitle track).

Example:

"zplayer.exe" /sub:1

/Subtitle:[filename/url]

Specify an external subtitle track file name or URL.

Example:

"zplayer.exe" "/subtitle:c:\subs\myvideo.srt" "c:\media\myvideo.mp4"

/Referrer:[url]

Specifies a referrer header when opening a URL from the command line.

Example:

"zplayer.exe" "/referrer:https://website.com" "https://website.com/v.m3u8"

/UserAgent:[text]

Specifies a user-agent header when opening a URL from the command line.

Example:

"zplayer.exe" "/useragent:SpecialCode" "https://website.com/v.m3u8"

/DeInt:[0/1]

Enable/Disable DeInterlacing. A value of "0" = disabled and a value of "1" = enabled.

Example:

"zplayer.exe" /deint:1

/Seek:[HH]:[MM]:[SS]

Play a media file in a specified position, where HH = Hours, MM = Minutes and SS = Seconds.

Example:

"zplayer.exe" /seek:01:15:32

/Sort:[number]

Using the "/Sort" parameter you can have Zoom Player automatically sort the playlist prior to playing. The number represents the sorting type. Here are the possible values:

  1. Sort by File Name
  2. Sort by File Type (Extension)
  3. Sort by File Date
  4. Sort by File Size
  5. Sort by Folder Path and File Name
  6. Sort by Duration (Length) of Media
  7. Sort Randomly

Example:

"zplayer.exe" /sort:2

/Add:[path]

Add entire path/files to the playlist. If the path includes spaces, make sure to use quotes around the path.

Example:

"zplayer.exe" "/add:e:\my video files\"

/Queue:[path]

Queue path/files to the end of the playlist (when Zoom Player is already open). If the path includes spaces, make sure to use quotes around the path.

Example:

"zplayer.exe" "/queue:e:\my video files\"

/OpenDrive:[drive,drive,drive]

Open an entire drive or multiple drives for playback (VCD/SVCD/DVD/BluRay aware).

Example:

"zplayer.exe" /opendrive:e,f,g"

/Browse:[url]

Open the specified web address in the internal web browser.

Example:

"zplayer.exe" /browse:https://www.inmatrix.com

/SP:[0/1]

Turn the Smart Play feature ON/OFF (0=off, 1=on).

Example:

"zplayer.exe" /sp:1

/Clock:[number]

Set the media synchronization timer for DirectShow playback. Possible values are:

  1. Default (same as not using the parameter at all)
  2. Disables Synchronization entirely
  3. Sets Synchronization to the System Timer

Example:

"zplayer.exe" /clock:1

/Color:$[RGB Hex Value]

Set the user interface's skin-tint color by specifying an Red-Green-Blue HEX value.

Example:

"zplayer.exe" /color:$7F3000

/Config:[path]

Using this parameter, you can specify which local (non-registry) configuration file Zoom Player should use. This parameter is very useful when running multiple instances of Zoom Player, each with a different configuration. If the specified configuration file doesn't exist, Zoom Player will create one (using the default configuration).

Example:

"zplayer.exe" "/config:z:\path to config file\filename.local"

/DataPath:[path]

This parameter specifies which folder Zoom Player should use to store its data files. By default this folder is under the user's account when doing a Standard install or the Zoom Player folder when doing a legacy install.

Example:

"zplayer.exe" "/datapath:z:\temp\"

/WinName:[window name]

This parameter sets the Zoom Player window name (useful when running multiple instances and wanting to easily distinguish between each instance).

Example:

"zplayer.exe" "/winname:ZP Instance 2"

/Func:[function]

This parameter allows you to execute Zoom Player functions directly from the command line. This parameter can also be used while Zoom Player is running, enabling simple, command-line based automation.

Example:

"zplayer.exe" /func:fnMainNav

/ExFunc:[function,value]

This parameter allows you to execute Zoom Player extended functions directly from the command line. This parameter can also be used while Zoom Player is running, enabling simple, command-line based automation.

Example:

"zplayer.exe" /exfunc:exSetVolume,50

/nCols:[number]

This parameter allows you to divide the screen into a number of virtual columns later to be used with the "/Col" parameter.

Example:

"zplayer.exe" /nCols:2 /nRows:2 /Col:0 /Row:0

/nRows:[number]

This parameter allows you to divide the screen into a number of virtual rows later to be used with the "/Row" parameter.

Example:

"zplayer.exe" /nCols:2 /nRows:2 /Col:0 /Row:0

/Col:[number]

Once rows and columns have been set, this parameter sets which column the player interface should appear in (make sure the "/nCols" parameter proceeds the "/Col" parameter). Column numbering starts at "0", so the left-most column has a value of "0" and column "1" will appear to the right of it.

Example:

"zplayer.exe" /nCols:2 /nRows:2 /Col:0 /Row:0

/Row:[number]

Once rows and columns have been set, this parameter sets which row the player interface should appear in (make sure the "/nRows" parameter proceeds the "/Row" parameter). Row numbering starts at "0", so the top-most row has a value of "0" and row "1" will appear right below it.

Example:

"zplayer.exe" /nCols:2 /nRows:2 /Col:0 /Row:0

/SharePath:[path]

This Parameter sets the initial media sharing path. The share path value allows external applications to instruct Zoom Player to list and play media from the shared path folder from a remote location, using Zoom Player's TCP/IP API.

Example:

"zplayer.exe" "/SharePath:X:\Media Shares"

/StartPath:[path]

This Parameter allows you to set the initial path for the file-open dialog and the file browsing navigation interface. The file browse navigation interface will only accept network paths if they are pre-mapped as additional paths.

Example:

"zplayer.exe" "/StartPath:X:\Videos"

/Trailer:[filename]

Specify an alternate Trailer definition file.

Example:

"zplayer.exe" "/trailer:e:\my trailers\dts.trailers"

/DVBM:[filename]

Auto-load specified DVD Bookmark file.

Example:

"zplayer.exe" "e:\movie01\video_ts\video_ts.ifo" "/dvbm:c:\zplayer\DVD-Bookmarks\DVDVOLUME.2E662BB6D20F0ECF\start.chp"

/Key:[filename]

Specify a Media Mode keyboard file.

Example:

"zplayer.exe" "/key:c:\program files\zoom player\mykeymedia.key"

/KeyDVD:[filename]

Specify a DVD Mode keyboard file.

Example:

"zplayer.exe" "/keydvd:c:\program files\zoom player\mykeydvd.key"

/R:(Width,Height,ColorBits,RefreshRate,Monitor)

Set specific video resolution at run time. There are no validity checks being done on the values you use in this parameters, so make sure not to enter values that your monitor does not support. Also, make sure not to put any spaces between the entries! As you can see from the samples, the Monitor parameter is optional.

Example #1 :

"zplayer.exe /R:(1024,768,16,85) myvideo.avi"

Example #2 :

"zplayer.exe /R:(1600,1280,32,75,2) myvideo.avi"

/SkinMedia:[path]

Set the Media Mode skin file. The path can either be a full path to the skin file, or it can be a partial path with the skin folder automatically filled in.

Example, full path :

"zplayer.exe" "/skinmedia:c:\Program Files (x86)\Zoom Player\Skin\AlbaHD\AlbaHD.skn"

Example, partial path :

"zplayer.exe" "/skinmedia:AlbaHD\AlbaHD.skn"

/SkinAudio:[path]

Set the Audio Mode skin file. The path can either be a full path to the skin file, or it can be a partial path with the skin folder automatically filled in.

Example, full path :

"zplayer.exe" "zplayer.exe" "/skinmedia:c:\Program Files (x86)\Zoom Player\Skin\AlbaHD\AlbaHDAudio.skn"

Example, partial path :

"zplayer.exe" "/skinmedia:AlbaHD\AlbaHDAudio.skn"

/SkinDVD:[path]

Set the DVD Mode skin file. The path can either be a full path to the skin file, or it can be a partial path with the skin folder automatically filled in.

Example, full path :

"zplayer.exe" "/skindvd:c:\Program Files (x86)\Zoom Player\Skin\AlbaHD\AlbaHDDVD.skn"

Example, partial path :

"zplayer.exe" "/skindvd:AlbaHD\AlbaHDDVD.skn"

/X:[number]

Set the playback Window's X-Position in pixels within Windows virtual desktop space (supports multiple monitors).

/Y:[number]

Set the playback Window's Y-Position in pixels within Windows virtual desktop space (supports multiple monitors).

/W:[number]

Set the playback Window's width in pixels.

/W:[number]

Set the playback Window's width in pixels.

/VX:[number]

Set the playback video X-Position in pixels while in fullscreen mode (0 = left screen edge).

/VY:[number]

Set the playback video X-Position in pixels while in fullscreen mode (0 = top screen edge).

/VW:[number]

Set the playback video width in pixels while in fullscreen mode.

/VH:[number]

Set the playback video height in pixels while in fullscreen mode).