PRODUCTS
DOWNLOADS
SUPPORT
ZOOM PLAYER GUIDE
CONTACT


Zoom Player can accept a file name or file mask as a command line parameter and then play it.

You can also specify the following switches:

/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 Minimized

/Max -Start 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-Start in Media Mode

/AudBar -Start Zoom Player in Audio Mode (Audio Bar)

/CBar -Show the control bar on startup.

/DVD -Force-Start in DVD Mode

/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 fullscreen navigation interface.

/LastNav -Start Zoom Player within the previously used fullscreen navigation interface.

/FileNav -Start Zoom Player within the File fullscreen navigation interface

/PlayNav -Start Zoom Player within the Playlist fullscreen navigation interface

/MediaNav -Start Zoom Player within the Media Library's fullscreen navigation interface file list ("/MEDIANAV:MyAudio" will start with the "MyAudio" category file list)

/MediaCat -Start Zoom Player within the Media Library's fullscreen navigation interface category list ("/MEDIACAT:MyVideo" will start in the "MyVideo" category selected)

/MediaFilter:[Number] -Set the media library's filter mode, valid values are:
0 = ALL
1 = Movies
2 = TV Shows
3 = Videos
4 = Audio
5 = Pictures
6 = 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 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: "c:\program files\zplayer\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
                0 : Closed
                1 : Stopped
                2 : Paused
                3 : 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 to 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 -Start a new instance of Zoom Player even if Zoom Player is already running

/Blank -Start Zoom Player with Video Blanking enabled

/AR:[n] - Set specific aspect ratio at run time.

Value "[n]" can currently be 0-6, where 0 is the first Aspect Ratio setting (fit to window) and 6 is the last Aspect Ratio setting (Custom).

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

/PR:[n] - Set a 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.
Value "[n]" can range from 0-9 and will set the preset accordingly.

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

/CPR:[n] - Set a color preset at run time.
Value "[n]" can range from 0-9 and will set the 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:[n] - Set the Zoom Player volume level on start-up. Value can be 0-100.
Example:
"zplayer.exe" /vol:75

/Speaker:[n] - This parameter allows you to set the Windows Speaker setting temporarily (until Zoom Player exits), possible values are:
0 - Direct Out
1 - Headphone
2 - Mono
3 - Quad
4 - Stereo
5 - Surround
6 - 5.1
7 - 7.1

Example:
"zplayer.exe" /speaker:6

/Audio:[n] - Play a media file with a specified Audio Track enabled. "n" is a number from 0 onwards (0 being the first audio track).
Example:
"zplayer.exe" /audio:2

/Sub:[n] - Play a media file with a specified Subtitle Track enabled. "n" is a number from 0 onwards (0 being the first subtitle track).
Example:
"zplayer.exe" /sub:1

/DeInt:[n] - Enable/disable DeInterlacing where 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:[n] - Using the "/SORT:[n]" parameter you can have Zoom Player automatically sort the playlist prior to playing. "[n]" is a numerical figure specifying the type of source. Here is a list of the possible values:
  • 0 - Sort by File Name
  • 1 - Sort by File Type (Extension)
  • 2 - Sort by File Date
  • 3 - Sort by File Size
  • 4 - Sort by Folder Path and File Name
  • 5 - Sort by Duration (Length) of Media
  • 6 - Sort Randomly
Example:
"zplayer.exe" /sort:2

"/Add:[path]" - Add entire path/file to the playlist.
Example:
"c:\program files\zplayer\zplayer.exe" "/add:e:\my video files\"

Notice the "", if this parameter isn't encased, spaces in the given path would be considered a different parameter.

"/Queue:[path]" - Queue path/file into the playlist (when Zoom Player is already open).
Example:
"c:\program files\zplayer\zplayer.exe" "/queue:e:\my video files\"

Notice the "", if this parameter isn't encased, spaces in the given path would be considered a different parameter.

"/OpenDrive:[drive,drive,drive]" - Open an entire drive for playback (VCD/SVCD/DVD aware).
Example:
"c:\program files\zplayer\zplayer.exe" /opendrive:e

You can also use this parameter to open multiple drives:
"c:\program files\zplayer\zplayer.exe" /opendrive:e,f,g

"/Browse:[URL]" - Open the specified web address in the internal web browser.
Example:
"c:\program files\zplayer\zplayer.exe" /browse:https://www.inmatrix.com

"/SP:[0 or 1]" - Turn Smart Play ON/OFF (0=off, 1=on).
Example:
"c:\program files\zplayer\zplayer.exe" /sp:1

"/Clock:[n]" - Set the media synchronization timer for DirectShow playback.
Possible values are:
0 - Default (same as not using the parameter at all)
1 - Disables Synchronization entirely
2 - Sets Synchronization to the System Timer

Example:
"c:\program files\zplayer\zplayer.exe" /clock:1

"/Color:$[RGB Hex Value]" - The Color command line passes an RGB Tinting value for the user interface Skin.
Example:
"c:\program files\zplayer\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:
"c:\program files\zplayer\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:
"c:\program files\zplayer\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:
"c:\program files\zplayer\zplayer.exe" "/winname:ZP Instance 2"

"/Func:[function]" - This parameter allows you to instruct Zoom Player to execute functions directly from the command line.
This parameter can also be used while Zoom Player is running, enabling simple command-line based automation.
Example:
"c:\program files\zplayer\zplayer.exe" /func:fnMainNav

"/ExFunc:[function,value]" - This parameter allows you to instruct Zoom Player to execute 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 for always starting with the Playlist Editor open:
"c:\program files\zplayer\zplayer.exe" /exfunc:exInterface,2

"/nCols:[value]" - This parameter allows you to divide the screen into a number of virtual columns later to be used with the "/Col" parameter.
Example:
"c:\program files\zplayer\zplayer.exe" /nCols:2 /nRows:2 /Col:0 /Row:0

"/nRows:[value]" - This parameter allows you to divide the screen into a number of virtual rows later to be used with the "/Row" parameter.
Example:
"c:\program files\zplayer\zplayer.exe" /nCols:2 /nRows:2 /Col:0 /Row:0

"/Col:[value]" - 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:
"c:\program files\zplayer\zplayer.exe" /nCols:2 /nRows:2 /Col:0 /Row:0

"/Row:[value]" - 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:
"c:\program files\zplayer\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:
"c:\program files\zplayer\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:
"c:\program files\zplayer\zplayer.exe" "/StartPath:X:\Videos"

"/Trailer:[filepath]" - Specify an alternate Trailer definition file.
Example:
"c:\program files\zplayer\zplayer.exe" "/trailer:e:\my trailers\dts.trailers"

Notice the "", if this parameter isn't encased, spaces in the given path would be considered a different parameter.

"/DVBM:[filepath]" - Auto-load specified DVD Bookmark file.
Example:
"c:\program files\zplayer\zplayer.exe" "e:\movie01\video_ts\video_ts.ifo" "/dvbm:c:\zplayer\DVD-Bookmarks\DVDVOLUME.2E662BB6D20F0ECF\start.chp"

"/Key:[filepath]" - Specify a Media Mode keyboard file.
Example:
"c:\program files\zplayer\zplayer.exe" "/key:c:\program files\zoom player\mykeymedia.key"

Notice the "", if this parameter isn't encased, spaces in the given path would be considered a different parameter.

"/KeyDVD:[filepath]" - Specify a DVD Mode keyboard file.
Example:
"c:\program files\zplayer\zplayer.exe" "/keydvd:c:\program files\zoom player\mykeydvd.key"

Notice the "", if this parameter isn't encased, spaces in the given path would be considered a different parameter.

/R:(Width,Height,ColorBits,RefreshRate,Monitor) - Set specific video resolution at run time.
Example: "zplayer.exe /R:(1024,768,16,85) myvideo.avi"
Example: "zplayer.exe /R:(1600,1280,32,75,2) myvideo.avi"

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.

/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:
"zplayer.exe" "/skinmedia:c:\Program Files\Zoom Player\Skin\Fusion\Fusion.skn"

Partial path Example:
"zplayer.exe" "/skinmedia:Fusion\Fusion.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:
"zplayer.exe" "/skinmedia:c:\Program Files\Zoom Player\Skin\Fusion\FusionAudio.skn"

Partial path Example:
"zplayer.exe" "/skinmedia:Fusion\FusionAudio.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:
"zplayer.exe" "/skindvd:c:\Program Files\Zoom Player\Skin\Fusion\FusionDVD.skn"

Partial path Example:
"zplayer.exe" "/skindvd:Fusion\FusionDVD.skn"

/X:[n] -Force GUI Window X-Position
/Y:[n] -Force GUI Window Y-Position
/W:[n] -Force GUI Window Width
/H:[n] -Force GUI Window Height
/VX:[n] -Set Video Window X-Offset (in zoom mode)
/VY:[n] -Set Video Window Y-Offset (in zoom mode)
/VW:[n] -Set Video Window Width (in zoom mode)
/VH:[n] -Set Video Window Height (in zoom mode)