Media Center Core Commands: Difference between revisions

From wiki.jriver.com
Jump to navigation Jump to search
 
(51 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{see also|DevZone}}
== Introduction ==

MC Core Commands are used to control various aspects of Media Center via software or command line.
MC Core Commands are used to control various aspects of Media Center via software or command line.
Each command consists of a name (or number), followed by an optional parameter which selects or specifies the particular command behavior.
Each command consists of a name (or number), followed by an optional parameter which selects or specifies the particular command behavior.


The full, C++ header is available here:
The MC Core Commands in the tables below have been auto-generated from the file MCCommands.h and should be accurate as of:
MCCommands.h: 2012-09-26
MC Version: 18.0.50
The full, C++ header is available here (18.0.127):
[http://www.jriver.com/DevZone/MCCommands.h JRiver Media Core Commands Header File]
[http://www.jriver.com/DevZone/MCCommands.h JRiver Media Core Commands Header File]


Line 13: Line 11:
* Commands have changed over time; use the Wiki's page history to see previous versions of this page. Some commands may only work with the latest version of Media Center.
* Commands have changed over time; use the Wiki's page history to see previous versions of this page. Some commands may only work with the latest version of Media Center.


== How To Issue Media Core Commands ==
= How To Issue Media Core Commands =


Look up the command name / number and its parameter in the tables below. For example, the command to toggle between play and pause is MCC_PLAY_PAUSE. It has command number (enum value) 10000 and its accompanying parameter is ignored. Some '''MCC''' commands may be targeted a particular Zone - see [[#Specifying Zones|Specifying Zones]].
Look up the command name / number and its parameter in the tables below. For example, the command to toggle between play and pause is MCC_PLAY_PAUSE. It has command number (enum value) 10000 and its accompanying parameter is ignored. Some '''MCC''' commands may be targeted a particular Zone - see [[#Specifying Zones|Specifying Zones]].


=== Issuing a command from the command line ===
== Issuing a command from the command line ==
Assuming you are familiar with the first section of [[The_Command_Line|The Command Line]], the general syntax for issuing an MCC command from the Windows command line (or equivalent) is:
Assuming you are familiar with the first section of [[The_Command_Line|The Command Line]], the general syntax for issuing an MCC command from the Windows command line (or equivalent) is:


<code>'''MC'''''<version>'''''.exe''' '''/MCC''' ''<command number>''''', '''''<parameter>''</code>
<code>'''MC'''''<version>'''''.exe''' '''/MCC''' ''<command number>''''','''''<parameter>''</code>


'''Note''': Command ''numbers'' must be used; command ''names'' are not used on the command line.
'''Note''': Command ''numbers'' must be used; command ''names'' are not used on the command line.


Example: To toggle between play and pause in MC16, use the command:
Example: To toggle between play and pause in MC16, use the command:
MC16.exe /MCC 10000, 0
MC18.exe /MCC 10000,0


Note: The '''MCC''' commands can be entered in Vista and Windows 7 directly into ''Search Files and Programs'' under the Windows Start menu, or as commands in a Windows command shell, which can be launched in Vista and Windows 7 by entering '''cmd.exe''' in ''Search Files and Programs'' under the Windows Start menu. It is available under the Accessories menu as ''Command Prompt'' in previous versions of Windows.
Note: The '''MCC''' commands can be entered in Vista and Windows 7 directly into ''Search Files and Programs'' under the Windows Start menu, or as commands in a Windows command shell, which can be launched in Vista and Windows 7 by entering '''cmd.exe''' in ''Search Files and Programs'' under the Windows Start menu. It is available under the Accessories menu as ''Command Prompt'' in previous versions of Windows.



=== Issuing a command from C++ ===
On Mac:
<code>'''/Applications/Media\ Center\ ''<version>''.app/Contents/MacOS/Launcher.app/Contents/MacOS/Launcher''' '''/MCC''' ''<command number>''''','''''<parameter>''</code>


On Linux:
<code>'''/usr/lib/jriver/MC''<version>''/mc''<version>''''' '''/MCC''' ''<command number>''''','''''<parameter>''</code>

== Issuing a command from C++ ==
The calling syntax for posting a WM_MC_COMMAND -based message to the MC frame is demonstrated in the example below.
The calling syntax for posting a WM_MC_COMMAND -based message to the MC frame is demonstrated in the example below.


Line 41: Line 47:




==MC Commands==


=MC Commands=
The MCC commands table below was auto-generated on 2013-02-01 from the latest MCCommands.h (18.0.127) file posted above.


The MCC commands table and defines below were auto-generated on 2014-06-09 from the latest MCCommands.h (19.0.138) file posted above.
==MC Commands Table==



===Playback===
===Playback===
Line 60: Line 70:
<td id="10002">10002</td><td>MCC_STOP</td><td>bool bDisplayError</td>
<td id="10002">10002</td><td>MCC_STOP</td><td>bool bDisplayError</td>
</tr><tr>
</tr><tr>
<td id="10003">10003</td><td>MCC_NEXT</td><td>bool bNotActualNext</td>
<td id="10003">10003</td><td>MCC_NEXT</td><td>int nFlags (1: bNotActualNext, 2: bNoChapters)</td>
</tr><tr>
</tr><tr>
<td id="10004">10004</td><td>MCC_PREVIOUS</td><td>ignore</td>
<td id="10004">10004</td><td>MCC_PREVIOUS</td><td>int nFlags (1: reserved, 2: bNoChapters, 4: no seek to beginning)</td>
</tr><tr>
</tr><tr>
<td id="10005">10005</td><td>MCC_SHUFFLE</td><td>0: toggle shuffle mode; 1: shuffle, jump to PN; 2: shuffle, no jump; 3: off; 4: on; 5:automatic</td>
<td id="10005">10005</td><td>MCC_SHUFFLE</td><td>0: toggle shuffle mode; 1: shuffle, jump to PN; 2: shuffle, no jump; 3: off; 4: on; 5:automatic</td>
Line 130: Line 140:
<td id="10037">10037</td><td>MCC_DETACH_DISPLAY</td><td>bool bDetach (-1 toggles)</td>
<td id="10037">10037</td><td>MCC_DETACH_DISPLAY</td><td>bool bDetach (-1 toggles)</td>
</tr><tr>
</tr><tr>
<td id="10038">10038</td><td>MCC_SET_MODE_ZONE_SPECIFIC</td><td>UI_MODES Mode</td>
<td id="10038">10038</td><td>MCC_SET_MODE_ZONE_SPECIFIC</td><td>[[#UI_MODES|UI_MODES mode]]</td>
</tr><tr>
</tr><tr>
<td id="10039">10039</td><td>MCC_STOP_INTERNAL</td><td>ignore</td>
<td id="10039">10039</td><td>MCC_STOP_INTERNAL</td><td>ignore</td>
Line 148: Line 158:
<td id="10046">10046</td><td>MCC_HANDLE_PLAYBACK_ERROR</td><td>ignore</td>
<td id="10046">10046</td><td>MCC_HANDLE_PLAYBACK_ERROR</td><td>ignore</td>
</tr><tr>
</tr><tr>
<td id="10047">10047</td><td>MCC_PLAY_AUTOMATIC_PLAYLIST</td><td>ignore</td>
<td id="10047">10047</td><td>MCC_PLAY_AUTOMATIC_PLAYLIST</td><td>BSTR bstrSeed (deleted by receiver)</td>
</tr><tr>
</tr><tr>
<td id="10048">10048</td><td>MCC_SEEK</td><td>int nPositionMilliseconds</td>
<td id="10048">10048</td><td>MCC_SEEK</td><td>int nPositionMilliseconds</td>
Line 173: Line 183:
</tr><tr>
</tr><tr>
<td id="10059">10059</td><td>MCC_SKIP_TO</td><td>SKIP_TO_MODES Mode</td>
<td id="10059">10059</td><td>MCC_SKIP_TO</td><td>SKIP_TO_MODES Mode</td>
</tr><tr>
<td id="10060">10060</td><td>MCC_LINK_ZONE</td><td>int nZoneID</td>
</tr><tr>
<td id="10061">10061</td><td>MCC_UNLINK_ZONE</td><td>ignore</td>
</tr><tr>
<td id="10062">10062</td><td>MCC_PLAY_RADIO_MEDIANET</td><td>ignore</td>
</tr><tr>
<td id="10063">10063</td><td>MCC_CLEAR_PLAYED_ZONE_SPECIFIC</td><td>ignore</td>
</tr><tr>
<td id="10064">10064</td><td>MCC_PLAY_LAST_TV_CHANNEL</td><td>ignore</td>
</tr><tr>
<td id="10065">10065</td><td>MCC_BLURAY_POPUP_MENU</td><td>ignore</td>
</tr><tr>
<td id="10066">10066</td><td>MCC_PLAY_SYNCED_CPLDB_INDEX</td><td>int nIndex</td>
</tr><tr>
<td id="10067">10067</td><td>MCC_STOP_AFTER_DELAY</td><td>int nMinutes (negative value for hard stop)</td>
</tr><tr>
<td id="10068">10068</td><td>MCC_STOP_AFTER_TRACKS</td><td>int nNumberTracks (negative one to reset)</td>
</tr><tr>
<td id="10069">10069</td><td>MCC_PLAY_SELECTED</td><td>0: play replace, 1: append, 2: play next</td>
</tr><tr>
<td id="10070">10070</td><td>MCC_PLAY_AUTO_PLAYLIST_CLOUD</td><td>BSTR: seed</td>
</tr><tr>
<td id="10071">10071</td><td>MCC_CLEAR_REMAINING_ZONE_SPECIFIC</td><td>ignore</td>
</tr><tr>
<td id="10072">10072</td><td>MCC_SEEK_PERCENT</td><td>int nPercent</td>
</tr><tr>
<td id="10073">10073</td><td>MCC_SHUFFLE_ALBUMS</td><td>ignore</td>
</tr><tr>
<td id="10074">10074</td><td>MCC_JRVR_PROFILE_OUTPUT</td><td>Profile ID (-1: Default Profile, -2: Auto Select Profile)</td>
</tr><tr>
<td id="10075">10075</td><td>MCC_JRVR_PROFILE_SCALING</td><td>Profile ID (-1: Default Profile, -2: Auto Select Profile)</td>
</tr><tr>
<td id="10076">10076</td><td>MCC_JRVR_PROFILE_FILTERING</td><td>Profile ID (-1: Default Profile, -2: Auto Select Profile)</td>
</tr><tr>
<td id="10077">10077</td><td>MCC_JRVR_PROFILE_ADVANCED</td><td>Profile ID (-1: Default Profile, -2: Auto Select Profile)</td>
</tr><tr>
<td id="10078">10078</td><td>MCC_CLOSE_PROGRAM_AFTER_STOP</td><td>0: no, 1: yes, -1: toggle</td>
</tr><tr>
<td id="10079">10079</td><td>MCC_ZONE_SWITCH_ENABLE</td><td>0: no, 1: yes, -1: toggle</td>
</tr><tr>
<td id="10080">10080</td><td>MCC_JRVR_DEFAULT_PROFILE_OUTPUT</td><td>int ProfileID</td>
</tr><tr>
<td id="10081">10081</td><td>MCC_JRVR_DEFAULT_PROFILE_SCALING</td><td>int ProfileID</td>
</tr><tr>
<td id="10082">10082</td><td>MCC_JRVR_DEFAULT_PROFILE_FILTERING</td><td>int ProfileID</td>
</tr><tr>
<td id="10083">10083</td><td>MCC_JRVR_DEFAULT_PROFILE_ADVANCED</td><td>int ProfileID</td>
</tr><tr>
<td id="10084">10084</td><td>MCC_HIDE_DSP_STUDIO</td><td>ignore</td>
</tr><tr>
<td id="10085">10085</td><td>MCC_SET_DSP_STUDIO_PLAYBACK_RATE</td><td>Non-zero integers for percent of normal speed, negative values mute audio</td>
</tr><tr>
<td id="10086">10086</td><td>MCC_RESTART_PLAYBACK_WITH_RATE</td><td>new playback rate</td>
</tr>
</tr>
</table>
</table>
Line 205: Line 269:
<td id="20010">20010</td><td>MCC_EXPORT_LIBRARY</td><td>ignore</td>
<td id="20010">20010</td><td>MCC_EXPORT_LIBRARY</td><td>ignore</td>
</tr><tr>
</tr><tr>
<td id="20011">20011</td><td>MCC_BACKUP_LIBRARY</td><td>ignore</td>
<td id="20011">20011</td><td>MCC_BACKUP_LIBRARY</td><td>int nMode (0: normal, 1: silent automatic backup)</td>
</tr><tr>
</tr><tr>
<td id="20012">20012</td><td>MCC_RESTORE_LIBRARY</td><td>ignore</td>
<td id="20012">20012</td><td>MCC_RESTORE_LIBRARY</td><td>ignore</td>
Line 247: Line 311:
<td id="20031">20031</td><td>MCC_DISCONNECT_LIBRARY</td><td>ignore</td>
<td id="20031">20031</td><td>MCC_DISCONNECT_LIBRARY</td><td>ignore</td>
</tr><tr>
</tr><tr>
<td id="20032">20032</td><td>MCC_SYNC_WITH_LIBRARY_SERVER</td><td>ignore</td>
<td id="20032">20032</td><td>MCC_SYNC_WITH_LIBRARY_SERVER</td><td>bool bSilent</td>
</tr><tr>
</tr><tr>
<td id="20033">20033</td><td>MCC_STOP_ALL_ZONES</td><td>bool bStopRemoteZones</td>
<td id="20033">20033</td><td>MCC_STOP_ALL_ZONES</td><td>bool bStopRemoteZones</td>
Line 254: Line 318:
</tr><tr>
</tr><tr>
<td id="20035">20035</td><td>MCC_OPEN_LIVE</td><td>ignore</td>
<td id="20035">20035</td><td>MCC_OPEN_LIVE</td><td>ignore</td>
</tr><tr>
<td id="20036">20036</td><td>MCC_PLAY_RADIO_PARADISE</td><td>ignore</td>
</tr><tr>
<td id="20037">20037</td><td>MCC_IMPORT_ITUNES</td><td>ignore</td>
</tr><tr>
<td id="20038">20038</td><td>MCC_PLAY_RADIO_JRIVER</td><td>int nStationNumber</td>
</tr><tr>
<td id="20039">20039</td><td>MCC_EXPORT_ALL_TO_ITUNES</td><td>ignore</td>
</tr><tr>
<td id="20040">20040</td><td>MCC_IMPORT_ITUNES_DATABASE</td><td>ignore</td>
</tr><tr>
<td id="20041">20041</td><td>MCC_SET_CROSS_PLATFORM_RULES</td><td>ignore</td>
</tr><tr>
<td id="20042">20042</td><td>MCC_DOWNLOAD_FROM_LIBRARY_SERVER</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 329: Line 407:
</tr><tr>
</tr><tr>
<td id="21032">21032</td><td>MCC_PASTE_TAGS</td><td>ignore</td>
<td id="21032">21032</td><td>MCC_PASTE_TAGS</td><td>ignore</td>
</tr><tr>
<td id="21033">21033</td><td>MCC_SHUFFLE_SELECTION</td><td>ignore</td>
</tr><tr>
<td id="21034">21034</td><td>MCC_CLOSE_QUICK_SEARCH</td><td>ignore</td>
</tr><tr>
<td id="21035">21035</td><td>MCC_ADD_ZONE_GROUP</td><td>ignore</td>
</tr><tr>
<td id="21036">21036</td><td>MCC_COMBINE</td><td>int nPlaylistID</td>
</tr><tr>
<td id="21037">21037</td><td>MCC_ADD_DYNAMIC_ZONE</td><td>ignore</td>
</tr><tr>
<td id="21038">21038</td><td>MCC_PLAYLIST_SEARCH</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 339: Line 429:
<th>Enum</th><th>Command</th><th>Parameter</th>
<th>Enum</th><th>Command</th><th>Parameter</th>
</tr><tr>
</tr><tr>
<td id="22000">22000</td><td>MCC_TOGGLE_MODE</td><td>-1: Next Mode, 0: Standard, 1: Mini, 2: Display, 3: Theater View, 4: Cover View</td>
<td id="22000">22000</td><td>MCC_TOGGLE_MODE</td><td>[[#UI_MODES|UI_MODES mode]]</td>
</tr><tr>
</tr><tr>
<td id="22001">22001</td><td>MCC_THEATER_VIEW</td><td>0:Toggle, 1:Home, 2:Playing Now, 3:Audio, 4:Images, 5:Video, 6:Playlists, 7:CD & DVD, 8:TV</td>
<td id="22001">22001</td><td>MCC_THEATER_VIEW</td><td>0: Toggle, 1: Home, 2: Playing Now, 3: Audio, 4: Images, 5: Video, 6: Playlists, 7: CD & DVD, 8: TV, 9: TV Guide, 10: TV Recordings, 12: Netflix</td>
</tr><tr>
</tr><tr>
<td id="22002">22002</td><td>MCC_PARTY_MODE</td><td>ignore</td>
<td id="22002">22002</td><td>MCC_PARTY_MODE</td><td>ignore</td>
</tr><tr>
</tr><tr>
<td id="22003">22003</td><td>MCC_SHOW_TREE_ROOT</td><td>int nTreeRootIndex</td>
<td id="22003">22003</td><td>MCC_SHOW_TREE_ROOT</td><td>-1: Toggle, 0: Hide, 1: Show</td>
</tr><tr>
</tr><tr>
<td id="22004">22004</td><td>MCC_FIND_MEDIA</td><td>wchar * pstrSearch (note: memory will be deleted by receiver)</td>
<td id="22004">22004</td><td>MCC_FIND_MEDIA</td><td>wchar * pstrSearch (note: memory will be deleted by receiver)</td>
Line 357: Line 447:
<td id="22008">22008</td><td>MCC_SET_LIST_STYLE</td><td>int nListStyle (-1 toggles)</td>
<td id="22008">22008</td><td>MCC_SET_LIST_STYLE</td><td>int nListStyle (-1 toggles)</td>
</tr><tr>
</tr><tr>
<td id="22009">22009</td><td>MCC_SET_MODE</td><td>-3: Current Mode (update settings), -2: Close Display, -1: Next Mode, 0: Standard, 1: Mini, 2: Display, 3: Theater View, 4: Cover View</td>
<td id="22009">22009</td><td>MCC_SET_MODE</td><td>[[#UI_MODES|UI_MODES mode]]</td>
</tr><tr>
</tr><tr>
<td id="22010">22010</td><td>MCC_OBSOLETE_22010</td><td>ignore</td>
<td id="22010">22010</td><td>MCC_OBSOLETE_22010</td><td>ignore</td>
Line 371: Line 461:
<td id="22015">22015</td><td>MCC_SET_MEDIA_MODE</td><td>int nMediaMode</td>
<td id="22015">22015</td><td>MCC_SET_MEDIA_MODE</td><td>int nMediaMode</td>
</tr><tr>
</tr><tr>
<td id="22016">22016</td><td>MCC_CONFIGURE_ACCESS_CONTROL</td><td>ignore</td>
<td id="22016">22016</td><td>MCC_OBSOLETE_22016</td><td>ignore</td>
</tr><tr>
</tr><tr>
<td id="22017">22017</td><td>MCC_SET_SERVER_MODE</td><td>bool bServerMode</td>
<td id="22017">22017</td><td>MCC_SET_SERVER_MODE</td><td>bool bServerMode</td>
Line 377: Line 467:
<td id="22018">22018</td><td>MCC_SET_MODE_FOR_EXTERNAL_PROGRAM_LAUNCH</td><td>int nType (0: starting external app, 1: ending external app)</td>
<td id="22018">22018</td><td>MCC_SET_MODE_FOR_EXTERNAL_PROGRAM_LAUNCH</td><td>int nType (0: starting external app, 1: ending external app)</td>
</tr><tr>
</tr><tr>
<td id="22019">22019</td><td>MCC_SET_MODE_FOR_SECOND_INSTANCE_LAUNCH</td><td>UI_MODES Mode</td>
<td id="22019">22019</td><td>MCC_SET_MODE_FOR_SECOND_INSTANCE_LAUNCH</td><td>[[#UI_MODES|UI_MODES mode]]</td>
</tr><tr>
</tr><tr>
<td id="22020">22020</td><td>MCC_HOME</td><td>ignore</td>
<td id="22020">22020</td><td>MCC_HOME</td><td>ignore</td>
Line 394: Line 484:
</tr><tr>
</tr><tr>
<td id="22027">22027</td><td>MCC_FIND_MEDIA_WITH_WIZARD</td><td>ignore</td>
<td id="22027">22027</td><td>MCC_FIND_MEDIA_WITH_WIZARD</td><td>ignore</td>
</tr><tr>
<td id="22028">22028</td><td>MCC_SET_USER</td><td>int nUserId</td>
</tr><tr>
<td id="22029">22029</td><td>MCC_SHOW_TREE</td><td>bool bShowTree (-1 toggles)</td>
</tr><tr>
<td id="22030">22030</td><td>MCC_SET_TOOLTIPS</td><td>bool bTooltips (-1 toggles)</td>
</tr><tr>
<td id="22031">22031</td><td>MCC_AUDIO_ONLY_MODE</td><td>bool bAudioOnlyMode (-1 toggles)</td>
</tr><tr>
<td id="22032">22032</td><td>MCC_SHOW_SHARED_PLAYLISTS</td><td>ignore</td>
</tr><tr>
<td id="22033">22033</td><td>MCC_SET_ZONE_VISIBLE</td><td>ignore</td>
</tr><tr>
<td id="22034">22034</td><td>MCC_SHOW_PLAYING_FILE</td><td>int nFlags (1: no force; 2: only do Playing Now)</td>
</tr><tr>
<td id="22035">22035</td><td>MCC_F11</td><td>ignore</td>
</tr><tr>
<td id="22036">22036</td><td>MCC_SHOW_PLAYLIST</td><td>int nPlaylistID</td>
</tr><tr>
<td id="22037">22037</td><td>MCC_SPLIT_VIEW_TOGGLE</td><td>ignore</td>
</tr><tr>
<td id="22038">22038</td><td>MCC_SHOW_PLAYERBAR</td><td>ignore</td>
</tr><tr>
<td id="22039">22039</td><td>MCC_SET_PLAYERBAR_ALTERNATE_TEXT</td><td>bool bValue (-1 toggles)</td>
</tr><tr>
<td id="22040">22040</td><td>MCC_LOCK_TAB</td><td>bool bValue (-1 toggles)</td>
</tr><tr>
<td id="22041">22041</td><td>MCC_SHOW_SPOTLIGHT</td><td>int nType (0: current file, 1: current selection</td>
</tr><tr>
<td id="22042">22042</td><td>MCC_CLEAR_SEARCH_CONTROL</td><td>ignore</td>
</tr><tr>
<td id="22043">22043</td><td>MCC_THEATER_VIEW_PATH</td><td>Optional. Defaults to Theater View 'Home'. Surround path with single quotes, for example: MCxx.exe /MCC 22043,'Video\YouTube').</td>
</tr><tr>
<td id="22044">22044</td><td>MCC_ERROR_FREE_MODE</td><td>bool bValue (-1 toggles)</td>
</tr><tr>
<td id="22045">22045</td><td>MCC_SHOW_VIEW_HEADER_MENU</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 503: Line 629:
</tr><tr>
</tr><tr>
<td id="23049">23049</td><td>MCC_AUDIO_CALIBRATION</td><td>ignore</td>
<td id="23049">23049</td><td>MCC_AUDIO_CALIBRATION</td><td>ignore</td>
</tr><tr>
<td id="23050">23050</td><td>MCC_MARK_PLAYED</td><td>ignore</td>50
</tr><tr>
<td id="23051">23051</td><td>MCC_MARK_NOT_PLAYED</td><td>ignore</td>
</tr><tr>
<td id="23052">23052</td><td>MCC_LINK_TRACKS</td><td>ignore</td>
</tr><tr>
<td id="23053">23053</td><td>MCC_BREAK_TRACK_LINKS</td><td>ignore</td>
</tr><tr>
<td id="23054">23054</td><td>MCC_AB_COMPARISON</td><td>ignore</td>
</tr><tr>
<td id="23055">23055</td><td>MCC_COVER_ART_EDIT</td><td>ignore</td>
</tr><tr>
<td id="23056">23056</td><td>MCC_BUILD_MISSING_THUMBNAILS</td><td>ignore</td>
</tr><tr>
<td id="23057">23057</td><td>MCC_UPLOAD_TO_CLOUD</td><td>ignore</td>
</tr><tr>
<td id="23058">23058</td><td>MCC_LOOKUP_LYRICS</td><td>ignore</td>
</tr><tr>
<td id="23059">23059</td><td>MCC_COVER_ART_GET_ARTIST_IMAGES_FROM_LAST_FM</td><td>ignore</td>
</tr><tr>
<td id="23060">23060</td><td>MCC_COVER_ART_GET_COMPOSER_IMAGES_FROM_GOOGLE</td><td>ignore</td>
</tr><tr>
<td id="23061">23061</td><td>MCC_LOOKUP_DATE</td><td>ignore</td>
</tr><tr>
<td id="23062">23062</td><td>MCC_LOCK_PLAYLIST</td><td>int nPlaylistID</td>
</tr><tr>
<td id="23063">23063</td><td>MCC_UNLOCK_PLAYLIST</td><td>int nPlaylistID</td>
</tr><tr>
<td id="23064">23064</td><td>MCC_GET_SHARING_URL</td><td>ignore</td>
</tr><tr>
<td id="23065">23065</td><td>MCC_UNSHARE</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 560: Line 718:
</tr><tr>
</tr><tr>
<td id="24023">24023</td><td>MCC_BENCHMARK</td><td>ignore</td>
<td id="24023">24023</td><td>MCC_BENCHMARK</td><td>ignore</td>
</tr><tr>
<td id="24024">24024</td><td>MCC_UPGRADE_TO_MASTER_LICENSE</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 619: Line 779:
</tr><tr>
</tr><tr>
<td id="25024">25024</td><td>MCC_SCROBBLE_LISTENING_TO</td><td>ignore</td>
<td id="25024">25024</td><td>MCC_SCROBBLE_LISTENING_TO</td><td>ignore</td>
</tr><tr>
<td id="25025">25025</td><td>MCC_TREE_OPEN_DIRECTORY_IN_FILE_MANAGER</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 682: Line 844:
</tr><tr>
</tr><tr>
<td id="26026">26026</td><td>MCC_PANE_SET_EXPANDED</td><td>loword: nPaneIndex, hiword: 0: collapsed; 1: expanded</td>
<td id="26026">26026</td><td>MCC_PANE_SET_EXPANDED</td><td>loword: nPaneIndex, hiword: 0: collapsed; 1: expanded</td>
</tr><tr>
<td id="26031">26031</td><td>MCC_LIST_SEND_TO_PLAYING_NOW</td><td>SENDTO_PLAYING_NOW_TYPES Type</td>
</tr><tr>
<td id="26032">26032</td><td>MCC_LIST_SELECT_RANDOM</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 769: Line 935:
<td id="28031">28031</td><td>MCC_TV_PLAY_CHANNEL_POSITION</td><td>int Playlist position</td>
<td id="28031">28031</td><td>MCC_TV_PLAY_CHANNEL_POSITION</td><td>int Playlist position</td>
</tr><tr>
</tr><tr>
<td id="28032">28032</td><td>MCC_PLAYBACK_ENGINE_SET_SUBTITLES</td><td>int nIndex (-1 toggles forward, -2 toggles backwards)</td>
<td id="28032">28032</td><td>MCC_PLAYBACK_ENGINE_SET_SUBTITLES</td><td>int nIndex (-1 toggles forward, -2 toggles backwards, -3 to browse for subtitles)</td>
</tr><tr>
</tr><tr>
<td id="28033">28033</td><td>MCC_PLAYBACK_ENGINE_SET_AUDIO_STREAM</td><td>int nIndex (-1 toggles forward, -2 toggles backwards)</td>
<td id="28033">28033</td><td>MCC_PLAYBACK_ENGINE_SET_AUDIO_STREAM</td><td>int nIndex (-1 toggles forward, -2 toggles backwards)</td>
Line 776: Line 942:
</tr><tr>
</tr><tr>
<td id="28035">28035</td><td>MCC_PLAYBACK_ENGINE_VIDEO_SCREEN_GRAB</td><td>0: use as thumbnail; 1: save as external file</td>
<td id="28035">28035</td><td>MCC_PLAYBACK_ENGINE_VIDEO_SCREEN_GRAB</td><td>0: use as thumbnail; 1: save as external file</td>
</tr><tr>
<td id="28036">28036</td><td>MCC_PLAYBACK_ENGINE_VIDEO_LIPSYNC</td><td>int nShiftMS</td>
</tr><tr>
<td id="28037">28037</td><td>MCC_PLAYBACK_ENGINE_SET_SUBTITLE_TIMING</td><td>int nChangeMS</td>
</tr><tr>
<td id="28038">28038</td><td>MCC_PLAYBACK_ENGINE_VIDEO_ZOOM</td><td>int nZoomAmount (100 is 1.0)</td>
</tr><tr>
<td id="28039">28039</td><td>MCC_IMAGE_SET_FOCUS</td><td>ignore</td>
</tr><tr>
<td id="25040">25040</td><td>MCC_STEP_FORWARD_FRAMES</td><td>int nNumOfFrames (0 is special and default when no parameter is passed - to the next Keyframe)</td>
</tr><tr>
<td id="28041">28041</td><td>MCC_STEP_BACK_FRAMES</td><td>int nNumOfFrames (0 is special and default when no parameter is passed - to the previous Keyframe)</td>
</tr><tr>
<td id="28042">28042</td><td>MCC_PLAYBACK_ENGINE_TOGGLE_COMSKIP</td><td>ignore</td>
</tr><tr>
<td id="28043">28043</td><td>MCC_PLAYBACK_ENGINE_HIDE_OSD</td><td>ignore</td>
</tr><tr>
<td id="28044">28044</td><td>MCC_PLAYBACK_ENGINE_VIDEO_LIPSYNC_ZONE</td><td>int nShiftMS, positive or negative increment, zero to reset to 0. Value is saved in zone setting</td>
</tr><tr>
<td id="28045">28045</td><td>MCC_BLURAY_SHOW_POPUP_MENU</td><td>ignore</td>
</tr><tr>
<td id="28046">28046</td><td>MCC_PLAYBACK_ENGINE_SETTINGS_CHANGED</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 833: Line 1,021:
</tr><tr>
</tr><tr>
<td id="30023">30023</td><td>MCC_STOP_SERVING_TV_FILE</td><td>CTVPlayer *: pointer to TVPlayer object serving the file</td>
<td id="30023">30023</td><td>MCC_STOP_SERVING_TV_FILE</td><td>CTVPlayer *: pointer to TVPlayer object serving the file</td>
</tr><tr>
<td id="30025">30025</td><td>MCC_SET_OSD_ENABLED</td><td>-1 toggles, 1 turns on, 0 turns off (/mcc 30025,-1)</td>
</tr><tr>
<td id="30026">30026</td><td>MCC_TOGGLE_THEATER_VIEW_GRIDS_CHANNEL_NAME</td><td>ignore</td>
</tr><tr>
<td id="30027">30027</td><td>MCC_PASTE_PLAYING_NOW_IMAGE_FROM_CLIPBOARD</td><td>int nZoneID</td>
</tr><tr>
<td id="30028">30028</td><td>MCC_SHOW_SERVER_PRESENTATION_WEBPAGE</td><td>int nDeviceSessionID</td>
</tr><tr>
<td id="30029">30029</td><td>MCC_PLAY_TRAILER</td><td>ignore</td>
</tr><tr>
<td id="30030">30030</td><td>MCC_MOVE_TAB</td><td>int nDelta</td>
</tr><tr>
<td id="30031">30031</td><td>MCC_CHECK_LOADED</td><td>ignore</td>
</tr><tr>
<td id="30032">30032</td><td>MCC_RELAUNCH_PROGRAM</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 853: Line 1,057:
<td id="31004">31004</td><td>MCC_IMAGE_RESIZE</td><td>ignore</td>
<td id="31004">31004</td><td>MCC_IMAGE_RESIZE</td><td>ignore</td>
</tr><tr>
</tr><tr>
<td id="31005">31005</td><td>MCC_IMAGE_EDIT</td><td>ignore</td>
<td id="31005">31005</td><td>MCC_IMAGE_EDIT</td><td>int nFileKey</td>
</tr><tr>
</tr><tr>
<td id="31006">31006</td><td>MCC_IMAGE_DELETE</td><td>int nFileKey</td>
<td id="31006">31006</td><td>MCC_IMAGE_DELETE</td><td>int nFileKey</td>
Line 872: Line 1,076:
<th>Enum</th><th>Command</th><th>Parameter</th>
<th>Enum</th><th>Command</th><th>Parameter</th>
</tr><tr>
</tr><tr>
<td id="32000">32000</td><td>MCC_QUERY_UI_MODE</td><td>bool bInternalMode; Exit status is current UI mode: 0: Standard, 1: Mini, 2: Display, 3: Theater View, 4: Cover View</td>
<td id="32000">32000</td><td>MCC_QUERY_UI_MODE</td><td>bool bInternalMode; Exit status is current [[#UI_MODES|UI_MODES]]</td>
</tr><tr>
<td id="32001">32001</td><td>MCC_QUERY_WEBPAGE_VIEW</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 942: Line 1,148:
<td id="34009">34009</td><td>MCC_SAVE_PROPERTIES</td><td>ignore</td>
<td id="34009">34009</td><td>MCC_SAVE_PROPERTIES</td><td>ignore</td>
</tr><tr>
</tr><tr>
<td id="34010">34010</td><td>MCC_NOTIFY_UI_MODE_CHANGED</td><td>UI_MODES NewMode</td>
<td id="34010">34010</td><td>MCC_NOTIFY_UI_MODE_CHANGED</td><td>[[#UI_MODES|UI_MODES NewMode]]</td>
</tr><tr>
</tr><tr>
<td id="34011">34011</td><td>MCC_NOTIFY_SELECTION_CHANGED</td><td>int nViewKey</td>
<td id="34011">34011</td><td>MCC_NOTIFY_SELECTION_CHANGED</td><td>int nViewKey</td>
Line 1,002: Line 1,208:
<td id="34039">34039</td><td>MCC_NOTIFY_CURRENT_ZONE_CHANGED</td><td>ignore</td>
<td id="34039">34039</td><td>MCC_NOTIFY_CURRENT_ZONE_CHANGED</td><td>ignore</td>
</tr><tr>
</tr><tr>
<td id="34040">34040</td><td>MCC_NOTIFY_DISPLAY_OWNER_CHANGED</td><td>HWND hwndOwner</td>
<td id="34040">34040</td><td>MCC_NOTIFY_DISPLAY_OWNER_CHANGED</td><td>JRWnd * pwndOwner</td>
</tr><tr>
</tr><tr>
<td id="34041">34041</td><td>MCC_NOTIFY_AFTER_FIRST_UPDATE_LAYOUT_WINDOW</td><td>ignore</td>
<td id="34041">34041</td><td>MCC_NOTIFY_AFTER_FIRST_UPDATE_LAYOUT_WINDOW</td><td>ignore</td>
Line 1,113: Line 1,319:
</tr><tr>
</tr><tr>
<td id="34095">34095</td><td>MCC_NOTIFY_OPTICAL_DISC_CHANGED</td><td>ignore</td>
<td id="34095">34095</td><td>MCC_NOTIFY_OPTICAL_DISC_CHANGED</td><td>ignore</td>
</tr><tr>
<td id="34096">34096</td><td>MCC_NOTIFY_STORE_DOWNLOAD_STATUS_CHANGED</td><td>int nStoreNumber</td>
</tr><tr>
<td id="34097">34097</td><td>MCC_NOTIFY_CURRENT_PLAYLIST_NEXT_ITEM_TO_PLAY_CHANGED</td><td>int nZone</td>
</tr><tr>
<td id="34098">34098</td><td>MCC_NOTIFY_CONTENT_UPLOAD_PROGRESS</td><td>ignore</td>
</tr><tr>
<td id="34099">34099</td><td>MCC_NOTIFY_CONTENT_UPLOAD_UPDATE</td><td>int nEnsureVisibleColumn (if nEnsureVisibleColumn > 0, call EnsureVisible() on the list control)</td>
</tr><tr>
<td id="34100">34100</td><td>MCC_NOTIFY_TV_PROPERTIES_CHANGED</td><td>ignore</td>
</tr><tr>
<td id="34101">34101</td><td>MCC_NOTIFY_STATUSBAR_TEXT_CHANGED</td><td>ignore</td>
</tr>
</tr>
</table>
</table>
Line 1,131: Line 1,349:
<td id="35003">35003</td><td>MCC_STORE_SEARCH_AMAZON_MP3_STORE</td><td>MFKEY nKey</td>
<td id="35003">35003</td><td>MCC_STORE_SEARCH_AMAZON_MP3_STORE</td><td>MFKEY nKey</td>
</tr><tr>
</tr><tr>
<td id="35004">35004</td><td>MCC_STORE_TSHIRT</td><td>MFKEY nKey</td>
<td id="35004">35004</td><td>MCC_OBSOLETE_35004</td><td>ignore</td>
</tr><tr>
<td id="35005">35005</td><td>MCC_STORE_CHANGE_USER</td><td>ignore</td>
</tr><tr>
<td id="35006">35006</td><td>MCC_STORE_CHECK_FOR_DOWNLOADS</td><td>ignore</td>
</tr>
</tr>
</table>
</table>


==Defines==
== Specifying Zones ==

Media Center [[#Playback|Core Commands]] are targeted to a specific playback zone by combining the command's parameter value with the zone specifier value from the '''Zone Specifiers''' table. MC zones are integer indexes, from 0 to n, where 0 is the the first zone, 1 is the second zone, and so on. Zone indexes correspond to the zone order displayed under Playing Now in the Media Center tree. MC version 16.0.118 has simplified command line specification of parameter and zone, eliminating the need for manual calculations prior to usage. The '''/MCC''' option now accepts an alternate syntax in the format of <tt>''[value]'':''[zone index]''</tt> for the parameter (see examples). The text that follows documents and describes the original (and still valid) specification, which would be used when issuing an '''MCC''' command through a mechanism other than the '''MC16.exe''' command.
// return value for unhandled MCC commands
#define MCC_UNHANDLED 0

// flags for command enable, disable, and check
enum MCC_UPDATEUI_FLAGS
{
MCC_UPDATEUI_ENABLE = 1,
MCC_UPDATEUI_DISABLE = 2,
MCC_UPDATEUI_PRESSED = 4,
};

// update flags
#define MCC_UPDATE_FLAG_THUMBNAILS (1 << 0)
#define MCC_UPDATE_FLAG_FILE_PROPERTIES (1 << 1)
#define MCC_UPDATE_FLAG_FILE_ADDED_OR_REMOVED (1 << 2)
#define MCC_UPDATE_FLAG_TREE_STRUCTURE (1 << 3)
#define MCC_UPDATE_FLAG_REFILL_LIST (1 << 4)
#define MCC_UPDATE_FLAG_ITEM_DELETED (1 << 5)
#define MCC_UPDATE_FLAG_NO_PRESERVE_VIEW_STATE (1 << 6)
#define MCC_UPDATE_FLAG_WEB_VIEW (1 << 7)

// update all
#define MCC_UPDATE_FLAG_ALL (0x7FFFFFFF & ~(MCC_UPDATE_FLAG_NO_PRESERVE_VIEW_STATE))

// settings changed flags
#define MCC_SETTING_CHANGED_FLAG_UNKNOWN (1 << 0)
#define MCC_SETTING_CHANGED_FLAG_COLUMNS (1 << 1)
#define MCC_SETTING_CHANGED_FLAG_SORTING (1 << 2)
#define MCC_SETTING_CHANGED_FLAG_VIEW_SCHEME (1 << 3)
#define MCC_SETTING_CHANGED_FLAG_GROUPING (1 << 5)
#define MCC_SETTING_CHANGED_FLAG_LIBRARY_VIEW_SETTINGS (1 << 6)

// UI modes
enum <span id="UI_MODES">UI_MODES</span>
{
// unknown
UI_MODE_UNKNOWN = -2000,

// internal modes
UI_MODE_INTERNAL_NO_UI = -1000,
UI_MODE_INTERNAL_STANDARD = 0,
UI_MODE_INTERNAL_MINI_FREEFORM = 1,
UI_MODE_INTERNAL_MINI_SLIM = 2,
UI_MODE_INTERNAL_DISPLAY_WINDOWED = 3,
UI_MODE_INTERNAL_DISPLAY_FULLSCREEN = 4,
UI_MODE_INTERNAL_THEATER = 5,
UI_MODE_INTERNAL_COVER = 6,

// toggles, shortcuts, etc.
UI_MODE_SHORTCUT_TEMPORARY_DISPLAY_WINDOWED = -8,
UI_MODE_SHORTCUT_TOGGLE_DISPLAY_AND_LAST_USER_INPUT_MODE = -7,
UI_MODE_SHORTCUT_TOGGLE_DISPLAY_EXCLUDE_THEATER_VIEW = -6,
UI_MODE_SHORTCUT_TOGGLE_DISPLAY = -5,
UI_MODE_SHORTCUT_LAST_SHUTDOWN = -4,
UI_MODE_SHORTCUT_CURRENT = -3,
UI_MODE_SHORTCUT_CLOSE_DISPLAY = -2,
UI_MODE_SHORTCUT_NEXT = -1,

// modes presented to the user
UI_MODE_STANDARD = 0,
UI_MODE_MINI = 1,
UI_MODE_DISPLAY = 2,
UI_MODE_THEATER = 3,
UI_MODE_COVER = 4,
UI_MODE_COUNT = 5,
};

// player changes
#define PLAYER_INFO_CHANGE_ALL 0xFFFF
#define PLAYER_INFO_CHANGE_PLAYER_STATE (1 << 0)
#define PLAYER_INFO_CHANGE_VOLUME (1 << 1)
#define PLAYER_INFO_CHANGE_FILE_INFO (1 << 2)
#define PLAYER_INFO_CHANGE_PLAYLIST (1 << 3)
#define PLAYER_INFO_CHANGE_DSP (1 << 4)
#define PLAYER_INFO_CHANGE_IMAGE (1 << 5)
#define PLAYER_INFO_CHANGE_PLAYING_FILE (1 << 6)
#define PLAYER_INFO_CHANGE_OUTPUT_INFO (1 << 7)

// player status codes
enum PLAYER_STATUS_CODES
{
PLAYER_STATUS_CODE_BUFFERING,
PLAYER_STATUS_CODE_LOCATING,
PLAYER_STATUS_CODE_CONNECTING,
PLAYER_STATUS_CODE_DOWNLOADING_CODEC,
PLAYER_STATUS_CODE_ACQUIRING_LICENSE,
PLAYER_STATUS_CODE_INDIVIDUALIZE_STARTING,
PLAYER_STATUS_CODE_INDIVIDUALIZE_CONNECTING,
PLAYER_STATUS_CODE_INDIVIDUALIZE_REQUESTING,
PLAYER_STATUS_CODE_INDIVIDUALIZE_RECEIVING,
PLAYER_STATUS_CODE_INDIVIDUALIZE_COMPLETED,
};

// theater view modes
enum SHOW_THEATER_VIEW_MODES
{
SHOW_THEATER_VIEW_MODE_TOGGLE_THEATER_VIEW,
SHOW_THEATER_VIEW_MODE_HOME,
SHOW_THEATER_VIEW_MODE_PLAYING_NOW,
SHOW_THEATER_VIEW_MODE_AUDIO,
SHOW_THEATER_VIEW_MODE_IMAGES,
SHOW_THEATER_VIEW_MODE_VIDEOS,
SHOW_THEATER_VIEW_MODE_PLAYLISTS,
SHOW_THEATER_VIEW_MODE_CD_DVD,
SHOW_THEATER_VIEW_MODE_TELEVISION,
SHOW_THEATER_VIEW_MODE_TELEVISION_GUIDE,
SHOW_THEATER_VIEW_MODE_TELEVISION_RECORDINGS,
SHOW_THEATER_VIEW_MODE_LAST_VIEWED,
};

// get selection modes
enum GET_SELECTION_MODES
{
GET_SELECTION_EXACT,
GET_SELECTION_ALL_ON_NONE,
GET_SELECTION_ALL_ON_ONE_OR_NONE,
GET_SELECTION_ALL,
GET_SELECTION_EXACT_WITH_POSITION,
};

// skip to modes
enum SKIP_TO_MODES
{
SKIP_TO_UNDEFINED = 0,
SKIP_TO_PREVIOUS_ALBUM,
SKIP_TO_NEXT_ALBUM,
SKIP_TO_PREVIOUS_ARTIST,
SKIP_TO_NEXT_ARTIST,
};

= Specifying Zones =
Media Center [[#Playback|Core Commands]] are targeted to a specific playback zone by combining the command's parameter value with the zone specifier value from the '''Zone Specifiers''' table. MC zones are integer indexes, from 0 to n, where 0 is the the first local zone, 1 is the second local zone, and so on. Remote zones, such as those for DLNA devices, will not be contiguous with local zones. A list of zones can be obtained using the MCWS command:

: <nowiki>http://<server IP>:52199/MCWS/v1/Playback/Zones</nowiki>

MC version 16.0.118 has simplified command line specification of parameter and zone, eliminating the need for manual calculations prior to usage. The '''/MCC''' option now accepts an alternate syntax in the format of <tt>''[value]'':''[zone index]''</tt> for the parameter (see examples). The text that follows documents and describes the original (and still valid) specification, which would be used when issuing an '''MCC''' command through a mechanism other than the '''MC18.exe''' command.


{| border="1" cellpadding="3" cellspacing="0" align="right" style="text-align:right;"
{| border="1" cellpadding="3" cellspacing="0" align="right" style="text-align:right;"
Line 1,170: Line 1,528:
Examples
Examples
* Increase volume to 25% for Zone 2 (new parameter specification available starting with MC 16.0.118)
* Increase volume to 25% for Zone 2 (new parameter specification available starting with MC 16.0.118)
** '''MC16.exe /MCC 10020, 25:2'''
** '''MC18.exe /MCC 10020,25:2'''


* Increase volume to 25% for Zone 2
* Increase volume to 25% for Zone 2
Line 1,252: Line 1,610:
|}
|}


[[Category:Developer]]
== Other Defines ==

<pre>
// the WM_APP based message (WM_APP = 32768, so WM_MC_COMMAND = 33768)
#define WM_MC_COMMAND (WM_APP + 1000)

// extended MC_COMMAND message that takes a structure with extra information (internal use only)
#define WM_MC_COMMAND_EX (WM_APP + 1001)

// return value for unhandled MCC commands
#define MCC_UNHANDLED 0

// flags for command enable, disable, and check
enum MCC_UPDATEUI_FLAGS
{
MCC_UPDATEUI_ENABLE = 1,
MCC_UPDATEUI_DISABLE = 2,
MCC_UPDATEUI_PRESSED = 4,
};
</pre>

=== Helper macros ===

<pre>
#define IS_MCC_COMMAND_IN_RANGE(INDEX, FIRST, LAST) (((abs((int)INDEX)) >= FIRST) && ((abs((int)INDEX)) < LAST) || ((abs((int)INDEX)) >= FIRST + MCC_CUSTOMIZATION_OFFSET) &&
((abs((int)INDEX)) < LAST + MCC_CUSTOMIZATION_OFFSET))
#define IS_MCC_COMMAND_IN_SECTION(INDEX, FIRST) IS_MCC_COMMAND_IN_RANGE(INDEX, FIRST, FIRST + 1000)
#define IS_VALID_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_RANGE(INDEX, MCC_FIRST, MCC_LAST)
#define IS_PLAYBACK_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_PLAYBACK_SECTION)
#define IS_FILE_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_FILE_SECTION)
#define IS_EDIT_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_EDIT_SECTION)
#define IS_VIEW_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_VIEW_SECTION)
#define IS_TOOL_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_TOOLS_SECTION)
#define IS_HELP_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_HELP_SECTION)
#define IS_TREE_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_TREE_SECTION)
#define IS_LIST_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_LIST_SECTION)
#define IS_SYSTEM_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_SYSTEM_SECTION)
#define IS_PLAYBACK_ENGINE_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_PLAYBACK_ENGINE_SECTION)
#define IS_IMAGE_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_IMAGE_SECTION)
#define IS_QUERY_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_QUERY_SECTION)
#define IS_INTERNAL_COMMAND_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_COMMANDS_SECTION)
#define IS_NOTIFY_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_SECTION(INDEX, MCC_NOTIFICATIONS_SECTION)
#define IS_CUSTOMIZATION_MCC_COMMAND(INDEX) IS_MCC_COMMAND_IN_RANGE(INDEX, MCC_FIRST + MCC_CUSTOMIZATION_OFFSET, MCC_LAST + MCC_CUSTOMIZATION_OFFSET)

#define MAKE_MCC_PLAYBACK_PARAM(PARAM, ZONE_INDEX) (((ZONE_INDEX) == -1) ? ((PARAM) & 0x00FFFFFF) : ((((ZONE_INDEX) + 1) << 24) & 0xFF000000) | ((PARAM) & 0x00FFFFFF))
#define GET_MCC_PLAYBACK_PARAM(PARAM) (((PARAM) & 0x400000) ? ((PARAM) & 0xFFFFFF) - 0x1000000 : ((PARAM) & 0xFFFFFF))
#define GET_MCC_PLAYBACK_ZONE_INDEX(PARAM) (((PARAM) & 0x80000000) ? -1 : (((PARAM) >> 24) - 1))
</pre>

=== For Internal Use ===

<pre>

// update flags
#define MCC_UPDATE_FLAG_THUMBNAILS (1 << 0)
#define MCC_UPDATE_FLAG_FILE_PROPERTIES (1 << 1)
#define MCC_UPDATE_FLAG_FILE_ADDED_OR_REMOVED (1 << 2)
#define MCC_UPDATE_FLAG_TREE_STRUCTURE (1 << 3)
#define MCC_UPDATE_FLAG_REFILL_LIST (1 << 4)
#define MCC_UPDATE_FLAG_ITEM_DELETED (1 << 5)
#define MCC_UPDATE_FLAG_NO_PRESERVE_VIEW_STATE (1 << 6)
#define MCC_UPDATE_FLAG_WEB_VIEW (1 << 7)

// update all
#define MCC_UPDATE_FLAG_ALL (0x7FFFFFFF & ~(MCC_UPDATE_FLAG_NO_PRESERVE_VIEW_STATE))

// settings changed flags
#define MCC_SETTING_CHANGED_FLAG_UNKNOWN (1 << 0)
#define MCC_SETTING_CHANGED_FLAG_COLUMNS (1 << 1)
#define MCC_SETTING_CHANGED_FLAG_SORTING (1 << 2)
#define MCC_SETTING_CHANGED_FLAG_VIEW_SCHEME (1 << 3)
#define MCC_SETTING_CHANGED_FLAG_GROUPING (1 << 5)
#define MCC_SETTING_CHANGED_FLAG_LIBRARY_VIEW_SETTINGS (1 << 6)

// UI modes
enum UI_MODES
{
// unknown
UI_MODE_UNKNOWN = -2000,

// internal modes
UI_MODE_INTERNAL_NO_UI = -1000,
UI_MODE_INTERNAL_STANDARD,
UI_MODE_INTERNAL_MINI_FREEFORM,
UI_MODE_INTERNAL_MINI_SLIM,
UI_MODE_INTERNAL_DISPLAY_WINDOWED,
UI_MODE_INTERNAL_DISPLAY_FULLSCREEN,
UI_MODE_INTERNAL_THEATER,
UI_MODE_INTERNAL_COVER,

// toggles, shortcuts, etc.
UI_MODE_SHORTCUT_TEMPORARY_DISPLAY_WINDOWED = -8,
UI_MODE_SHORTCUT_TOGGLE_DISPLAY_AND_LAST_USER_INPUT_MODE = -7,
UI_MODE_SHORTCUT_TOGGLE_DISPLAY_EXCLUDE_THEATER_VIEW = -6,
UI_MODE_SHORTCUT_TOGGLE_DISPLAY = -5,
UI_MODE_SHORTCUT_LAST_SHUTDOWN = -4,
UI_MODE_SHORTCUT_CURRENT = -3,
UI_MODE_SHORTCUT_CLOSE_DISPLAY = -2,
UI_MODE_SHORTCUT_NEXT = -1,

// modes presented to the user
UI_MODE_STANDARD = 0,
UI_MODE_MINI,
UI_MODE_DISPLAY,
UI_MODE_THEATER,
UI_MODE_COVER,
UI_MODE_COUNT,
};

// player changes
#define PLAYER_INFO_CHANGE_ALL 0xFFFF
#define PLAYER_INFO_CHANGE_PLAYER_STATE (1 << 0)
#define PLAYER_INFO_CHANGE_VOLUME (1 << 1)
#define PLAYER_INFO_CHANGE_FILE_INFO (1 << 2)
#define PLAYER_INFO_CHANGE_PLAYLIST (1 << 3)
#define PLAYER_INFO_CHANGE_DSP (1 << 4)
#define PLAYER_INFO_CHANGE_IMAGE (1 << 5)
#define PLAYER_INFO_CHANGE_PLAYING_FILE (1 << 6)
#define PLAYER_INFO_CHANGE_OUTPUT_INFO (1 << 7)

// player status codes
enum PLAYER_STATUS_CODES
{
PLAYER_STATUS_CODE_BUFFERING,
PLAYER_STATUS_CODE_LOCATING,
PLAYER_STATUS_CODE_CONNECTING,
PLAYER_STATUS_CODE_DOWNLOADING_CODEC,
PLAYER_STATUS_CODE_ACQUIRING_LICENSE,
PLAYER_STATUS_CODE_INDIVIDUALIZE_STARTING,
PLAYER_STATUS_CODE_INDIVIDUALIZE_CONNECTING,
PLAYER_STATUS_CODE_INDIVIDUALIZE_REQUESTING,
PLAYER_STATUS_CODE_INDIVIDUALIZE_RECEIVING,
PLAYER_STATUS_CODE_INDIVIDUALIZE_COMPLETED,
};

// theater view modes
enum SHOW_THEATER_VIEW_MODES
{
SHOW_THEATER_VIEW_MODE_TOGGLE_THEATER_VIEW,
SHOW_THEATER_VIEW_MODE_HOME,
SHOW_THEATER_VIEW_MODE_PLAYING_NOW,
SHOW_THEATER_VIEW_MODE_AUDIO,
SHOW_THEATER_VIEW_MODE_IMAGES,
SHOW_THEATER_VIEW_MODE_VIDEOS,
SHOW_THEATER_VIEW_MODE_PLAYLISTS,
SHOW_THEATER_VIEW_MODE_CD_DVD,
SHOW_THEATER_VIEW_MODE_TELEVISION,
SHOW_THEATER_VIEW_MODE_TELEVISION_GUIDE,
SHOW_THEATER_VIEW_MODE_TELEVISION_RECORDINGS,
SHOW_THEATER_VIEW_MODE_LAST_VIEWED,
};

// get selection modes
enum GET_SELECTION_MODES
{
GET_SELECTION_EXACT,
GET_SELECTION_ALL_ON_NONE,
GET_SELECTION_ALL_ON_ONE_OR_NONE,
GET_SELECTION_ALL,
GET_SELECTION_EXACT_WITH_POSITION,
};
</pre>

Latest revision as of 13:34, 17 October 2024

See also: DevZone

MC Core Commands are used to control various aspects of Media Center via software or command line. Each command consists of a name (or number), followed by an optional parameter which selects or specifies the particular command behavior.

The full, C++ header is available here: JRiver Media Core Commands Header File

Notes

  • Save the MCCommands.h file to your hard drive to avoid potential line break issues.
  • Commands have changed over time; use the Wiki's page history to see previous versions of this page. Some commands may only work with the latest version of Media Center.

How To Issue Media Core Commands

Look up the command name / number and its parameter in the tables below. For example, the command to toggle between play and pause is MCC_PLAY_PAUSE. It has command number (enum value) 10000 and its accompanying parameter is ignored. Some MCC commands may be targeted a particular Zone - see Specifying Zones.

Issuing a command from the command line

Assuming you are familiar with the first section of The Command Line, the general syntax for issuing an MCC command from the Windows command line (or equivalent) is: 

MC<version>.exe /MCC <command number>,<parameter>

Note: Command numbers must be used; command names are not used on the command line.

Example: To toggle between play and pause in MC16, use the command: 

MC18.exe /MCC 10000,0

Note: The MCC commands can be entered in Vista and Windows 7 directly into Search Files and Programs under the Windows Start menu, or as commands in a Windows command shell, which can be launched in Vista and Windows 7 by entering cmd.exe in Search Files and Programs under the Windows Start menu. It is available under the Accessories menu as Command Prompt in previous versions of Windows.


On Mac: 

/Applications/Media\ Center\ <version>.app/Contents/MacOS/Launcher.app/Contents/MacOS/Launcher /MCC <command number>,<parameter>


On Linux: 

/usr/lib/jriver/MC<version>/mc<version> /MCC <command number>,<parameter>

Issuing a command from C++

The calling syntax for posting a WM_MC_COMMAND -based message to the MC frame is demonstrated in the example below.

Example: To post a command to toggle between play and pause 

HWND hwndMC = FindWindow(_T("MJFrame"), NULL);
PostMessage(hwndMC, WM_MC_COMMAND, MCC_PLAY_PAUSE, 0);

Notes on usage

  • Use command numbers when calling from the command line, enum names from within software (e.g. MCC_PLAY_PAUSE).
  • Set parameter to 0 if unused.


MC Commands

The MCC commands table and defines below were auto-generated on 2014-06-09 from the latest MCCommands.h (19.0.138) file posted above.

MC Commands Table

Playback

Range: 10,000 to 20,000

Note: See Specifying Zones to learn about issuing commands to a specific Zone.

EnumCommandParameter
10000MCC_PLAY_PAUSEignore
10001MCC_PLAYignore
10002MCC_STOPbool bDisplayError
10003MCC_NEXTint nFlags (1: bNotActualNext, 2: bNoChapters)
10004MCC_PREVIOUSint nFlags (1: reserved, 2: bNoChapters, 4: no seek to beginning)
10005MCC_SHUFFLE0: toggle shuffle mode; 1: shuffle, jump to PN; 2: shuffle, no jump; 3: off; 4: on; 5:automatic
10006MCC_CONTINUOUS0: toggle continuous; 1: off; 2: playlist; 3: song; 4: stop after each
10007MCC_OBSOLETE_10007ignore
10008MCC_FAST_FORWARDint nRate
10009MCC_REWINDint nRate
10010MCC_STOP_CONDITIONALignore
10011MCC_SET_ZONEint nZoneIndex (-1 toggles forward, -2 toggles backwards)
10012MCC_TOGGLE_DISPLAYbool bExcludeTheaterView
10013MCC_SHOW_WINDOWbool bJumpToPlayingNow
10014MCC_MINIMIZE_WINDOWignore
10015MCC_PLAY_CPLDB_INDEXint nIndex
10016MCC_SHOW_DSP_STUDIOignore
10017MCC_VOLUME_MUTE0: toggle; 1: mute; 2: unmute
10018MCC_VOLUME_UPint nDeltaPercent
10019MCC_VOLUME_DOWNint nDeltaPercent
10020MCC_VOLUME_SETint nPercent
10021MCC_SHOW_PLAYBACK_OPTIONSignore
10022MCC_SET_PAUSEbool bPause (-1 toggles)
10023MCC_SET_CURRENTLY_PLAYING_RATINGint nRating (1 through 5; 0 clears, but see here.)
10024MCC_SHOW_PLAYBACK_ENGINE_MENUscreen point (loword: x, hiword: y) -- must send directly
10025MCC_PLAY_NEXT_PLAYLISTignore
10026MCC_PLAY_PREVIOUS_PLAYLISTignore
10027MCC_MAXIMIZE_WINDOWignore
10028MCC_RESTORE_WINDOWignore
10029MCC_SET_PLAYERSTATUSPLAYER_STATUS_CODES Code
10030MCC_SET_ALTERNATE_PLAYBACK_SETTINGSbool bAlternateSettings (-1 toggles)
10031MCC_SET_PREVIEW_MODE_SETTINGSlow 12 bits: int nDurationSeconds, high 12 bits: int nStartSeconds
10032MCC_SHOW_PLAYBACK_ENGINE_DISPLAY_PLUGIN_MENUscreen point (loword: x, hiword: y) -- must send directly
10033MCC_DVD_MENUignore
10034MCC_SEEK_FORWARDint nMilliseconds (0 means default -- varies depending on playback type)
10035MCC_SEEK_BACKint nMilliseconds (0 means default -- varies depending on playback type)
10036MCC_STOP_AFTER_CURRENT_FILEbool bStopAfterCurrentFile (-1 toggles)
10037MCC_DETACH_DISPLAYbool bDetach (-1 toggles)
10038MCC_SET_MODE_ZONE_SPECIFICUI_MODES mode
10039MCC_STOP_INTERNALignore
10040MCC_PLAYING_NOW_REMOVE_DUPLICATESignore
10041MCC_SHUFFLE_REMAININGignore
10042MCC_PLAY_FIRST_FILEignore
10043MCC_PLAY_LAST_FILEignore
10044MCC_PLAY_FILE_BY_STRINGBSTR bstrFile (deleted by receiver)
10045MCC_PLAY_FILE_AGAINignore
10046MCC_HANDLE_PLAYBACK_ERRORignore
10047MCC_PLAY_AUTOMATIC_PLAYLISTBSTR bstrSeed (deleted by receiver)
10048MCC_SEEKint nPositionMilliseconds
10049MCC_CLEAR_PLAYING_NOW_ZONE_SPECIFIC0: all files; 1: leave playing file
10050MCC_PLAY_RADIO_LAST_FMignore
10051MCC_SHOW_ON_SCREEN_DISPLAY0: position bar
10052MCC_SET_SUBTITLESint nIndex (-1 toggles forward, -2 toggles backwards)
10053MCC_SET_AUDIO_STREAMint nIndex (-1 toggles forward, -2 toggles backwards)
10054MCC_SET_VIDEO_STREAMint nIndex (-1 toggles forward, -2 toggles backwards)
10055MCC_VIDEO_SCREEN_GRAB0: use as thumbnail; 1: save as external file
10056MCC_SET_VOLUME_MODEint nMode (internal type EPlaybackVolumeModes) (0: application, 1: internal; 2: system; 3: disabled)
10057MCC_RESTART_PLAYBACKignore
10058MCC_ZONE_SWITCHignore
10059MCC_SKIP_TOSKIP_TO_MODES Mode
10060MCC_LINK_ZONEint nZoneID
10061MCC_UNLINK_ZONEignore
10062MCC_PLAY_RADIO_MEDIANETignore
10063MCC_CLEAR_PLAYED_ZONE_SPECIFICignore
10064MCC_PLAY_LAST_TV_CHANNELignore
10065MCC_BLURAY_POPUP_MENUignore
10066MCC_PLAY_SYNCED_CPLDB_INDEXint nIndex
10067MCC_STOP_AFTER_DELAYint nMinutes (negative value for hard stop)
10068MCC_STOP_AFTER_TRACKSint nNumberTracks (negative one to reset)
10069MCC_PLAY_SELECTED0: play replace, 1: append, 2: play next
10070MCC_PLAY_AUTO_PLAYLIST_CLOUDBSTR: seed
10071MCC_CLEAR_REMAINING_ZONE_SPECIFICignore
10072MCC_SEEK_PERCENTint nPercent
10073MCC_SHUFFLE_ALBUMSignore
10074MCC_JRVR_PROFILE_OUTPUTProfile ID (-1: Default Profile, -2: Auto Select Profile)
10075MCC_JRVR_PROFILE_SCALINGProfile ID (-1: Default Profile, -2: Auto Select Profile)
10076MCC_JRVR_PROFILE_FILTERINGProfile ID (-1: Default Profile, -2: Auto Select Profile)
10077MCC_JRVR_PROFILE_ADVANCEDProfile ID (-1: Default Profile, -2: Auto Select Profile)
10078MCC_CLOSE_PROGRAM_AFTER_STOP0: no, 1: yes, -1: toggle
10079MCC_ZONE_SWITCH_ENABLE0: no, 1: yes, -1: toggle
10080MCC_JRVR_DEFAULT_PROFILE_OUTPUTint ProfileID
10081MCC_JRVR_DEFAULT_PROFILE_SCALINGint ProfileID
10082MCC_JRVR_DEFAULT_PROFILE_FILTERINGint ProfileID
10083MCC_JRVR_DEFAULT_PROFILE_ADVANCEDint ProfileID
10084MCC_HIDE_DSP_STUDIOignore
10085MCC_SET_DSP_STUDIO_PLAYBACK_RATENon-zero integers for percent of normal speed, negative values mute audio
10086MCC_RESTART_PLAYBACK_WITH_RATEnew playback rate

File

Range: 20,000 to 21,000

EnumCommandParameter
20000MCC_OPEN_FILEignore
20001MCC_OPEN_URLignore
20002MCC_PRINT_LISTignore
20003MCC_EXPORT_PLAYLISTint nPlaylistID (-1 for active view)
20004MCC_EXPORT_ALL_PLAYLISTSbool bSilent
20005MCC_UPLOAD_FILESignore
20006MCC_EMAIL_FILESignore
20007MCC_EXITint nMode (0: normal, 1: force close (close media server), 2: force close (allow media server))
20008MCC_UPDATE_LIBRARYignore
20009MCC_CLEAR_LIBRARYignore
20010MCC_EXPORT_LIBRARYignore
20011MCC_BACKUP_LIBRARYint nMode (0: normal, 1: silent automatic backup)
20012MCC_RESTORE_LIBRARYignore
20013MCC_LIBRARY_MANAGERignore
20014MCC_IMAGE_ACQUIREignore
20015MCC_PRINT_IMAGESMFKEY nKey (-1 for selected files)
20016MCC_PRINTignore
20017MCC_OBSOLETE_20017ignore
20018MCC_OBSOLETE_20018ignore
20019MCC_OBSOLETE_20019ignore
20020MCC_OBSOLETE_20020ignore
20021MCC_OBSOLETE_20021ignore
20022MCC_OBSOLETE_20022ignore
20023MCC_OBSOLETE_20023ignore
20024MCC_IMPORT_PLAYLISTignore
20025MCC_LOAD_LIBRARYint nLibraryIndex
20026MCC_SYNC_LIBRARYignore
20027MCC_EMAIL_PODCAST_FEEDignore
20028MCC_LOAD_LIBRARY_READ_ONLYint nLibraryIndex
20029MCC_ADD_LIBRARYignore
20030MCC_EXPORT_ITUNESignore
20031MCC_DISCONNECT_LIBRARYignore
20032MCC_SYNC_WITH_LIBRARY_SERVERbool bSilent
20033MCC_STOP_ALL_ZONESbool bStopRemoteZones
20034MCC_CLONE_LIBRARYint nLibraryIndex
20035MCC_OPEN_LIVEignore
20036MCC_PLAY_RADIO_PARADISEignore
20037MCC_IMPORT_ITUNESignore
20038MCC_PLAY_RADIO_JRIVERint nStationNumber
20039MCC_EXPORT_ALL_TO_ITUNESignore
20040MCC_IMPORT_ITUNES_DATABASEignore
20041MCC_SET_CROSS_PLATFORM_RULESignore
20042MCC_DOWNLOAD_FROM_LIBRARY_SERVERignore

Edit

Range: 21,000 to 22,000

EnumCommandParameter
21000MCC_COPYignore
21001MCC_PASTEignore
21002MCC_SELECT_ALLignore
21003MCC_SELECT_INVERTignore
21004MCC_DELETEbool bAggressive
21005MCC_RENAMEignore
21006MCC_UNDOignore
21007MCC_REDOignore
21008MCC_QUICK_SEARCHbool bRepeatLastSearch
21009MCC_ADD_PLAYLISTMEDIAFILE_INFO_ARRAY * paryFiles = NULL
21010MCC_ADD_SMARTLISTignore
21011MCC_ADD_PLAYLIST_GROUPignore
21012MCC_PROPERTIESMEDIAFILE_INFO_ARRAY * paryFiles = NULL (-1 toggles) (note: never PostMessage(...) a pointer)
21013MCC_TOGGLE_TAGGING_MODEignore
21014MCC_CUTignore
21015MCC_DESELECT_ALLignore
21016MCC_DELETE_ALLbool bAggressive
21017MCC_ADD_PODCAST_FEEDignore
21018MCC_EDIT_PODCAST_FEEDignore
21019MCC_ADD_PODCAST_DEFAULTSignore
21020MCC_CREATE_STOCK_SMARTLISTSignore
21021MCC_ENABLE_PODCAST_DOWNLOADignore
21022MCC_DISABLE_PODCAST_DOWNLOADignore
21023MCC_EDIT_PLAYLISTignore
21024MCC_EDIT_PLAYING_NOWint nZoneID
21025MCC_EDIT_DISC_INFORMATIONignore
21026MCC_EDIT_SMARTLISTint nPlaylistID
21027MCC_REFRESH_PODCAST_FEEDignore
21028MCC_LOOKUP_MOVIE_INFORMATIONignore
21029MCC_ADD_ZONEignore
21030MCC_ADD_AUTOMATIC_PLAYLISTignore
21031MCC_SET_WRITE_TAGSbool bWriteTags (-1 toggles)
21032MCC_PASTE_TAGSignore
21033MCC_SHUFFLE_SELECTIONignore
21034MCC_CLOSE_QUICK_SEARCHignore
21035MCC_ADD_ZONE_GROUPignore
21036MCC_COMBINEint nPlaylistID
21037MCC_ADD_DYNAMIC_ZONEignore
21038MCC_PLAYLIST_SEARCHignore

View

Range: 22,000 to 23,000

EnumCommandParameter
22000MCC_TOGGLE_MODEUI_MODES mode
22001MCC_THEATER_VIEW0: Toggle, 1: Home, 2: Playing Now, 3: Audio, 4: Images, 5: Video, 6: Playlists, 7: CD & DVD, 8: TV, 9: TV Guide, 10: TV Recordings, 12: Netflix
22002MCC_PARTY_MODEignore
22003MCC_SHOW_TREE_ROOT-1: Toggle, 0: Hide, 1: Show
22004MCC_FIND_MEDIAwchar * pstrSearch (note: memory will be deleted by receiver)
22005MCC_BACKint nLevels (0 does 1 level)
22006MCC_FORWARDint nLevels (0 does 1 level)
22007MCC_REFRESHint nFlags (1: no webpage refresh)
22008MCC_SET_LIST_STYLEint nListStyle (-1 toggles)
22009MCC_SET_MODEUI_MODES mode
22010MCC_OBSOLETE_22010ignore
22011MCC_OBSOLETE_22011ignore
22012MCC_SHOW_RECENTLYIMPORTEDignore
22013MCC_SHOW_TOPHITSignore
22014MCC_SHOW_RECENTLYPLAYEDignore
22015MCC_SET_MEDIA_MODEint nMediaMode
22016MCC_OBSOLETE_22016ignore
22017MCC_SET_SERVER_MODEbool bServerMode
22018MCC_SET_MODE_FOR_EXTERNAL_PROGRAM_LAUNCHint nType (0: starting external app, 1: ending external app)
22019MCC_SET_MODE_FOR_SECOND_INSTANCE_LAUNCHUI_MODES mode
22020MCC_HOMEignore
22021MCC_ROLLUP_VIEW_HEADERbool bRollup (-1: toggle)
22022MCC_FOCUS_SEARCH_CONTROLignore
22023MCC_SET_ACTIVE_VIEW_KEYint nViewKey (-1: toggle, -2: toggle backwards, -3: new view)
22024MCC_CLOSE_VIEW_KEYint nViewKey (-1: current view)
22025MCC_VIEW_ZOOM_SETint nZoomPercentage
22026MCC_VIEW_ZOOM_INCREMENTint nZoomDeltaPercentage
22027MCC_FIND_MEDIA_WITH_WIZARDignore
22028MCC_SET_USERint nUserId
22029MCC_SHOW_TREEbool bShowTree (-1 toggles)
22030MCC_SET_TOOLTIPSbool bTooltips (-1 toggles)
22031MCC_AUDIO_ONLY_MODEbool bAudioOnlyMode (-1 toggles)
22032MCC_SHOW_SHARED_PLAYLISTSignore
22033MCC_SET_ZONE_VISIBLEignore
22034MCC_SHOW_PLAYING_FILEint nFlags (1: no force; 2: only do Playing Now)
22035MCC_F11ignore
22036MCC_SHOW_PLAYLISTint nPlaylistID
22037MCC_SPLIT_VIEW_TOGGLEignore
22038MCC_SHOW_PLAYERBARignore
22039MCC_SET_PLAYERBAR_ALTERNATE_TEXTbool bValue (-1 toggles)
22040MCC_LOCK_TABbool bValue (-1 toggles)
22041MCC_SHOW_SPOTLIGHTint nType (0: current file, 1: current selection
22042MCC_CLEAR_SEARCH_CONTROLignore
22043MCC_THEATER_VIEW_PATHOptional. Defaults to Theater View 'Home'. Surround path with single quotes, for example: MCxx.exe /MCC 22043,'Video\YouTube').
22044MCC_ERROR_FREE_MODEbool bValue (-1 toggles)
22045MCC_SHOW_VIEW_HEADER_MENUignore

Tools

Range: 23,000 to 24,000

50
EnumCommandParameter
23000MCC_IMPORTint nFlags (1: bDisableAlreadyRunningWarning, 2: bFirstImportMode)
23001MCC_RIP_CDignore
23002MCC_BURNignore
23003MCC_RECORD_AUDIOignore
23004MCC_CONVERTignore
23005MCC_ANALYZE_AUDIOignore
23006MCC_MEDIA_EDITORignore
23007MCC_CD_LABELERignore
23008MCC_OBSOLETE_23008ignore
23009MCC_OBSOLETE_23009ignore
23010MCC_SKIN_MANAGERignore
23011MCC_OPTIONSint nPageID
23012MCC_RENAME_CD_FILESignore
23013MCC_OBSOLETE_23013ignore
23014MCC_OBSOLETE_23014ignore
23015MCC_HANDHELD_UPLOADloword: nDeviceSessionID (0 gets default), hiword: flags (1: sync only; 2: show warnings)
23016MCC_HANDHELD_UPDATE_UPLOAD_WORKER_FINISHEDint nDeviceSessionID
23017MCC_HANDHELD_CLOSE_DEVICEint nDeviceSessionID
23018MCC_HANDHELD_SHOW_OPTIONSint nDeviceSessionID
23019MCC_HANDHELD_INFO_DUMPbool bShowInfo
23020MCC_IMPORT_AUTO_RUN_NOWbool bSilent
23021MCC_IMPORT_AUTO_CONFIGUREignore
23022MCC_HANDHELD_EJECTint nDeviceSessionID
23023MCC_RECORD_TVignore
23024MCC_FIND_AND_REPLACEignore
23025MCC_CLEAN_PROPERTIESignore
23026MCC_FILL_TRACK_ORDERignore
23027MCC_MOVE_COPY_FIELDSignore
23028MCC_REMOVE_TAGSignore
23029MCC_UPDATE_TAGS_FROM_DBignore
23030MCC_UPDATE_DB_FROM_TAGSignore
23031MCC_LOOKUP_TRACK_INFO_FROM_INTERNETignore
23032MCC_SUBMIT_TRACK_INFO_TO_INTERNETignore
23033MCC_OBSOLETE_23033ignore
23034MCC_FILL_PROPERTIES_FROM_FILENAMEignore
23035MCC_RENAME_FILES_FROM_PROPERTIESignore
23036MCC_COVER_ART_ADD_FROM_FILEignore
23037MCC_COVER_ART_QUICK_ADD_FROM_FILEignore
23038MCC_COVER_ART_GET_FROM_INTERNETignore
23039MCC_COVER_ART_SUBMIT_TO_INTERNETignore
23040MCC_COVER_ART_GET_FROM_SCANNERignore
23041MCC_COVER_ART_SELECT_SCANNERignore
23042MCC_COVER_ART_GET_FROM_CLIPBOARDignore
23043MCC_COVER_ART_COPY_TO_CLIPBOARDignore
23044MCC_COVER_ART_REMOVEignore
23045MCC_COVER_ART_PLAYignore
23046MCC_COVER_ART_SAVE_TO_EXTERNAL_FILEignore
23047MCC_COVER_ART_REBUILD_THUMBNAILignore
23048MCC_RINGTONEignore
23049MCC_AUDIO_CALIBRATIONignore
23050MCC_MARK_PLAYEDignore
23051MCC_MARK_NOT_PLAYEDignore
23052MCC_LINK_TRACKSignore
23053MCC_BREAK_TRACK_LINKSignore
23054MCC_AB_COMPARISONignore
23055MCC_COVER_ART_EDITignore
23056MCC_BUILD_MISSING_THUMBNAILSignore
23057MCC_UPLOAD_TO_CLOUDignore
23058MCC_LOOKUP_LYRICSignore
23059MCC_COVER_ART_GET_ARTIST_IMAGES_FROM_LAST_FMignore
23060MCC_COVER_ART_GET_COMPOSER_IMAGES_FROM_GOOGLEignore
23061MCC_LOOKUP_DATEignore
23062MCC_LOCK_PLAYLISTint nPlaylistID
23063MCC_UNLOCK_PLAYLISTint nPlaylistID
23064MCC_GET_SHARING_URLignore
23065MCC_UNSHAREignore

Help

Range: 24,000 to 25,000

EnumCommandParameter
24000MCC_HELP_CONTENTSignore
24001MCC_HELP_HOWTO_IMPORT_FILESignore
24002MCC_HELP_HOWTO_PLAY_FILESignore
24003MCC_HELP_HOWTO_RIPignore
24004MCC_HELP_HOWTO_BURNignore
24005MCC_HELP_HOWTO_ORGANIZE_FILESignore
24006MCC_HELP_HOWTO_VIEW_SCHEMESignore
24007MCC_HELP_HOWTO_MANAGE_PLAYLISTSignore
24008MCC_HELP_HOWTO_EDIT_PROPERTIESignore
24009MCC_HELP_HOWTO_FINDignore
24010MCC_HELP_HOWTO_CONFIGUREignore
24011MCC_CHECK_FOR_UPDATESignore
24012MCC_BUYignore
24013MCC_INSTALL_LICENSEignore
24014MCC_REGISTRATION_INFOignore
24015MCC_PLUS_FEATURESignore
24016MCC_INTERACTignore
24017MCC_SYSTEM_INFOignore
24018MCC_ABOUTignore
24019MCC_CONFIGURE_DEBUG_LOGGINGignore
24020MCC_WIKIignore
24021MCC_TESTignore
24022MCC_SHOW_EULAignore
24023MCC_BENCHMARKignore
24024MCC_UPGRADE_TO_MASTER_LICENSEignore

Tree

Range: 25,000 to 26,000

EnumCommandParameter
25000MCC_ADD_VIEW_SCHEMEignore
25001MCC_EDIT_VIEW_SCHEMEignore
25002MCC_OBSOLETE_25002ignore
25003MCC_OBSOLETE_25003ignore
25004MCC_OBSOLETE_25004ignore
25005MCC_OBSOLETE_25005ignore
25006MCC_OBSOLETE_25006ignore
25007MCC_OBSOLETE_25007ignore
25008MCC_TREE_ADD_DIRECTORYignore
25009MCC_TREE_IMPORTignore
25010MCC_TREE_ADD_CD_FOLDERignore
25011MCC_UPDATE_FROM_CD_DATABASEignore
25012MCC_SUBMIT_TO_CD_DATABASEignore
25013MCC_TREE_RIPignore
25014MCC_CLEAR_PLAYING_NOW0: all files; 1: leave playing file
25015MCC_COPY_LISTENING_TObool bPaste
25016MCC_TREE_SET_EXPANDED0: collapsed; 1: expanded
25017MCC_RESET_VIEW_SCHEMESignore
25018MCC_TREE_ERASE_CD_DVDignore
25019MCC_UPDATE_FROM_CDPLAYER_INIignore
25020MCC_TREE_EJECTignore
25021MCC_TREE_ADD_VIRTUAL_DEVICEignore
25022MCC_TREE_RENAME_PLAYLISTint nPlaylistID
25023MCC_TWITTER_LISTENING_TOignore
25024MCC_SCROBBLE_LISTENING_TOignore
25025MCC_TREE_OPEN_DIRECTORY_IN_FILE_MANAGERignore

List

Range: 26,000 to 27,000

EnumCommandParameter
26000MCC_LIST_UPDATE_ORDERignore
26001MCC_LIST_SHUFFLE_ORDERignore
26002MCC_LIST_IMPORTignore
26003MCC_LIST_REMOVE_ORDERignore
26004MCC_LOCATE_FILEint nLocation (-1: on disk (internal); -2: on disk (external); 0-n: library field index)
26005MCC_LIST_OBSOLETE_26005ignore
26006MCC_LIST_INCREMENT_SELECTIONint nDelta
26007MCC_LIST_REMOVE_DUPLICATESignore
26008MCC_LIST_AUTO_SIZE_COLUMNint nColumn, zero-based column index (-1: all)
26009MCC_LIST_CUSTOMIZE_VIEWignore
26010MCC_LIST_COPY_DISK_FILESignore
26011MCC_LIST_SET_RIP_CHECK0: uncheck, 1: check, -1: toggle
26012MCC_LIST_DOWNLOADignore
26013MCC_LIST_GET_LIST_POINTERignore
26014MCC_LOCATE_STACKignore
26015MCC_SET_AS_STACK_TOPignore
26016MCC_EXPAND_STACKignore
26017MCC_COLLAPSE_STACKignore
26018MCC_AUTOSTACK0: by name, 1: artist, album, name, 2: Artist, Album, Track # and Name
26019MCC_CHECK_STACKSignore
26020MCC_STACKint nZeroBasedSelection
26021MCC_UNSTACKignore
26022MCC_ADD_TO_STACKignore
26023MCC_PANE_RESET_SELECTIONint nPaneIndex (-1 resets all)
26024MCC_LIST_REMOVE_ALLignore
26025MCC_LIST_LOCKbool bLock (-1 toggles)
26026MCC_PANE_SET_EXPANDEDloword: nPaneIndex, hiword: 0: collapsed; 1: expanded
26031MCC_LIST_SEND_TO_PLAYING_NOWSENDTO_PLAYING_NOW_TYPES Type
26032MCC_LIST_SELECT_RANDOMignore

System

Range: 27,000 to 28,000

EnumCommandParameter
27000MCC_KEYSTROKEint nKeyCode
27001MCC_SHUTDOWNint nMode (0: shutdown; 1: sleep; 2: hibernate; 3: restart) (based on CSystemShutdown::EShutdownModes)

Playback Engine

Range: 28,000 to 29,000

EnumCommandParameter
28000MCC_PLAYBACK_ENGINE_ZOOM_INignore
28001MCC_PLAYBACK_ENGINE_ZOOM_OUTignore
28002MCC_PLAYBACK_ENGINE_UPignore
28003MCC_PLAYBACK_ENGINE_DOWNignore
28004MCC_PLAYBACK_ENGINE_LEFTignore
28005MCC_PLAYBACK_ENGINE_RIGHTignore
28006MCC_PLAYBACK_ENGINE_ENTERignore
28007MCC_PLAYBACK_ENGINE_FIRSTignore
28008MCC_PLAYBACK_ENGINE_LASTignore
28009MCC_PLAYBACK_ENGINE_NEXTignore
28010MCC_PLAYBACK_ENGINE_PREVIOUSignore
28011MCC_PLAYBACK_ENGINE_PAUSEbool bPause (-1 toggles)
28012MCC_IMAGE_PAN_AND_ZOOMbool bPanAndZoom (-1 toggles)
28013MCC_IMAGE_TOGGLE_EFFECTint nDelta
28014MCC_IMAGE_RAPID_ZOOMint nRapidZoom
28015MCC_DVD_SET_AUDIO_STREAMint nAudioStream (-1 toggles)
28016MCC_DVD_SHOW_MENUignore
28017MCC_TV_RECORDignore
28018MCC_TV_SNAPSHOTignore
28019MCC_TV_CHANGE_STANDARDignore
28020MCC_PLAYBACK_ENGINE_OSD_VIDEO_PROC_AMPint nIndex (0 for brightness, 1 for contrast, etc. -1 cycles)
28021MCC_PLAYBACK_ENGINE_SET_CUR_VIDEO_PROC_AMPint nStep (... -2, -1, 1, 2, etc. 0 is invalid and will default to 1)
28022MCC_PLAYBACK_ENGINE_SET_ASPECT_RATIO-1: cycles; 0 - 8: selects individual Aspect Ratio Modes
28023MCC_PLAYBACK_ENGINE_SCROLL_UPignore
28024MCC_PLAYBACK_ENGINE_SCROLL_DOWNignore
28025MCC_PLAYBACK_ENGINE_SCROLL_LEFTignore
28026MCC_PLAYBACK_ENGINE_SCROLL_RIGHTignore
28027MCC_TV_SET_SAVE_TIME_SHIFTINGint nSaveMode (0 - 6, -1 cycles by incrementing, -2 cycles by decrementing)
28028MCC_PLAYBACK_ENGINE_ZOOM_TO_PRESETint 0 to fit window, 1 for 100%, 2 for 200%
28029MCC_TV_SCAN_PROGRAMMING_EVENTSignored
28030MCC_TV_CHANGE_CHANNEL_KEYint nKey
28031MCC_TV_PLAY_CHANNEL_POSITIONint Playlist position
28032MCC_PLAYBACK_ENGINE_SET_SUBTITLESint nIndex (-1 toggles forward, -2 toggles backwards, -3 to browse for subtitles)
28033MCC_PLAYBACK_ENGINE_SET_AUDIO_STREAMint nIndex (-1 toggles forward, -2 toggles backwards)
28034MCC_PLAYBACK_ENGINE_SET_VIDEO_STREAMint nIndex (-1 toggles forward, -2 toggles backwards)
28035MCC_PLAYBACK_ENGINE_VIDEO_SCREEN_GRAB0: use as thumbnail; 1: save as external file
28036MCC_PLAYBACK_ENGINE_VIDEO_LIPSYNCint nShiftMS
28037MCC_PLAYBACK_ENGINE_SET_SUBTITLE_TIMINGint nChangeMS
28038MCC_PLAYBACK_ENGINE_VIDEO_ZOOMint nZoomAmount (100 is 1.0)
28039MCC_IMAGE_SET_FOCUSignore
25040MCC_STEP_FORWARD_FRAMESint nNumOfFrames (0 is special and default when no parameter is passed - to the next Keyframe)
28041MCC_STEP_BACK_FRAMESint nNumOfFrames (0 is special and default when no parameter is passed - to the previous Keyframe)
28042MCC_PLAYBACK_ENGINE_TOGGLE_COMSKIPignore
28043MCC_PLAYBACK_ENGINE_HIDE_OSDignore
28044MCC_PLAYBACK_ENGINE_VIDEO_LIPSYNC_ZONEint nShiftMS, positive or negative increment, zero to reset to 0. Value is saved in zone setting
28045MCC_BLURAY_SHOW_POPUP_MENUignore
28046MCC_PLAYBACK_ENGINE_SETTINGS_CHANGEDignore

Other

Range: 30,000 to 31,000

EnumCommandParameter
30000MCC_RELOAD_MC_VIEWignore
30001MCC_CUSTOMIZE_TOOLBARignore
30002MCC_PLAY_TVint nChannelNumber, user assigned channel number
30003MCC_UPDATE_WEBPAGESignore
30004MCC_SHOW_RUNNING_MCbool bToggleVisibility
30005MCC_SHOW_MENUint nMenuID
30006MCC_TUNE_TVignore
30007MCC_PLAY_PLAYLISTint nPlaylistID
30008MCC_SENDTO_TOOL0: labeler; 1: media editor; 2: default editor; 3: ftp upload; 4: email; 5 Menalto Gallery; 6 Web Gallery
30009MCC_SHOW_VIEW_INFOnew CMCViewInfo * (for internal use only)
30010MCC_OBSOLETE_30010ignore
30011MCC_DEVICE_CHANGEDnew DEVICE_CHANGE_INFO * (for internal use only)
30012MCC_CONFIGURE_THEATER_VIEWignore
30013MCC_SET_STATUSTEXTBSTR bstrText (deleted by receiver)
30014MCC_UPDATE_UI_AFTER_ACTIVE_WINDOW_CHANGEignore
30015MCC_REENUM_PORTABLE_DEVICESbool bDeviceConnected
30016MCC_PLAY_ADVANCEDPLAY_COMMAND * pCommand (deleted by receiver)
30017MCC_UPDATE_STATUS_BARignore
30018MCC_REQUEST_PODCAST_UPDATEignore
30019MCC_REQUEST_PODCAST_PURGEignore
30020MCC_OBSOLETE_30020ignore
30021MCC_SHOW_INVALID_CD_VOLUME_WARNINGTCHAR cDriveLetter
30022MCC_PLAY_TV_CHANNEL_FOR_CLIENTthe MFKEY key of the TV channel to be played
30023MCC_STOP_SERVING_TV_FILECTVPlayer *: pointer to TVPlayer object serving the file
30025MCC_SET_OSD_ENABLED-1 toggles, 1 turns on, 0 turns off (/mcc 30025,-1)
30026MCC_TOGGLE_THEATER_VIEW_GRIDS_CHANNEL_NAMEignore
30027MCC_PASTE_PLAYING_NOW_IMAGE_FROM_CLIPBOARDint nZoneID
30028MCC_SHOW_SERVER_PRESENTATION_WEBPAGEint nDeviceSessionID
30029MCC_PLAY_TRAILERignore
30030MCC_MOVE_TABint nDelta
30031MCC_CHECK_LOADEDignore
30032MCC_RELAUNCH_PROGRAMignore

Image Tools

Range: 31,000 to 32,000

EnumCommandParameter
31000MCC_IMAGE_SET_DESKTOP_BACKignore
31001MCC_IMAGE_ROTATE_LEFTignore
31002MCC_IMAGE_ROTATE_RIGHTignore
31003MCC_IMAGE_ROTATE_UPSIDEDOWNignore
31004MCC_IMAGE_RESIZEignore
31005MCC_IMAGE_EDITint nFileKey
31006MCC_IMAGE_DELETEint nFileKey
31007MCC_IMAGE_PREVIEW_SHOWignore
31008MCC_IMAGE_PREVIEW_HIDEignore
31009MCC_IMAGE_LOCATE_ON_MAPignore

Query

Range: 32,000 to 33,000

EnumCommandParameter
32000MCC_QUERY_UI_MODEbool bInternalMode; Exit status is current UI_MODES
32001MCC_QUERY_WEBPAGE_VIEWignore

Commands

Range: 33,000 to 34,000

Note: These are used internally; standard routing.

EnumCommandParameter
33000MCC_GET_SELECTED_FILESloword: GET_SELECTION_MODES Mode, hiword: short nFlags (1: for playback)
33001MCC_PRINTVIEWignore
33002MCC_OUTPUTint nPlaylistID (-1 for active view)
33003MCC_SETFOCUSignore
33004MCC_SELECT_FILESCMediaArray *
33005MCC_DOUBLE_CLICKignore
33006MCC_PLAY_OR_SHOWignore
33007MCC_SHOW_CURRENT_FILEint nFlags (1: force, 2: select)
33008MCC_BUY_SELECTED_TRACKSint nPurchaseFlags
33009MCC_BUY_ALL_TRACKSint nPurchaseFlags
33010MCC_BUY_ALBUMint nPurchaseFlags
33011MCC_UPDATE_AFTER_PLUGIN_INSTALLEDignore
33012MCC_UPDATE_AFTER_SKIN_INSTALLEDbool bMiniView

Notifications

Range: 34,000 to 35,000

Note: These are used internally; routed to all view windows.

EnumCommandParameter
34000MCC_NOTIFY_FONT_CHANGEDignore
34001MCC_NOTIFY_VIEW_CHANGEDignore
34002MCC_NOTIFY_BEFORE_ACTIVE_VIEW_CHANGEDignore
34003MCC_NOTIFY_ACTIVE_VIEW_CHANGEDignore
34004MCC_NOTIFY_PLAYER_INFO_CHANGEDPLAYER_INFO_CHANGES nChange
34005MCC_NOTIFY_TOOLTIPS_CHANGEDbool bEnabled
34006MCC_NOTIFY_OPTIONS_CHANGEDignore
34007MCC_UPDATEint nFlags
34008MCC_NOTIFY_FOCUS_CHANGEDignore
34009MCC_SAVE_PROPERTIESignore
34010MCC_NOTIFY_UI_MODE_CHANGEDUI_MODES NewMode
34011MCC_NOTIFY_SELECTION_CHANGEDint nViewKey
34012MCC_NOTIFY_FILE_CHANGEDint nFileKey (-1: invalidates all files)
34013MCC_NOTIFY_FILE_STATUS_CHANGEDint nFileKey (-1: invalidates all files)
34014MCC_NOTIFY_FILE_ENSURE_VISIBLEint nFileKey
34015MCC_NOTIFY_GET_TAB_HWNDSignore
34016MCC_NOTIFY_BURNER_QUEUE_CHANGEDint nFlags (1: folder change)
34017MCC_NOTIFY_BURNER_PROGRESS_CHANGEDint nPercentage
34018MCC_NOTIFY_BURNER_STATUS_CHANGEDignore
34019MCC_NOTIFY_BURNER_STARTEDignore
34020MCC_NOTIFY_BURNER_FINISHED_INTERNALignore
34021MCC_NOTIFY_BURNER_FINISHEDignore
34022MCC_NOTIFY_BURNER_FAILED_INTERNALignore
34023MCC_NOTIFY_BURNER_FAILEDignore
34024MCC_NOTIFY_BURNER_CLOSE_UIignore
34025MCC_NOTIFY_BURNER_PREPARE_FOR_NEXT_COPYLPCTSTR pStatus
34026MCC_NOTIFY_RIP_STARTEDignore
34027MCC_NOTIFY_RIP_FINISHEDignore
34028MCC_NOTIFY_RIP_FAILEDLPCTSTR pError
34029MCC_NOTIFY_RIP_PROGRESS_CHANGEDignore
34030MCC_NOTIFY_RIP_QUEUE_CHANGEDignore
34031MCC_NOTIFY_DVD_RIP_STARTEDignore
34032MCC_NOTIFY_DVD_RIP_FINISHEDignore
34033MCC_NOTIFY_DVD_RIP_FAILEDint nErrorCode
34034MCC_NOTIFY_DVD_RIP_PROGRESS_CHANGEDint nPercent
34035MCC_NOTIFY_DOWNLOAD_FINISHEDint nFileKey (-1: unknown)
34036MCC_NOTIFY_DOWNLOAD_FAILEDint nFileKey (-1: unknown)
34037MCC_NOTIFY_DOWNLOAD_STATUS_CHANGEDignore
34038MCC_NOTIFY_STATUS_CHECKER_COMPLETEignore
34039MCC_NOTIFY_CURRENT_ZONE_CHANGEDignore
34040MCC_NOTIFY_DISPLAY_OWNER_CHANGEDJRWnd * pwndOwner
34041MCC_NOTIFY_AFTER_FIRST_UPDATE_LAYOUT_WINDOWignore
34042MCC_NOTIFY_AFTER_FIRST_UPDATE_APPLY_VIEW_STATEignore
34043MCC_NOTIFY_PROCESS_TIME_REMAININGint nSecondsRemaining
34044MCC_NOTIFY_UI_UPDATE_ENABLE_DISABLE_STATESignore
34045MCC_NOTIFY_UI_SKIN_CHANGEDignore
34046MCC_UPDATE_WINDOW_LAYOUTignore
34047MCC_NOTIFY_SAVE_UI_BEFORE_SHUTDOWNignore
34048MCC_OBSOLETE_34046ignore
34049MCC_NOTIFY_PLAYLIST_FILES_CHANGEDint nPlaylistID
34050MCC_NOTIFY_PLAYLIST_INFO_CHANGEDint nPlaylistID
34051MCC_NOTIFY_PLAYLIST_ADDED_INTERNALint nPlaylistID
34052MCC_NOTIFY_PLAYLIST_ADDED_BY_USERint nPlaylistID
34053MCC_NOTIFY_PLAYLIST_REMOVEDint nPlaylistID
34054MCC_NOTIFY_PLAYLIST_COLLECTION_CHANGEDignore
34055MCC_NOTIFY_PLAYLIST_PROPERTIES_CHANGEDint nPlaylistID
34056MCC_NOTIFY_HANDHELD_UPLOAD_STARTEDint nDeviceSessionID (0 gets default)
34057MCC_NOTIFY_HANDHELD_AFTER_DEVICE_CHANGEDignore
34058MCC_NOTIFY_HANDHELD_QUEUE_CHANGEDignore
34059MCC_NOTIFY_HANDHELD_INFO_COMPLETEignore
34060MCC_NOTIFY_HANDHELD_AFTER_UPLOAD_FINISHEDignore
34061MCC_NOTIFY_COMPACT_MEMORYignore
34062MCC_NOTIFY_SEARCH_CHANGEDignore
34063MCC_NOTIFY_SEARCH_CONTEXT_CHANGEDignore
34064MCC_NOTIFY_UPDATE_SHOPPING_CARTJRStoreBase * pStore
34065MCC_NOTIFY_UPDATE_NAVIGATION_TRAILignore
34066MCC_NOTIFY_IMPORT_STARTEDbool bSilent
34067MCC_NOTIFY_IMPORT_FINISHEDbool bSilent
34068MCC_NOTIFY_ROTATED_IMAGESMFKEY nKey
34069MCC_NOTIFY_LOGIN_STATE_CHANGEbool bLoggedIn
34070MCC_NOTIFY_MYGAL_PROGRESSignore
34071MCC_NOTIFY_MYGAL_DONEignore
34072MCC_NOTIFY_PODCAST_CHANGEDignore
34073MCC_NOTIFY_PODCAST_SETTINGS_CHANGEDignore
34074MCC_NOTIFY_CONVERT_PROGRESSignore
34075MCC_NOTIFY_CONVERT_UPDATEignore
34076MCC_NOTIFY_BREADCRUMBS_CHANGEDignore
34077MCC_NOTIFY_UI_LANGUAGE_CHANGEDignore
34078MCC_NOTIFY_INSTALLED_PLUGINS_CHANGEDignore
34079MCC_NOTIFY_SUGGESTED_MUSIC_CHANGEDignore
34080MCC_NOTIFY_VIEW_SETTINGS_CHANGEDint nFlags
34081MCC_NOTIFY_BEFORE_CONFIGURE_VIEW_SETTINGSignore
34082MCC_NOTIFY_TV_RECORDING_CHANGEDignore
34083MCC_NOTIFY_TV_PROGRAMMING_GUIDE_CHANGEDignore
34084MCC_NOTIFY_TV_CHANNELS_CHANGEDignore
34085MCC_NOTIFY_TV_RECORDING_STARTEDignore
34086MCC_NOTIFY_TV_RECORDING_FINISHEDignore
34087MCC_NOTIFY_IMPORT_FILES_ADDEDignore
34088MCC_NOTIFY_PLAYBACK_OPTIONS_CHANGEDignore
34089MCC_NOTIFY_BEFORE_LAYOUT_USER_INTERFACEignore
34090MCC_NOTIFY_AFTER_LAYOUT_USER_INTERFACEignore
34091MCC_NOTIFY_ZONE_ADDED_OR_REMOVEDint nZoneID (PLAYER_ZONE_ID_UNDEFINED means multiple changes)
34092MCC_NOTIFY_ZONE_LINKED_OR_UNLINKEDignore
34093MCC_NOTIFY_LIBRARY_LOCATIONS_CHANGEDignore
34094MCC_NOTIFY_DSP_SETTINGS_CHANGED_IN_CODEint nZoneID
34095MCC_NOTIFY_OPTICAL_DISC_CHANGEDignore
34096MCC_NOTIFY_STORE_DOWNLOAD_STATUS_CHANGEDint nStoreNumber
34097MCC_NOTIFY_CURRENT_PLAYLIST_NEXT_ITEM_TO_PLAY_CHANGEDint nZone
34098MCC_NOTIFY_CONTENT_UPLOAD_PROGRESSignore
34099MCC_NOTIFY_CONTENT_UPLOAD_UPDATEint nEnsureVisibleColumn (if nEnsureVisibleColumn > 0, call EnsureVisible() on the list control)
34100MCC_NOTIFY_TV_PROPERTIES_CHANGEDignore
34101MCC_NOTIFY_STATUSBAR_TEXT_CHANGEDignore

Store

Range: 35,000 to 36,000

EnumCommandParameter
35000MCC_STORE_DOWNLOADbool bAllowPurchaseType
35001MCC_STORE_PURCHASEMFKEY nKey
35002MCC_STORE_SEARCH_AMAZONMFKEY nKey
35003MCC_STORE_SEARCH_AMAZON_MP3_STOREMFKEY nKey
35004MCC_OBSOLETE_35004ignore
35005MCC_STORE_CHANGE_USERignore
35006MCC_STORE_CHECK_FOR_DOWNLOADSignore

Defines

// return value for unhandled MCC commands
#define MCC_UNHANDLED 0

// flags for command enable, disable, and check
enum MCC_UPDATEUI_FLAGS
{
    MCC_UPDATEUI_ENABLE = 1,
    MCC_UPDATEUI_DISABLE = 2,
    MCC_UPDATEUI_PRESSED = 4,
};

// update flags
#define MCC_UPDATE_FLAG_THUMBNAILS                           (1 << 0)
#define MCC_UPDATE_FLAG_FILE_PROPERTIES                      (1 << 1)
#define MCC_UPDATE_FLAG_FILE_ADDED_OR_REMOVED                (1 << 2)
#define MCC_UPDATE_FLAG_TREE_STRUCTURE                       (1 << 3)
#define MCC_UPDATE_FLAG_REFILL_LIST                          (1 << 4)
#define MCC_UPDATE_FLAG_ITEM_DELETED                         (1 << 5)
#define MCC_UPDATE_FLAG_NO_PRESERVE_VIEW_STATE               (1 << 6)
#define MCC_UPDATE_FLAG_WEB_VIEW                             (1 << 7)

// update all
#define MCC_UPDATE_FLAG_ALL                                  (0x7FFFFFFF & ~(MCC_UPDATE_FLAG_NO_PRESERVE_VIEW_STATE))

// settings changed flags
#define MCC_SETTING_CHANGED_FLAG_UNKNOWN                    (1 << 0)
#define MCC_SETTING_CHANGED_FLAG_COLUMNS                    (1 << 1)
#define MCC_SETTING_CHANGED_FLAG_SORTING                    (1 << 2)
#define MCC_SETTING_CHANGED_FLAG_VIEW_SCHEME                (1 << 3)
#define MCC_SETTING_CHANGED_FLAG_GROUPING                   (1 << 5)
#define MCC_SETTING_CHANGED_FLAG_LIBRARY_VIEW_SETTINGS      (1 << 6)

// UI modes
enum UI_MODES
{
    // unknown
    UI_MODE_UNKNOWN = -2000,

    // internal modes
    UI_MODE_INTERNAL_NO_UI = -1000,
    UI_MODE_INTERNAL_STANDARD = 0,
    UI_MODE_INTERNAL_MINI_FREEFORM = 1,
    UI_MODE_INTERNAL_MINI_SLIM = 2,
    UI_MODE_INTERNAL_DISPLAY_WINDOWED = 3,
    UI_MODE_INTERNAL_DISPLAY_FULLSCREEN = 4,
    UI_MODE_INTERNAL_THEATER = 5,
    UI_MODE_INTERNAL_COVER = 6,

    // toggles, shortcuts, etc.
    UI_MODE_SHORTCUT_TEMPORARY_DISPLAY_WINDOWED = -8,
    UI_MODE_SHORTCUT_TOGGLE_DISPLAY_AND_LAST_USER_INPUT_MODE = -7,
    UI_MODE_SHORTCUT_TOGGLE_DISPLAY_EXCLUDE_THEATER_VIEW = -6,
    UI_MODE_SHORTCUT_TOGGLE_DISPLAY = -5,
    UI_MODE_SHORTCUT_LAST_SHUTDOWN = -4,
    UI_MODE_SHORTCUT_CURRENT = -3,
    UI_MODE_SHORTCUT_CLOSE_DISPLAY = -2,
    UI_MODE_SHORTCUT_NEXT = -1,

    // modes presented to the user
    UI_MODE_STANDARD = 0,
    UI_MODE_MINI = 1,
    UI_MODE_DISPLAY = 2,
    UI_MODE_THEATER = 3,
    UI_MODE_COVER = 4,
    UI_MODE_COUNT = 5,
};

// player changes
#define PLAYER_INFO_CHANGE_ALL                               0xFFFF
#define PLAYER_INFO_CHANGE_PLAYER_STATE                      (1 << 0)
#define PLAYER_INFO_CHANGE_VOLUME                            (1 << 1)
#define PLAYER_INFO_CHANGE_FILE_INFO                         (1 << 2)
#define PLAYER_INFO_CHANGE_PLAYLIST                          (1 << 3)
#define PLAYER_INFO_CHANGE_DSP                               (1 << 4)
#define PLAYER_INFO_CHANGE_IMAGE                             (1 << 5)
#define PLAYER_INFO_CHANGE_PLAYING_FILE                      (1 << 6)
#define PLAYER_INFO_CHANGE_OUTPUT_INFO                       (1 << 7)

// player status codes
enum PLAYER_STATUS_CODES
{
    PLAYER_STATUS_CODE_BUFFERING,
    PLAYER_STATUS_CODE_LOCATING,
    PLAYER_STATUS_CODE_CONNECTING,
    PLAYER_STATUS_CODE_DOWNLOADING_CODEC,
    PLAYER_STATUS_CODE_ACQUIRING_LICENSE,
    PLAYER_STATUS_CODE_INDIVIDUALIZE_STARTING,
    PLAYER_STATUS_CODE_INDIVIDUALIZE_CONNECTING,
    PLAYER_STATUS_CODE_INDIVIDUALIZE_REQUESTING,
    PLAYER_STATUS_CODE_INDIVIDUALIZE_RECEIVING,
    PLAYER_STATUS_CODE_INDIVIDUALIZE_COMPLETED,
};

// theater view modes
enum SHOW_THEATER_VIEW_MODES
{
    SHOW_THEATER_VIEW_MODE_TOGGLE_THEATER_VIEW,
    SHOW_THEATER_VIEW_MODE_HOME,
    SHOW_THEATER_VIEW_MODE_PLAYING_NOW,
    SHOW_THEATER_VIEW_MODE_AUDIO,
    SHOW_THEATER_VIEW_MODE_IMAGES,
    SHOW_THEATER_VIEW_MODE_VIDEOS,
    SHOW_THEATER_VIEW_MODE_PLAYLISTS,
    SHOW_THEATER_VIEW_MODE_CD_DVD,
    SHOW_THEATER_VIEW_MODE_TELEVISION,
    SHOW_THEATER_VIEW_MODE_TELEVISION_GUIDE,
    SHOW_THEATER_VIEW_MODE_TELEVISION_RECORDINGS,
    SHOW_THEATER_VIEW_MODE_LAST_VIEWED,
};

// get selection modes
enum GET_SELECTION_MODES
{
    GET_SELECTION_EXACT,
    GET_SELECTION_ALL_ON_NONE,
    GET_SELECTION_ALL_ON_ONE_OR_NONE,
    GET_SELECTION_ALL,
    GET_SELECTION_EXACT_WITH_POSITION,
};

// skip to modes
enum SKIP_TO_MODES
{
    SKIP_TO_UNDEFINED = 0,
    SKIP_TO_PREVIOUS_ALBUM,
    SKIP_TO_NEXT_ALBUM,
    SKIP_TO_PREVIOUS_ARTIST,
    SKIP_TO_NEXT_ARTIST,
};

Specifying Zones

Media Center Core Commands are targeted to a specific playback zone by combining the command's parameter value with the zone specifier value from the Zone Specifiers table. MC zones are integer indexes, from 0 to n, where 0 is the the first local zone, 1 is the second local zone, and so on. Remote zones, such as those for DLNA devices, will not be contiguous with local zones. A list of zones can be obtained using the MCWS command:

http://<server IP>:52199/MCWS/v1/Playback/Zones

MC version 16.0.118 has simplified command line specification of parameter and zone, eliminating the need for manual calculations prior to usage. The /MCC option now accepts an alternate syntax in the format of [value]:[zone index] for the parameter (see examples). The text that follows documents and describes the original (and still valid) specification, which would be used when issuing an MCC command through a mechanism other than the MC18.exe command.

Zone Specifiers
Zone Decimal Hexidecimal
Current 0 0x00000000
0 16777216 0x01000000
1 33554432 0x02000000
2 50331648 0x03000000
3 67108864 0x04000000
4 83886080 0x05000000
5 100663296 0x06000000
... ... ...
30 260046848 0x1F000000
31 520093696 0x20000000

Technically speaking, the command's parameter is OR'd with the zone specifier value, where bits 0 - 23 specify the command parameter, and bits 24 - 29 specify the zone. For command line usage, the final parameter value to pass to Media Center can be calculated as follows:

  • If the parameter is >= 0, the final value = zone specifier + parameter
  • If the parameter is <   0, the final value = zone specifier + parameter + 16777216

Examples

  • Increase volume to 25% for Zone 2 (new parameter specification available starting with MC 16.0.118)
    • MC18.exe /MCC 10020,25:2
  • Increase volume to 25% for Zone 2
    • The MCC_VOLUME_SET command has command number 10020
    • The desired parameter value is 25
    • Zone 2 in the Zone Specifier table indicates a value of 50331648 (0x03000000 hex)
    • Zone specifier (50331648) + parameter value (25) = 50331673 (0x3000019 hex)
  • Toggle pause for Zone 3
    • The MCC_SET_PAUSE command has command number 10022
    • The desired parameter value is -1 (toggles)
    • Zone 3 in the Zone Specifier table indicates a value of 67108864 (0x04000000 hex)
    • Zone specifier (67108864) + parameter value (-1) + 16777216 = 83886079 (0x4FFFFFF hex)

Notes

  • When bit 32 is set, the zone portion is ignored, and Media Center assumes the parameter is a negative number.
  • See the C++ macros below for more information.


The look-up table below shows some pre-calculated parameter values for each of zones 0 through 5 for some typical commands. Find the desired operation, command and command number, and select the cell under the desired zone to obtain the final parameter value.

Example commands / parameter / zone look-up table
Operation MCC Command Command
Number		 Parameter
Value		 Zone 0 Zone 1 Zone 2 Zone 3 Zone 4 Zone 5
Play / Pause MCC_PLAY_PAUSE 10000 0 16777216 33554432 50331648 67108864 83886080 100663296
Play track from start MCC_PLAY 10001 0 16777216 33554432 50331648 67108864 83886080 100663296
Stop MCC_STOP 10002 0 16777216 33554432 50331648 67108864 83886080 100663296
Next MCC_NEXT 10003 0 16777216 33554432 50331648 67108864 83886080 100663296
Previous MCC_PREVIOUS 10004 0 16777216 33554432 50331648 67108864 83886080 100663296
Toggle shuffle mode MCC_SHUFFLE 10005 0 16777216 33554432 50331648 67108864 83886080 100663296
Shuffle - jump to PN MCC_SHUFFLE 10005 1 16777217 33554433 50331649 67108865 83886081 100663297
Shuffle - no jump to PN MCC_SHUFFLE 10005 2 16777218 33554434 50331650 67108866 83886082 100663298
Toggle continuous mode MCC_CONTINUOUS 10006 0 16777216 33554432 50331648 67108864 83886080 100663296
FF MCC_FAST_FORWARD 10008 0 16777216 33554432 50331648 67108864 83886080 100663296
Rew MCC_REWIND 10009 0 16777216 33554432 50331648 67108864 83886080 100663296
Play sequence # MCC_PLAY_CPLDB_INDEX 10015 0 16777216 33554432 50331648 67108864 83886080 100663296
Mute MCC_VOLUME_MUTE 10017 0 16777216 33554432 50331648 67108864 83886080 100663296
Vol +5 MCC_VOLUME_UP 10018 5 16777221 33554437 50331653 67108869 83886085 100663301
Vol -5 MCC_VOLUME_DOWN 10019 5 16777221 33554437 50331653 67108869 83886085 100663301
Vol 0 MCC_VOLUME_SET 10020 0 16777216 33554432 50331648 67108864 83886080 100663296
Vol 25 MCC_VOLUME_SET 10020 25 16777241 33554457 50331673 67108889 83886105 100663321
Vol 50 MCC_VOLUME_SET 10020 50 16777266 33554482 50331698 67108914 83886130 100663346
Vol 75 MCC_VOLUME_SET 10020 75 16777291 33554507 50331723 67108939 83886155 100663371
Vol 100 MCC_VOLUME_SET 10020 100 16777316 33554532 50331748 67108964 83886180 100663396
Toggle pause MCC_SET_PAUSE 10022 -1 33554431 50331647 67108863 83886079 100663295 117440511
Rating clear MCC_SET_CURRENTLY_PLAYING_RATING 10023 0 16777216 33554432 50331648 67108864 83886080 100663296
Rating 1 MCC_SET_CURRENTLY_PLAYING_RATING 10023 1 16777217 33554433 50331649 67108865 83886081 100663297
Rating 2 MCC_SET_CURRENTLY_PLAYING_RATING 10023 2 16777218 33554434 50331650 67108866 83886082 100663298
Rating 3 MCC_SET_CURRENTLY_PLAYING_RATING 10023 3 16777219 33554435 50331651 67108867 83886083 100663299
Rating 4 MCC_SET_CURRENTLY_PLAYING_RATING 10023 4 16777220 33554436 50331652 67108868 83886084 100663300
Rating 5 MCC_SET_CURRENTLY_PLAYING_RATING 10023 5 16777221 33554437 50331653 67108869 83886085 100663301
Retrieved from "https://wiki.jriver.com/index.php?title=Media_Center_Core_Commands&oldid=17827"