The Command Line: Difference between revisions

From wiki.jriver.com
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
Media Center can be controlled by command line parameters.
Media Center can be controlled by command line parameters sent to the appropriate command launcher:
* Media Jukebox - '''mjextman.exe'''
* Media Center 11 - '''mc11.exe'''
* Media Center 12 - '''mc12.exe'''


Note: replace mc12.exe in this document with the appropriate command for your version.
''Execute'' parameters start Media Center if it is not already running.

''Control'' parameters are ignored if Media Center is not currently running.

If using Media Jukebox, the command to use is ''mjextman.exe'', for Media Center, ''MC11.exe'' or ''MC12.exe''. This document uses ''MC12.exe''.


==Execute Parameters==
==Execute Parameters==
Executing MC12.exe with one of the following parameters starts Media Center if it is not already running.
Executing mc12.exe with one of the following command line parameters first starts Media Center if it is not already running.


===Playback Execute Parameters===
===Playback Execute Parameters===
'''MC12.exe [''item1''|''item2''|...]''' 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.
'''mc12.exe [''item1''|''item2''|...]''' 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.


'''MC12.exe /Play [''item1''|''item2''|...]''' 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.
'''mc12.exe /Play [''item1''|''item2''|...]''' 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.


'''MC12.exe /Append [''item1''|''item2''|...]''' Appends item(s) to Playing Now without changing the current playback state.
'''mc12.exe /Append [''item1''|''item2''|...]''' Appends item(s) to Playing Now without changing the current playback state.


'''MC12.exe /PlayReplace [''item1''|''item2''|...]''' Playing Now is replaced with the item(s) and playback starts.
'''mc12.exe /PlayReplace [''item1''|''item2''|...]''' Playing Now is replaced with the item(s) and playback starts.


Each ''item'' can be one of the following:
Each ''item'' can be one of the following:
Line 27: Line 26:
Note: The TREEPATH=''Location''\''Item'' specification is case-sensitive for ''Location'' and ''Item'' and the hierarchy separator is \.
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. "MC12.exe /Append C:\1.mp3|C:\2.mp3|Zone=3".
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. "mc12.exe /Append C:\1.mp3|C:\2.mp3|Zone=3".


===Media Core Command Execute Parameters===
===Media Core Command Execute Parameters===
These are only available in Media Center.
These are only available in Media Center.


'''MC12.exe /MCC [command],[param]''' Sends the specified Media Core Command to Media Center.
'''mc12.exe /MCC [command],[param]''' Sends the specified Media Core Command to Media Center.


[command] is one of the Media Core Commands listed [[Media_Center_Core_Commands|here]].
[command] is one of the Media Core Commands listed [[Media_Center_Core_Commands|here]].
Line 39: Line 38:


===Other Execute Parameters===
===Other Execute Parameters===
'''MC12.exe /Import [filename]''' Imports the specified file into the Media Center library and launches Media Center.
'''mc12.exe /Import [filename]''' Imports the specified file into the Media Center library and launches Media Center.


'''MC12.exe /Connect m01p://[ip address or host name]''' Establishes a connection to the specified remote Media Server.
'''mc12.exe /Connect m01p://[ip address or host name]''' Establishes a connection to the specified remote Media Server.


'''MC12.exe /SilentImport [filename]''' Imports the specified file into Media Center library but does not launch Media Center.
'''mc12.exe /SilentImport [filename]''' Imports the specified file into Media Center library but does not launch Media Center.


'''MC12.exe /Clear [mode]''' If [mode] is DontRemoveCurrent, all files except the currently playing file are removed from Playing Now and playback continues, otherwise all files are removed from Playing Now and playback is stopped.
'''mc12.exe /Clear [mode]''' If [mode] is DontRemoveCurrent, all files except the currently playing file are removed from Playing Now and playback continues, otherwise all files are removed from Playing Now and playback is stopped.


'''MC12.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.
'''mc12.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:
[modename] can be one of the following:
Line 57: Line 56:
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.
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.


'''MC12.exe /Start''' Starts Media Center or brings it to top.
'''mc12.exe /Start''' Starts Media Center or brings it to top.


'''MC12.exe /Close''' Closes Media Center.
'''mc12.exe /Close''' Closes Media Center.


'''MC12.exe /Power''' Starts Media Center if it's not running, or closes it if it is.
'''mc12.exe /Power''' Starts Media Center if it's not running, or closes it if it is.


==Command Parameters==
==Command Parameters==
Executing MC12.exe with one of the following parameters controls an already running instance of Media Center. If Media Center is not running, the following commands are ignored.
Executing mc12.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.


'''MC12.exe /Command Play''' Starts playback of the selected track(s).
'''mc12.exe /Command Play''' Starts playback of the selected track(s).


'''MC12.exe /Command Pause''' Toggles between play and pause states.
'''mc12.exe /Command Pause''' Toggles between play and pause states.


'''MC12.exe /Command Stop''' Stops playback.
'''mc12.exe /Command Stop''' Stops playback.


'''MC12.exe /Command Next''' Skips to the next track.
'''mc12.exe /Command Next''' Skips to the next track.


'''MC12.exe /Command Previous''' Skips to the previous track.
'''mc12.exe /Command Previous''' Skips to the previous track.


'''MC12.exe /Command FastForward''' Jumps 5 seconds forward.
'''mc12.exe /Command FastForward''' Jumps 5 seconds forward.


'''MC12.exe /Command Rewind''' Jumps 5 seconds backward.
'''mc12.exe /Command Rewind''' Jumps 5 seconds backward.


'''MC12.exe /Command Mute''' Mutes the sound.
'''mc12.exe /Command Mute''' Mutes the sound.


'''MC12.exe /Command VolumeUp [value]''' Increases the sound volume by [value]. Default is 5%
'''mc12.exe /Command VolumeUp [value]''' Increases the sound volume by [value]. Default is 5%


'''MC12.exe /Command VolumeDown [value]''' Decreases the sound volume by [value]. Default by 5%
'''mc12.exe /Command VolumeDown [value]''' Decreases the sound volume by [value]. Default by 5%


'''MC12.exe /Command VolumeSet [value]''' Sets the sound volume directly to [value]. If [value] is not specified 50% is used.
'''mc12.exe /Command VolumeSet [value]''' Sets the sound volume directly to [value]. If [value] is not specified 50% is used.


'''MC12.exe /Command ToggleShuffle''' Toggles shuffle mode
'''mc12.exe /Command ToggleShuffle''' Toggles shuffle mode


'''MC12.exe /Command ToggleContinuous''' Toggles continuous mode
'''mc12.exe /Command ToggleContinuous''' Toggles continuous mode

Revision as of 20:12, 28 September 2007

Media Center can be controlled by command line parameters sent to the appropriate command launcher:

  • Media Jukebox - mjextman.exe
  • Media Center 11 - mc11.exe
  • Media Center 12 - mc12.exe

Note: replace mc12.exe in this document with the appropriate command for your version.

Execute Parameters

Executing mc12.exe with one of the following command line parameters first starts Media Center if it is not already running.

Playback Execute Parameters

mc12.exe [item1|item2|...] 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.

mc12.exe /Play [item1|item2|...] 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.

mc12.exe /Append [item1|item2|...] Appends item(s) to Playing Now without changing the current playback state.

mc12.exe /PlayReplace [item1|item2|...] 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. "mc12.exe /Append C:\1.mp3|C:\2.mp3|Zone=3".

Media Core Command Execute Parameters

These are only available in Media Center.

mc12.exe /MCC [command],[param] Sends the specified Media Core Command to Media Center.

[command] is one of the Media Core Commands listed here.

[param] is optional, and defaults to 0.

Other Execute Parameters

mc12.exe /Import [filename] Imports the specified file into the Media Center library and launches Media Center.

mc12.exe /Connect m01p://[ip address or host name] Establishes a connection to the specified remote Media Server.

mc12.exe /SilentImport [filename] Imports the specified file into Media Center library but does not launch Media Center.

mc12.exe /Clear [mode] If [mode] is DontRemoveCurrent, all files except the currently playing file are removed from Playing Now and playback continues, otherwise all files are removed from Playing Now and playback is stopped.

mc12.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, Windowed Standard View
  • Minime Mini View
  • Fullscreen Display View
  • Theater Theater View

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.

mc12.exe /Start Starts Media Center or brings it to top.

mc12.exe /Close Closes Media Center.

mc12.exe /Power Starts Media Center if it's not running, or closes it if it is.

Command Parameters

Executing mc12.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.

mc12.exe /Command Play Starts playback of the selected track(s).

mc12.exe /Command Pause Toggles between play and pause states.

mc12.exe /Command Stop Stops playback.

mc12.exe /Command Next Skips to the next track.

mc12.exe /Command Previous Skips to the previous track.

mc12.exe /Command FastForward Jumps 5 seconds forward.

mc12.exe /Command Rewind Jumps 5 seconds backward.

mc12.exe /Command Mute Mutes the sound.

mc12.exe /Command VolumeUp [value] Increases the sound volume by [value]. Default is 5%

mc12.exe /Command VolumeDown [value] Decreases the sound volume by [value]. Default by 5%

mc12.exe /Command VolumeSet [value] Sets the sound volume directly to [value]. If [value] is not specified 50% is used.

mc12.exe /Command ToggleShuffle Toggles shuffle mode

mc12.exe /Command ToggleContinuous Toggles continuous mode

Retrieved from "https://wiki.jriver.com/index.php?title=The_Command_Line&oldid=4331"