Overview

Command-line options allow you to specify startup options that are different from the settings currently defined in "MediaPortal Configuration". This allows you to create shortcuts to start MediaPortal with different settings for different users, or to start MediaPortal with one set of options for your PC screen, and another set of options for your HDTV (if you are using it as a secondary monitor).

MediaPortal Options

MediaPortal.exe

The available command-line options are show below. Note that the option names are case-sensitive, and must be specified with the correct mixture of upper and lower case.

• /fullscreen or /fullscreen=yes - starts MP in fullscreen mode.
• /windowed or /fullscreen=no - starts MP in windowed mode. 
• /screen=X - starts MP on screen number X.  /screen=0 starts MP on the primary screen, and /screen=1 starts MP on the secondary screen.
• /skin=XX - specifies the name of the skin that MP is to use. Enclose the name in double quotes if the name contains blanks or other special characters. Examples: /skin=Titan or /skin="Black Glass".
• /config=xxx - specifies the name of a custom configuration file, either:
  • The name of an xml file located in the same folder as the default configuration file "MediaPortal.xml". The default folder for the configuration file is "C:\ProgramData\Team MediaPortal\MediaPortal".
  • The path to an alternative location for "MediaPortal.xml".
• /SkinProperties - starts MP with the "Properties Monitor" active in a separate window. Note the use of mixed case in the name of this option.
• /crashtest - simulates MP crashing.

Most of these options can be used together, for example: 

  MediaPortal.exe /fullscreen /screen=1 /skin="DefaultWide"

If you are using the "Properties Monitor", it can be convenient to start MP windowed, so that you can see both the MP window and the properties window:

  MediaPortal.exe /SkinProperties /windowed

Configuration.exe

• To open Configuration to a specific section:
  • Configuration.exe /section=xxx  (where xxx is the section you wish to open to)
• To add a DebugOptions item to TV Configuration (for advanced testers only!):
  • Configuration.exe /debugoptions
• To install MediaPortal 'silently':
  • Configuration.exe --deploymode

TV Server

TvService.exe

• TvService.exe /install
• TvService.exe /uninstall
• TvService.exe /debug

SetupTv.exe

• To delete the database:
  • SetupTv.exe /delete-db
• To configure TV Server:
  • SetupTv.exe /configure-db
• To add Debug Options:
  • SetupTv.exe /debugoptions - provides an additional item in TV Server Configuration called Debug Options - only for advanced testers and developers.
• To install TV Server
  • SetupTv.exe --DeployMode
  • SetupTv.exe --DeploySql
  • SetupTv.exe --DeployPwd