Command Line Parameters

The command line uses the following parameters. These can be supplied in any order. Enclose any paths/gamenames etc which contain spaces in quotes ("):

-d "[filepath]"
Filepath
Specifies the path to the gamefile.

-f "[gamefile]"
Gamefile
Game filename, with extention

-p x
Boot Profile
Where x is a number. Specifies which Boot Profile to use.

-e x
Emulator number.
Specifies which emulator to use when booting game.

-g "[friendly game name]"
Friendly game name.
Specifies what name to use for a game when creating Game Profile.

 

Examples

All assuming running these commands from 'fresh' Emvoy installation:

emvoy -d "C:\Systems\Playstation\Zipped" -f "Tekken 2 [U] [SLUS-00213].zip"

Will create a game profile called "Tekken 2 [U] [SLUS-00213] {[default emu]}"
Because no Boot Profile specified, Emvoy will boot with the default Boot Profile (set in admin menu)Because no emulator specified, will make Game Profile with emulator specified as default in the Boot Profile.

emvoy -d "C:\Systems\Playstation\Zipped" -f "Tekken 2 [U] [SLUS-00213].zip" -g "Tekken 2"

Will create a game profile called "Tekken 2 {[default emu]}"
Because no Boot Profile specified, Emvoy will boot with the default Boot Profile (set in admin menu)
Because no emulator specified, will make Game Profile with emulator specified as default in the Boot Profile.

 

emvoy -d "C:\Systems\Playstation\Zipped" -f "Tekken 2 [U] [SLUS-00213].zip" -g "Tekken 2" -e 3

Will create a game profile called "Tekken 2 {[emu 3]}"
The Game profile will have emulator 3 as the mapped emulator
Because no Boot Profile specified, Emvoy will boot with the default Boot Profile (set in admin menu)

 

emvoy -d "C:\Systems\Playstation\Zipped" -f "Tekken 2 [U] [SLUS-00213].zip" -g "Tekken 2" -e 3 -p 2

Will create a game profile called "Tekken 2 {[emu 3]}"
The Game profile will have emulator 3 as the mapped emulator
EmVoy will boot via Boot Profile 2.

 

Emulators

Boot priorities

The table below shows which emulator will apply, depending on what settings are set:

Cmd param
(-e) set?

y

y

n

n

GameProfile Default Emulator set?

y

n

y

n

 

Use Cmd Emu

Use Cmd Emu

Use GProf def emu

Use BootProf def

Key:
Cmd param: Emulator number passed in command line
GProf def: If a gamefile has a default Game Profile mapped against it (in GameDefEmu.ini)
BootProf def: The default emulator specified by the Boot Profile.

Notes: If there is no emulator that matches the number passed via the cmd line, then the one specified in the Boot Profile is used.