The Command Line: Difference between revisions
No edit summary |
No edit summary |
||
(29 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
Media Center can be controlled by command line parameters sent |
Media Center and Media Jukebox can be controlled by command line parameters sent using a command launcher. The launcher is installed during installation of main application. The command launcher is version-specific, and installed in the standard system directory. The name of the command launcher for Media Center follows the (case-insensitive) form: |
||
<code>'''MC'''''<MC version>'''''.exe'''</code> |
|||
* Media Center 13 - '''mc13.exe''' |
|||
* Media Center 12 - '''mc12.exe''' |
|||
* Media Center 11 - '''mc11.exe''' |
|||
* Media Jukebox 12 - '''mj12.exe''' |
|||
* Media Jukebox - '''mjextman.exe''' |
|||
and for Media Jukebox version 12 and beyond: |
|||
'''NOTE:''' replace all instances of '''mc14.exe''' in this document with the appropriate command launcher for your version. Also, note that the command launcher for the particular application version you are using is '''not''' located in the application installation directory (inside <tt>C:\Program Files\</tt> for example) but is instead found in your standard system directory. This is often found at <tt>C:\WINDOWS\system32\</tt> for most Windows installations. However, because the System directory would normally be found in your system's "path" it is not normally necessary to specify the full path when calling the command launcher. |
|||
<code>'''MJ'''''<MJ version>'''''.exe'''</code> |
|||
==Execute Parameters== |
|||
Executing mc14.exe with one of the following command line parameters first starts Media Center if it is not already running. |
|||
and finally, prior to version 12 of Media Jukebox, the launcher is named: |
|||
===Playback Execute Parameters=== |
|||
'''mc14.exe [''item'']|[''item'']...''' If playback is currently stopped, Playing Now is replaced with the item(s) and playback starts, otherwise the item(s) are appended to Playing Now and playback jumps to the first specified item. |
|||
<code>'''mjextman.exe'''</code> |
|||
'''mc14.exe /Append [''item'']|[''item'']...''' Appends item(s) to Playing Now without changing the current playback state. |
|||
Notes |
|||
'''mc14.exe /AudioCD''' |
|||
* The text that follows in this document will assume the usage of '''mc20.exe''', the launcher for Media Center 20. Use the appropriate command for your version of Media Center or Media Jukebox. mc27.exe, for example. |
|||
* The command launcher is installed into the system directory, typically <tt>C:\WINDOWS\system32\</tt> (it does not reside in the application directory). Because the system directory is normally included in your system's PATH variable, it is not necessary to specify the full path when invoking the command launcher. |
|||
'''mc14.exe /Clear [mode]''' Removes all files from Playing Now and stops playback. |
|||
==Command Line Options and Parameters== |
|||
:The only available [mode] is: |
|||
Executing '''{{monospace|mc21.exe}}''' with one of the following command line options / parameters first starts Media Center if it is not already running (exception; see '''/Command''' below). |
|||
:* '''DontRemoveCurrent''' Does not remove the currently playing file and does not stop playback. |
|||
Some options in the table below accept a parameter ''<paths>'', which is a list of one or more paths to files and/or folders, each item separated by a '''|''' (vertical bar, or pipe). |
|||
'''mc14.exe /Close''' Closes Media Center. |
|||
Some options in the table below accept a parameter ''<playitems>'', which is a list of one or more items, each item separated by a '''|''' (vertical bar, or pipe). Through the text, each item in ''<playitems>'' can be any of the following: |
|||
'''mc14.exe /Connect m01p://[ip address or host name]''' Establishes a connection to the specified remote Media Server. |
|||
:* A filename: Example: '''C:\song1.mp3''' |
|||
:* A URL: Example: '''http:\\www.somewebsite.com\station.pls''' |
|||
:* A location within the Organization Tree: Example: '''TREEPATH=Playlists\Playlist1''' |
|||
:: The '''TREEPATH='''''<location>'''''\'''''<item>'' specification is case-sensitive for ''<location>'' and ''<item>'' and the hierarchy separator is '''\''' (backslash). |
|||
:* A device under CD & DVD and Handhelds: Example: '''DEVICE=G:''' |
|||
Each item in ''<playitems>'' may be targeted to a specific Zone by appending the item with '''Zone='''''<x>'', where ''<x>'' is replaced by the Zone number (Media Center 10 or later). Example: |
|||
'''mc14.exe /DVDVideo''' |
|||
:<tt>mc21.exe /Append C:\1.mp3|C:\2.mp3|Zone=3</tt> |
|||
'''mc14.exe /ExportToXML''' |
|||
---- |
|||
'''mc14.exe /Import [filename]''' Imports the specified file into the Media Center library and launches Media Center. |
|||
{| border="1" cellpadding="3" cellspacing="0" |
|||
|+ align="top" | '''''Media Center Command Line Options and Parameters''''' |
|||
!Option !! Parameter !! Description |
|||
|- |
|||
| /Append || ''<playitems>'' || Appends item(s) to Playing Now without changing the current playback state. |
|||
|- |
|||
| /AudioCD || ''<drive>'' || Plays the audio CD specified in drive ''<drive>'' (e.g.. '''D:'''). |
|||
|- |
|||
| /Bluray || ''<drive>'' || Plays a Blu-ray disc specified in drive ''<drive>'' (e.g.. '''F:'''). Currently functionally equivalent to the /DVDInfo option. |
|||
|- |
|||
| /Clear || ''<mode>'' || Removes all files from Playing Now and stops playback. |
|||
:Values for ''<mode>'' : |
|||
'''mc14.exe /ImportAndPlay''' |
|||
:* '''DontRemoveCurrent''' Does not remove the currently playing file and does not stop playback. |
|||
|- |
|||
| /Close || || Closes Media Center. |
|||
|- |
|||
| rowspan="18" | /Command |
|||
| colspan="2" | '''Note 1:''' The /Command option has no effect if Media Center is not already running.<br /> |
|||
'''Note 2:''' The /Command ''<subcmd>'' form is considered deprecated starting with 18.0.117; use the direct option instead (e.g. /Pause instead of /Command Pause). |
|||
|- |
|||
| FastForward || See /FastForward. |
|||
|- |
|||
| Mute || See /Mute. |
|||
|- |
|||
| Next || See /Next. |
|||
|- |
|||
| NextAlbum || See /NextAlbum. |
|||
|- |
|||
| NextArtist || See /NextArtist. |
|||
|- |
|||
| Pause || See /Pause. |
|||
|- |
|||
| Play || See /Play. |
|||
|- |
|||
| Previous || See /Previous. |
|||
|- |
|||
| PreviousAlbum || See /PreviousAlbum. |
|||
|- |
|||
| PreviousArtist || See /PreviousArtist. |
|||
|- |
|||
| Rewind || See /Rewind. |
|||
|- |
|||
| Stop || See /Stop. |
|||
|- |
|||
| ToggleShuffle || See /ToggleShuffle. |
|||
|- |
|||
| ToggleContinuous || See /ToggleContinuous. |
|||
|- |
|||
| VolumeUp ''<percent>'' || See /VolumeUp. |
|||
|- |
|||
| style="white-space:nowrap" | VolumeDown ''<percent>'' || See /VolumeDown. |
|||
|- |
|||
| VolumeSet ''<percent>'' || See /VolumeSet. |
|||
|- |
|||
| /Connect || m01p://''<host>'' || Establishes a connection to ''<host>'', a hostname or IP address that specifies the remote Media Server. |
|||
|- |
|||
| /DVDVideo || ''<drive>'' || Plays a DVD specified in drive ''<drive>'' (e.g.. '''E:'''). Currently functionally equivalent to the /Bluray option. |
|||
|- |
|||
| /ExportToXML || ''<filename>'' || Exports the current library as XML (in the MPL format) to the specified file ''<filename>''. If the program is not running, the command is performed silently, and the program exits. |
|||
|- |
|||
| /FastForward || || Jumps 5 seconds forward. See Note 1. |
|||
|- |
|||
| /Import || ''<paths>'' || Imports the specified files/folders into the Media Center library and launches Media Center. |
|||
|- |
|||
| /ImportAndPlay || ''<paths>'' || Same command as /Import, but also starts playback of the imported files (this replaces Playing Now).. |
|||
|- |
|||
| /Library || ''<library name>'' || Changes to the library specified by ''<library name>'' (Media Center 12.0.384 and later). |
|||
|- |
|||
| /LibraryReadOnly || || Starts Media Center with the library in read-only mode (aka. Party Mode). |
|||
|- |
|||
| /MCC || style="white-space:nowrap" | ''<command>'',''<param>'' || Sends the specified Media Center Core Command to Media Center. |
|||
:''<command>'' is one of the [[Media_Center_Core_Commands|Media Center Core Commands]]. |
|||
'''mc14.exe /Library [Library Name]''' Changes to the library specified by '''[Library Name]''' (Media Center 12.0.384 and later). |
|||
:''<param>'' is optional, and defaults to 0. |
|||
'''mc14.exe /LibraryReadOnly''' Starts Media Center with the library read only (Party Mode). |
|||
:Note: Only available in Media Center. |
|||
'''mc14.exe /MCC [command],[param]''' Sends the specified Media Center Core Command to Media Center. |
|||
|- |
|||
|/MCWS/v1/... || || MCWS web service call (does not require Media Network to be running or a server to be listening). Use double-quotes around entire command (e.g. "/MCWS/v1/Playback/Pause?State=-1"). |
|||
|- |
|||
| /MediaServer || || Starts Media Center in Media Server mode (without a UI). |
|||
|- |
|||
| /Mime || || Used by some Stores. |
|||
|- |
|||
| /Mode || ''<modename>'' || Sets the Media Center mode to ''<modename>''. Media Center will be started if it is not running. |
|||
:Select ''<modename>'' from one of the following: |
|||
:[command] is one of the [[Media_Center_Core_Commands|Media Center Core Commands]]. |
|||
:* '''Standard''' Standard View |
|||
:* '''Megame''' Standard View, apparently the same as using '''Standard''', or simply defaults to Standard View |
|||
:[param] is optional, and defaults to 0. |
|||
:* '''Windowed''' Display View, at the window size previously used. Not forced to full screen. |
|||
:* '''Fullscreen''' Display View, shown full screen by default. |
|||
:Note: These are only available in Media Center. |
|||
:* '''Mini''' Mini View |
|||
'''mc14.exe /MediaServer''' Starts Media Center in Media Server mode (without a UI). |
|||
'''mc14.exe /Mime''' |
|||
'''mc14.exe /Mode [modename]''' If Media Center is not currently running, this starts Media Center in the specified mode, otherwise this switches Media Center to the specified mode. |
|||
:[modename] can be one of the following: |
|||
:* '''Standard, Megame, or Windowed''' Standard View |
|||
:* '''Minime''' Mini View |
|||
:* '''Fullscreen''' Display View |
|||
:* '''Theater''' Theater View |
:* '''Theater''' Theater View |
||
:Note: An empty |
:Note: An empty ''<modename>'' is the same as the user's chosen startup mode if Media Center is not running, or Standard if it is already running. |
||
|- |
|||
| /MonitorExtend || || Extend available displays across all monitors (Windows 7). |
|||
'''mc14.exe /Play [''item'']|[''item'']...''' If playback is currently stopped, Playing Now is replaced with the item(s) and playback starts, otherwise the item(s) are appended to Playing Now and playback jumps to the first specified item. |
|||
|- |
|||
| /MonitorSwitch || ''<monspecs>'' || Select, enable and disable monitors and resolution for playback. Use /MonitorSwitch without arguments for usage information. The format of ''<monspecs>'' is one or more of: |
|||
'''mc14.exe /PlayReplace [''item'']|[''item'']...''' Playing Now is replaced with the item(s) and playback starts. |
|||
:Each [''item''] can be one of the following: |
|||
:* A filename: '''C:\song1.mp3''' |
|||
:* A URL: '''http:\\www.somewebsite.com\station.pls''' |
|||
:* A location within the Organization Tree: '''TREEPATH=Playlists\Playlist1''' |
|||
:* A device under CD & DVD and Handhelds: '''DEVICE=G:''' |
|||
:Note: The TREEPATH=''Location''\''Item'' specification is case-sensitive for ''Location'' and ''Item'' and the hierarchy separator is \. |
|||
:Note: For Media Center 10 or greater, the Playback Execute Parameters can be issued to a specific Zone by adding '''Zone=x''' as one of the items in the | delimited list. e.g. "mc14.exe /Append C:\1.mp3|C:\2.mp3|Zone=3". |
|||
'''mc14.exe /Power''' Starts Media Center if it's not running, or closes it if it is. |
|||
'''mc14.exe /Protocol''' |
|||
'''mc14.exe /Replace''' |
|||
'''mc14.exe /SilentImport [filename]''' Imports the specified file into Media Center library but does not launch Media Center. |
|||
'''mc14.exe /Start''' Starts Media Center or brings it to top. |
|||
'''mc14.exe /Subscribe''' subscribe to a podcast. |
|||
==Command Parameters== |
|||
Executing mc14.exe with one of the following command line parameters will only control an already running instance of Media Center. If Media Center is not already running, the following commands are ignored. |
|||
'''mc14.exe /Command Play''' Starts playback of the selected track(s). |
|||
'''mc14.exe /Command Pause''' Toggles between play and pause states. |
|||
'''mc14.exe /Command Stop''' Stops playback. |
|||
'''mc14.exe /Command Next''' Skips to the next track. |
|||
'''mc14.exe /Command Previous''' Skips to the previous track. |
|||
'''mc14.exe /Command FastForward''' Jumps 5 seconds forward. |
|||
'''mc14.exe /Command Rewind''' Jumps 5 seconds backward. |
|||
'''mc14.exe /Command Mute''' Mutes the sound. |
|||
'''mc14.exe /Command VolumeUp [value]''' Increases the sound volume by [value]. |
|||
:Note: [value] defaults to 5%. |
|||
''<device>''''':'''enable<br /> |
|||
'''mc14.exe /Command VolumeDown [value]''' Decreases the sound volume by [value]. |
|||
''<device>''''':'''disable<br /> |
|||
:Note: [value] defaults to 5%. |
|||
''<device>''''':'''''<width>'''''x'''''<height>'''''x'''<''bit depth>'''''x'''''<refresh>''['''xprimary'''] |
|||
|- |
|||
| /MonitorToggle || || Switch between the connected displays (Windows 7). |
|||
|- |
|||
| /Mute || || Mutes the sound. See Note 1. |
|||
|- |
|||
| /Next || || Skips to the next track. See Note 1. |
|||
|- |
|||
| /NextAlbum || || Skips forward to the next album. See Note 1. |
|||
|- |
|||
| /NextArtist || || Skips forward to the next artist. See Note 1. |
|||
|- |
|||
| /Pause || || Toggles between play and pause states. See Note 1. |
|||
|- |
|||
| /Play || ''<playitems>'' || If playback is currently stopped, Playing Now is replaced with the item(s) and playback starts, otherwise the item(s) are appended to Playing Now and playback jumps to the first specified item. Note: The option '''/Play''' may be omitted, in which case, take care to use double quotes as necessary when issuing commands in the Windows command shell. If ''<playitems>'' is empty, starts playback of the selected track(s), but see Note 1. |
|||
|- |
|||
| /PlayReplace || ''<playitems>'' || Playing Now is replaced with the item(s) and playback starts (same as /Replace). |
|||
|- |
|||
| /PlayNext || ''<playitems>'' || Playing Now has the files added as the next to play. |
|||
|- |
|||
| /Power || || Media Center is started when it is not currently running, or closed when running. |
|||
|- |
|||
| /Previous || || Skips back to the previous track. See Note 1. |
|||
|- |
|||
| /PreviousAlbum || || Skips back to the first listed track of the previous album. See Note 1. |
|||
|- |
|||
| /PreviousArtist || || Skips back to the previous artist (the topmost track of a sequential group by the previous artist). See Note 1. |
|||
|- |
|||
| /Protocol || ''<command>'' || Executes the specified protocol command ''<command>'', where the web browser subsequently runs ''<command>''. This option is used primarily for embedding commands into webpages (e.g. mc19://ShowHelp/Import). |
|||
|- |
|||
| /Replace || ''<playitems>'' || Playing Now is replaced with the item(s) and playback starts (same as /PlayReplace). |
|||
|- |
|||
| /Restart || || Restarts Media Center. |
|||
|- |
|||
| /Rewind || || Jumps 5 seconds backward. See Note 1. |
|||
|- |
|||
| /ShowTreePath || ''<treepath>'' || Starts Media Center if necessary, and changes the tree selection to the specified ''<treepath>''. |
|||
|- |
|||
| /SilentImport || ''<paths>'' || Imports (silently) the specified files/folders into the Media Center library, but does not launch Media Center. |
|||
|- |
|||
| /Sleep || ''<milliseconds>'' || Sleeps the specified number of ''<milliseconds>'' and then exits; supports delays in scripting. |
|||
|- |
|||
| /SoundcardSwitch || ''<cardspec>'' || Select sound card for playback (Windows 7/Vista). Use /SoundcardSwitch without arguments for usage information. The format of ''<cardspec>'' is: |
|||
DefaultByIndex:''<sound card index>''<br /> |
|||
'''mc14.exe /Command VolumeSet [value]''' Sets the sound volume directly to [value]. |
|||
|- |
|||
:Note: [value] defaults to 50%. |
|||
| /Start || || Starts Media Center or brings it to top. |
|||
|- |
|||
| /StartAfterDelay || ''<milliseconds>'' || Launches Media Center after the specified number of ''milliseconds''. |
|||
|- |
|||
| /Stop || || Stops playback. See Note 1. |
|||
|- |
|||
| /Subscribe || ''<podcast URL>'' || Subscribe to the podcast specified by ''<podcast URL>''. |
|||
|- |
|||
| /ToggleShuffle || || Toggles shuffle mode. See Note 1. |
|||
|- |
|||
| /ToggleContinuous || || Toggles continuous mode. See Note 1. |
|||
|- |
|||
| /VolumeUp ''<percent>'' || || Increases the sound volume by ''<percent>'' percent. Default: 5%. See Note 1. |
|||
|- |
|||
| style="white-space:nowrap" | /VolumeDown ''<percent>'' || || Decreases the sound volume by ''<percent> percent''. Default: 5%. See Note 1. |
|||
|- |
|||
| /VolumeSet ''<percent>'' || || Sets the sound volume directly to ''<percent>'' percent. Default: 50%. See Note 1. |
|||
|} |
|||
==Examples== |
|||
'''mc14.exe /Command ToggleShuffle''' Toggles shuffle mode |
|||
* Start playing the current track (if Media Center is running) |
|||
: <tt>mc20.exe /Play</tt> |
|||
* Play file.flac, launching Media Center if necessary. |
|||
: <tt>mc20.exe /Play "C:\path\to\file.flac"</tt> |
|||
* Import file.mp3 and start playback. |
|||
: <tt>mc20.exe /ImportAndPlay "C:\path\to\file.mp3"</tt> |
|||
* Silently import the files contained in folder1 and folder2. |
|||
: <tt>mc20.exe /SilentImport "C:\path\to\folder1|M:\path\to\folder2"</tt> |
|||
* Play the Not Recently Played smartlist. |
|||
: <tt>MC20.exe /Play TREEPATH="Playlists\Smartlists\Not Recently Played"</tt> |
|||
* Set the tree focus to Audio\Files, starting Media Center if necessary. |
|||
: <tt>MC20.exe /ShowTreePath "Audio\Files"</tt> |
|||
[[Category:Developer|Command Line]] |
|||
'''mc14.exe /Command ToggleContinuous''' Toggles continuous mode |
|||
[[Category:Frequently Asked Questions|Command Line]] |
Latest revision as of 12:26, 7 June 2021
Media Center and Media Jukebox can be controlled by command line parameters sent using a command launcher. The launcher is installed during installation of main application. The command launcher is version-specific, and installed in the standard system directory. The name of the command launcher for Media Center follows the (case-insensitive) form:
MC<MC version>.exe
and for Media Jukebox version 12 and beyond:
MJ<MJ version>.exe
and finally, prior to version 12 of Media Jukebox, the launcher is named:
mjextman.exe
Notes
- The text that follows in this document will assume the usage of mc20.exe, the launcher for Media Center 20. Use the appropriate command for your version of Media Center or Media Jukebox. mc27.exe, for example.
- The command launcher is installed into the system directory, typically C:\WINDOWS\system32\ (it does not reside in the application directory). Because the system directory is normally included in your system's PATH variable, it is not necessary to specify the full path when invoking the command launcher.
Command Line Options and Parameters
Executing mc21.exe with one of the following command line options / parameters first starts Media Center if it is not already running (exception; see /Command below).
Some options in the table below accept a parameter <paths>, which is a list of one or more paths to files and/or folders, each item separated by a | (vertical bar, or pipe).
Some options in the table below accept a parameter <playitems>, which is a list of one or more items, each item separated by a | (vertical bar, or pipe). Through the text, each item in <playitems> can be any of the following:
- A filename: Example: C:\song1.mp3
- A URL: Example: http:\\www.somewebsite.com\station.pls
- A location within the Organization Tree: Example: TREEPATH=Playlists\Playlist1
- The TREEPATH=<location>\<item> specification is case-sensitive for <location> and <item> and the hierarchy separator is \ (backslash).
- A device under CD & DVD and Handhelds: Example: DEVICE=G:
Each item in <playitems> may be targeted to a specific Zone by appending the item with Zone=<x>, where <x> is replaced by the Zone number (Media Center 10 or later). Example:
- mc21.exe /Append C:\1.mp3|C:\2.mp3|Zone=3
Option | Parameter | Description |
---|---|---|
/Append | <playitems> | Appends item(s) to Playing Now without changing the current playback state. |
/AudioCD | <drive> | Plays the audio CD specified in drive <drive> (e.g.. D:). |
/Bluray | <drive> | Plays a Blu-ray disc specified in drive <drive> (e.g.. F:). Currently functionally equivalent to the /DVDInfo option. |
/Clear | <mode> | Removes all files from Playing Now and stops playback.
|
/Close | Closes Media Center. | |
/Command | Note 1: The /Command option has no effect if Media Center is not already running. Note 2: The /Command <subcmd> form is considered deprecated starting with 18.0.117; use the direct option instead (e.g. /Pause instead of /Command Pause). | |
FastForward | See /FastForward. | |
Mute | See /Mute. | |
Next | See /Next. | |
NextAlbum | See /NextAlbum. | |
NextArtist | See /NextArtist. | |
Pause | See /Pause. | |
Play | See /Play. | |
Previous | See /Previous. | |
PreviousAlbum | See /PreviousAlbum. | |
PreviousArtist | See /PreviousArtist. | |
Rewind | See /Rewind. | |
Stop | See /Stop. | |
ToggleShuffle | See /ToggleShuffle. | |
ToggleContinuous | See /ToggleContinuous. | |
VolumeUp <percent> | See /VolumeUp. | |
VolumeDown <percent> | See /VolumeDown. | |
VolumeSet <percent> | See /VolumeSet. | |
/Connect | m01p://<host> | Establishes a connection to <host>, a hostname or IP address that specifies the remote Media Server. |
/DVDVideo | <drive> | Plays a DVD specified in drive <drive> (e.g.. E:). Currently functionally equivalent to the /Bluray option. |
/ExportToXML | <filename> | Exports the current library as XML (in the MPL format) to the specified file <filename>. If the program is not running, the command is performed silently, and the program exits. |
/FastForward | Jumps 5 seconds forward. See Note 1. | |
/Import | <paths> | Imports the specified files/folders into the Media Center library and launches Media Center. |
/ImportAndPlay | <paths> | Same command as /Import, but also starts playback of the imported files (this replaces Playing Now).. |
/Library | <library name> | Changes to the library specified by <library name> (Media Center 12.0.384 and later). |
/LibraryReadOnly | Starts Media Center with the library in read-only mode (aka. Party Mode). | |
/MCC | <command>,<param> | Sends the specified Media Center Core Command to Media Center.
|
/MCWS/v1/... | MCWS web service call (does not require Media Network to be running or a server to be listening). Use double-quotes around entire command (e.g. "/MCWS/v1/Playback/Pause?State=-1"). | |
/MediaServer | Starts Media Center in Media Server mode (without a UI). | |
/Mime | Used by some Stores. | |
/Mode | <modename> | Sets the Media Center mode to <modename>. Media Center will be started if it is not running.
|
/MonitorExtend | Extend available displays across all monitors (Windows 7). | |
/MonitorSwitch | <monspecs> | Select, enable and disable monitors and resolution for playback. Use /MonitorSwitch without arguments for usage information. The format of <monspecs> is one or more of:
<device>:enable |
/MonitorToggle | Switch between the connected displays (Windows 7). | |
/Mute | Mutes the sound. See Note 1. | |
/Next | Skips to the next track. See Note 1. | |
/NextAlbum | Skips forward to the next album. See Note 1. | |
/NextArtist | Skips forward to the next artist. See Note 1. | |
/Pause | Toggles between play and pause states. See Note 1. | |
/Play | <playitems> | If playback is currently stopped, Playing Now is replaced with the item(s) and playback starts, otherwise the item(s) are appended to Playing Now and playback jumps to the first specified item. Note: The option /Play may be omitted, in which case, take care to use double quotes as necessary when issuing commands in the Windows command shell. If <playitems> is empty, starts playback of the selected track(s), but see Note 1. |
/PlayReplace | <playitems> | Playing Now is replaced with the item(s) and playback starts (same as /Replace). |
/PlayNext | <playitems> | Playing Now has the files added as the next to play. |
/Power | Media Center is started when it is not currently running, or closed when running. | |
/Previous | Skips back to the previous track. See Note 1. | |
/PreviousAlbum | Skips back to the first listed track of the previous album. See Note 1. | |
/PreviousArtist | Skips back to the previous artist (the topmost track of a sequential group by the previous artist). See Note 1. | |
/Protocol | <command> | Executes the specified protocol command <command>, where the web browser subsequently runs <command>. This option is used primarily for embedding commands into webpages (e.g. mc19://ShowHelp/Import). |
/Replace | <playitems> | Playing Now is replaced with the item(s) and playback starts (same as /PlayReplace). |
/Restart | Restarts Media Center. | |
/Rewind | Jumps 5 seconds backward. See Note 1. | |
/ShowTreePath | <treepath> | Starts Media Center if necessary, and changes the tree selection to the specified <treepath>. |
/SilentImport | <paths> | Imports (silently) the specified files/folders into the Media Center library, but does not launch Media Center. |
/Sleep | <milliseconds> | Sleeps the specified number of <milliseconds> and then exits; supports delays in scripting. |
/SoundcardSwitch | <cardspec> | Select sound card for playback (Windows 7/Vista). Use /SoundcardSwitch without arguments for usage information. The format of <cardspec> is:
DefaultByIndex:<sound card index> |
/Start | Starts Media Center or brings it to top. | |
/StartAfterDelay | <milliseconds> | Launches Media Center after the specified number of milliseconds. |
/Stop | Stops playback. See Note 1. | |
/Subscribe | <podcast URL> | Subscribe to the podcast specified by <podcast URL>. |
/ToggleShuffle | Toggles shuffle mode. See Note 1. | |
/ToggleContinuous | Toggles continuous mode. See Note 1. | |
/VolumeUp <percent> | Increases the sound volume by <percent> percent. Default: 5%. See Note 1. | |
/VolumeDown <percent> | Decreases the sound volume by <percent> percent. Default: 5%. See Note 1. | |
/VolumeSet <percent> | Sets the sound volume directly to <percent> percent. Default: 50%. See Note 1. |
Examples
- Start playing the current track (if Media Center is running)
- mc20.exe /Play
- Play file.flac, launching Media Center if necessary.
- mc20.exe /Play "C:\path\to\file.flac"
- Import file.mp3 and start playback.
- mc20.exe /ImportAndPlay "C:\path\to\file.mp3"
- Silently import the files contained in folder1 and folder2.
- mc20.exe /SilentImport "C:\path\to\folder1|M:\path\to\folder2"
- Play the Not Recently Played smartlist.
- MC20.exe /Play TREEPATH="Playlists\Smartlists\Not Recently Played"
- Set the tree focus to Audio\Files, starting Media Center if necessary.
- MC20.exe /ShowTreePath "Audio\Files"