Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		 Previous revision
emulationstation:command_line_arguments [2021/08/31 05:57] – created atariemulationstation:command_line_arguments [2022/12/24 06:25] (current) – typo? lol atari
Line 3: Line 3:
 If you've come from another distribution such as RetroPie (or you've just been around for a long time) you might be familiar with [[https://github.com/Aloshi/EmulationStation/tree/unstable#configuring|EmulationStation's command line arguments]]. You'll notice there's no real way to implement these arguments with the version of EmulationStation included in Batocera, unless you're willing to re-compile the entirety of Batocera. If you've come from another distribution such as RetroPie (or you've just been around for a long time) you might be familiar with [[https://github.com/Aloshi/EmulationStation/tree/unstable#configuring|EmulationStation's command line arguments]]. You'll notice there's no real way to implement these arguments with the version of EmulationStation included in Batocera, unless you're willing to re-compile the entirety of Batocera.
  
-Well no more! As of v32 Batocera now includes the ability to accept user-defined custom arguments for ES at launch. All you have to do is add the appropriate `es.customargs=--mycommand` key to `/userdata/batocera.conf`.+Well no more! As of **v32** Batocera now includes the ability to accept user-defined custom arguments for ES at launch. All you have to do is add the appropriate ''%%es.customsargs=--mycommand%%'' key to ''/userdata/batocera.conf''.
  
 For example: For example:
  
 <code> <code>
-es.customargs=--screenoffset 50 100+es.customsargs=--screenoffset 50 100
 </code> </code>
  
-You can view the current list of accepted arguments (Batocera's version of ES has a few more) by using the `emulationstation --help` command from terminal or [[:access_the_batocera_via_ssh|SSH]].+You can view the current list of accepted arguments (Batocera's version of ES has a few more) by using the `emulationstation --help` command from terminal or [[:access_the_batocera_via_ssh|SSH]]. Please keep in mind that most of these settings can be set within EmulationStation itself or are handled by Batocera automatically.
  
 Below is the output of that command (correct as of v32). Below is the output of that command (correct as of v32).
Line 42: Line 42:
 More information available in README.md. More information available in README.md.
 </code> </code>
 +
 +===== Exhaustive list of ES command line arguments =====
 +
 +<WRAP center round todo>
 +This is correct as of **v32**. May change over time.
 +</WRAP>
 +
 +This is in the order which they are processed internally. No documentation is available for using these arguments (you're on your own). Check [[https://github.com/batocera-linux/batocera-emulationstation/blob/master/es-app/src/main.cpp|the main file in the source code]] for the current commands.
 +
 +<code>
 +--home [path]                   Directory to use as home path
 +--videoduration                 ?
 +--video                         ?
 +--monitor [monitorId]           ?
 +--resolution [width] [height]   resolution when using --windowed
 +--screensize [width] [height]   output resolution, increasing will stretch the image out to the right and down
 +--screenoffset [x] [y]          move the canvas by x pixels right and y pixels down
 +--screenrotate [rotate]         rotates the screen 90 degrees, rotate values: 0, 1, 2 or 3
 +--gamelist-only                 only parse the gamelist xml files, don't scan for changes
 +--ignore-gamelist               always manually scan for files
 +--show-hidden-files             show all hidden games
 +--draw-framerate                display the framerate
 +--no-exit                       don't show the exit option in the menu
 +--exit-on-reboot-required       ?
 +--no-splash                     don't show the splash screen
 +--debug                         more logging, show console on Windows
 +--fullscreen-borderless         run emulationstation at fullscreen resolution in a borderless window
 +--fullscreen                    run emulationstation in fullscreen
 +--windowed                      run in windowed mode, not fullscreen, should be used with --resolution
 +--vsync [1/on or 0/off]         turn vsync on or off (default is on)
 +--max-vram [size]               Max VRAM to use in Mb before swapping. 0 for unlimited
 +--force-kiosk                   Force the UI mode to be Kiosk
 +--force-kid                     Force the UI mode to be Kid
 +--force-disable-filters         Force the UI to ignore applied filters in gamelist
 +--splash-image                  Show an alternate splash image
 +--help                          summon a sentient, angry tuba
 +</code>
 +
  • emulationstation/command_line_arguments.1630389456.txt.gz
  • Last modified: 5 years ago
  • by atari