Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
menu_tree [2022/07/22 12:11] – part 1 of major overhaul atarimenu_tree [2023/12/22 13:52] (current) – [SCRAPE] Note use of screenscraper username vs. email maximumentropy
Line 7: Line 7:
 </WRAP> </WRAP>
  
-Click on the drop-down menu below to navigate it as you would in Batocera. Otherwise, there's a static listing of all the menu options below.+The **MAIN MENU** in Batocera can be opened from any list in EmulationStation by pressing ''[START]''.
  
---> MAIN MENU # +===== KODI MEDIA CENTER =====
-This is the one you access by pressing ''[START]'' in any list. +
---> KODI MEDIA CENTER #+
 Launch [[:kodi|Kodi Media Center]] (Kodi is disabled on some weaker devices). Launch [[:kodi|Kodi Media Center]] (Kodi is disabled on some weaker devices).
  
 This can be disabled in the **SYSTEM SETTINGS** -> **KODI SETTINGS** menu. This can be disabled in the **SYSTEM SETTINGS** -> **KODI SETTINGS** menu.
-<-- + 
---> RETROACHIEVEMENTS #+===== RETROACHIEVEMENTS =====
 Shows all the [[:retroachievements_settings|RetroAchievements]] you have for the games which you've played. Shows all the [[:retroachievements_settings|RetroAchievements]] you have for the games which you've played.
  
 Greyed out ones are currently not present on your system. The appearance of this menu can be toggled in the **GAME SETINGS** menu. Greyed out ones are currently not present on your system. The appearance of this menu can be toggled in the **GAME SETINGS** menu.
-<-- + 
---> GAME SETTINGS #+===== GAME SETTINGS =====
 The global settings that apply if there are no per-system, per-folder or per-game settings. The global settings that apply if there are no per-system, per-folder or per-game settings.
---> UPDATE GAMELISTS #+ 
 +==== UPDATE GAMELISTS ====
 Choosing this option will perform a scan of your game folders and refresh the list of available games accordingly. Choosing this option will perform a scan of your game folders and refresh the list of available games accordingly.
-<-- + 
-DEFAULT GLOBAL SETTINGS +**//DEFAULT GLOBAL SETTINGS//** 
---> VIDEO MODE #+ 
 +==== VIDEO MODE ====
 Force the emulator to run at this resolution. Force the emulator to run at this resolution.
  
 This is the final output resolution sent to your display, as Batocera runs all emulators in full-screen. This is independent of the rendering resolution, which is an emulator-specific setting which changes the resolution of the game itself. Emulators will (usually) provide the ability to run with integer scaling or alternative aspect ratios so altering this setting for adjusting the geometry purposes is not required. This is the final output resolution sent to your display, as Batocera runs all emulators in full-screen. This is independent of the rendering resolution, which is an emulator-specific setting which changes the resolution of the game itself. Emulators will (usually) provide the ability to run with integer scaling or alternative aspect ratios so altering this setting for adjusting the geometry purposes is not required.
-<-- + 
---> GAME ASPECT RATIO #+==== GAME ASPECT RATIO ====
 Force the game to render in this aspect ratio. This setting does not change the final output resolution. Force the game to render in this aspect ratio. This setting does not change the final output resolution.
  
 If not using the AUTO setting, CORE PROVIDED is recommended. SQUARE PIXEL will render pixels with the same geometry as the pixels on your screen, but is not recommended as most systems did not have perfectly square pixels with their displays. If not using the AUTO setting, CORE PROVIDED is recommended. SQUARE PIXEL will render pixels with the same geometry as the pixels on your screen, but is not recommended as most systems did not have perfectly square pixels with their displays.
-<-- + 
---> GAME RENDERING & SHADERS # +==== GAME RENDERING & SHADERS ==== 
---> SHADER SET #+=== SHADER SET ===
 This is used to select a preset shader set for games. This is used to select a preset shader set for games.
  
 See [[emulationstation:shaders_set|the shader sets page]] for more info. See [[emulationstation:shaders_set|the shader sets page]] for more info.
-<-- + 
---> SMOOTH GAMES (BILINEAR FILTERING) #+=== SMOOTH GAMES (BILINEAR FILTERING) ===
 Enables [[emulationstation:shaders_set|bilinear filtering]] or the equivalent of that in the emulator. Enables [[emulationstation:shaders_set|bilinear filtering]] or the equivalent of that in the emulator.
  
 Not available on all emulators. Automatically disabled if the rendering resolution is set to the video mode resolution, or if a shader set is being used. Not available on all emulators. Automatically disabled if the rendering resolution is set to the video mode resolution, or if a shader set is being used.
-<-- + 
---> INTEGER SCALING (PIXEL PERFECT) #+=== INTEGER SCALING (PIXEL PERFECT) ===
 Only increase the image size in integer multiples. Only increase the image size in integer multiples.
  
 Retro games ran at a low resolution (typically 640x480 or 320x240), these are ordinarily expanded to fit a bigger screen. During this process, the pixel geometry may be warped if the image is scaled by a value that is not an integer. This forces the games to be scaled only by an integer multiple, using the largest integer multiple that does not cut off content of the screen. This may result in a black border around the image (unless the display is exactly a multiple of the original resolution of the game). See [[anti-aliasing|Anti-aliasing]] for more. Retro games ran at a low resolution (typically 640x480 or 320x240), these are ordinarily expanded to fit a bigger screen. During this process, the pixel geometry may be warped if the image is scaled by a value that is not an integer. This forces the games to be scaled only by an integer multiple, using the largest integer multiple that does not cut off content of the screen. This may result in a black border around the image (unless the display is exactly a multiple of the original resolution of the game). See [[anti-aliasing|Anti-aliasing]] for more.
-<-- + 
-<-- +==== DECORATIONS ====
---> DECORATIONS #+
 Select which decoration set to use and alter the objects drawn on top of it. Select which decoration set to use and alter the objects drawn on top of it.
  
 Decorations fill up the blank space resulting from using a thinner aspect ratio on a wider display. See [[:decoration|Decorations (and The Bezel Project)]] for more information. Decorations fill up the blank space resulting from using a thinner aspect ratio on a wider display. See [[:decoration|Decorations (and The Bezel Project)]] for more information.
---> DECORATION SET #+ 
 +=== DECORATION SET ===
 Choose which decoration set you'd like to use, with a little preview to go with it. Choose which decoration set you'd like to use, with a little preview to go with it.
  
 AUTO will use the CONSOLE set, which has a unique decoration per system. AUTO will use the CONSOLE set, which has a unique decoration per system.
-<-- + 
---> STRETCH BEZELS (4K & ULTRAWIDE) #+=== STRETCH BEZELS (4K & ULTRAWIDE) ===
 Stretch the decoration to the display's exact dimensions, potentially distorting the decoration. Stretch the decoration to the display's exact dimensions, potentially distorting the decoration.
  
 Overlays are typically designed for 16:9 1920x1080 monitors. If the display uses a higher resolution or a different aspect ratio, this option can be used to make the bezel correctly fit the screen. See [[:display_issues#emulation_with_4k_and_ultrawide_monitors_or_problems_when_your_screen_is_not_fully_displayed|the relevant section on the display issues page]] for more info. Overlays are typically designed for 16:9 1920x1080 monitors. If the display uses a higher resolution or a different aspect ratio, this option can be used to make the bezel correctly fit the screen. See [[:display_issues#emulation_with_4k_and_ultrawide_monitors_or_problems_when_your_screen_is_not_fully_displayed|the relevant section on the display issues page]] for more info.
-<-- + 
---> HEADS UP DISPLAY #+=== HEADS UP DISPLAY ===
 Show context-sensitive info over the game. Show context-sensitive info over the game.
  
 This utilizes MangoHUD to display in-game statistics of your machine or more information about the current game. See [[wiki:benchmarking_for_batocera#mangohud|the MangoHUD section on the benchmarking guide]] for more info. This utilizes MangoHUD to display in-game statistics of your machine or more information about the current game. See [[wiki:benchmarking_for_batocera#mangohud|the MangoHUD section on the benchmarking guide]] for more info.
-<-- + 
---> HEADS UP DISPLAY CORNER #+=== HEADS UP DISPLAY CORNER ===
 Choose which corner to display the HUD in. Choose which corner to display the HUD in.
-<-- + 
---> SHOW TATTOO OVER BEZEL #+=== SHOW TATTOO OVER BEZEL ===
 Show an image overlaid on top of the bezel. Show an image overlaid on top of the bezel.
  
 This is what's used for the controller overlays. Unlike the HUD, this is a static image and is less resource-intensive. See [[:decoration#custom_tattoo_image_additional_overlays|the tattoo section on the decorations page]] for more info. This is what's used for the controller overlays. Unlike the HUD, this is a static image and is less resource-intensive. See [[:decoration#custom_tattoo_image_additional_overlays|the tattoo section on the decorations page]] for more info.
-<-- + 
---> TATTOO CORNER #+=== TATTOO CORNER ===
 Choose which corner to display the tattoo in. Choose which corner to display the tattoo in.
-<-- + 
---> CUSTOM .PNG IMAGE PATH #+=== CUSTOM .PNG IMAGE PATH ===
 When using the CUSTOM IMAGE option as the current tattoo, use this image. When using the CUSTOM IMAGE option as the current tattoo, use this image.
-<-- + 
---> RESIZE TATTOO #+=== RESIZE TATTOO ===
 Shrink/expand tattoo to fit within the bezel's border. {{:switch-button.png?20|}} Shrink/expand tattoo to fit within the bezel's border. {{:switch-button.png?20|}}
-<-- + 
-<-- +==== AI GAME TRANSLATION ====
---> AI GAME TRANSLATION #+
 Connects to the internet to automatically translate the content of the current frame when activated. Connects to the internet to automatically translate the content of the current frame when activated.
  
 See [[:ai_game_translation|AI game translation]] for more info. See [[:ai_game_translation|AI game translation]] for more info.
---> ENABLE AI TRANSLATION SERVICE #+ 
 +=== ENABLE AI TRANSLATION SERVICE ===
 During gameplay, press ''[HOTKEY]'' + ''[R1]'' to translate on-screen text. Only on libretro cores. During gameplay, press ''[HOTKEY]'' + ''[R1]'' to translate on-screen text. Only on libretro cores.
-<-- + 
---> TARGET LANGUAGE #+=== TARGET LANGUAGE ===
 The language to translate //into//. The language to translate //into//.
-<-- + 
---> AI TRANSLATION SERVICE URL #+=== AI TRANSLATION SERVICE URL ===
 Type in the preferred translation service. Type in the preferred translation service.
  
 If none are specified, will use [[http://ztranslate.net/|ZTranslate]] by default. If none are specified, will use [[http://ztranslate.net/|ZTranslate]] by default.
-<-- + 
---> PAUSE ON TRANSLATED SCREEN #+=== PAUSE ON TRANSLATED SCREEN ===
 Halt the gameplay while translation is being shown. Halt the gameplay while translation is being shown.
  
 Useful for faster-paced games where text may only temporarily be shown on-screen. Useful for faster-paced games where text may only temporarily be shown on-screen.
-<-- + 
-<-- +==== REWIND ====
---> REWIND #+
 Store past states to rewind to in realtime, if the core supports it. Store past states to rewind to in realtime, if the core supports it.
  
 Lets you use the ''[HOTKEY]''+ D-pad left shortcut to rewind time during a game (sorry, no time-travel magic is involved, just memory states). See other commands at [[:basic_commands|the hotkey shortcuts page]]. Lets you use the ''[HOTKEY]''+ D-pad left shortcut to rewind time during a game (sorry, no time-travel magic is involved, just memory states). See other commands at [[:basic_commands|the hotkey shortcuts page]].
-<-- + 
---> LATENCY REDUCTION #+==== LATENCY REDUCTION ====
 Various options to help reduce input latency. See [[:latency_reduction_and_performance|the latency reduction page]]. Various options to help reduce input latency. See [[:latency_reduction_and_performance|the latency reduction page]].
---> RUN-AHEAD FRAMES #+ 
 +=== RUN-AHEAD FRAMES ===
 Enables run-ahead. High numbers can result in visible jitter. Enables run-ahead. High numbers can result in visible jitter.
  
 This usually doubles the CPU requirements for any given system, see [[:latency_reduction_and_performance#run-ahead|its section]] for more info. This usually doubles the CPU requirements for any given system, see [[:latency_reduction_and_performance#run-ahead|its section]] for more info.
-<-- + 
---> USE SECOND INSTANCE FOR RUN-AHEAD #+=== USE SECOND INSTANCE FOR RUN-AHEAD ===
 Emulates a second system to jump to when utilizing run-ahead. Emulates a second system to jump to when utilizing run-ahead.
  
 Can prevent audio skips on button presses. See [[:latency_reduction_and_performance#use_second_instance|its section]] for more info. Can prevent audio skips on button presses. See [[:latency_reduction_and_performance#use_second_instance|its section]] for more info.
-<-- + 
---> AUTOMATIC FRAME DELAY #+=== AUTOMATIC FRAME DELAY ===
 Automatically decrease frame delay temporarily to prevent frame drops. Automatically decrease frame delay temporarily to prevent frame drops.
  
 This usually results in a reduction in input delay, but can also result in there not being enough time to render audio frames, which can introduce audible stuttering. See [[:latency_reduction_and_performance#auto-frame_delay|its section]] for more info. This usually results in a reduction in input delay, but can also result in there not being enough time to render audio frames, which can introduce audible stuttering. See [[:latency_reduction_and_performance#auto-frame_delay|its section]] for more info.
-<-- + 
---> VARIABLE REFRESH RATE #+=== VARIABLE REFRESH RATE ===
 Adjusts the display's refresh rate to match that of the content. Adjusts the display's refresh rate to match that of the content.
  
 Don't deviate from the core's requested timing. This requires the monitor to support a VRR standard such as G-Sync, Freesync or HDMI 2.1 VRR. See [[:latency_reduction_and_performance#g-sync_freesync_vrr|its section]] for more info. Don't deviate from the core's requested timing. This requires the monitor to support a VRR standard such as G-Sync, Freesync or HDMI 2.1 VRR. See [[:latency_reduction_and_performance#g-sync_freesync_vrr|its section]] for more info.
-<-- + 
---> THREADED VIDEO #+=== THREADED VIDEO ===
 Runs the CPU logic and display logic on different dedicated cores. Runs the CPU logic and display logic on different dedicated cores.
  
 Improves performance at the cost of latency and more video stuttering. See [[:latency_reduction_and_performance#threaded_video|its section]] for more info. Improves performance at the cost of latency and more video stuttering. See [[:latency_reduction_and_performance#threaded_video|its section]] for more info.
-<-- + 
-<-- +==== RUMBLE LEVEL ====
---> RUMBLE LEVEL #+
 For emulators and controllers supporting force feedback. For emulators and controllers supporting force feedback.
-<-- + 
-SAVESTATES +**//SAVESTATES//** 
---> AUTO SAVE/LOAD #+ 
 +==== AUTO SAVE/LOAD ====
 Automatically load the latest savestate on game launch and automatically save the state when exiting the game. {{:switch-button.png?20|}} Automatically load the latest savestate on game launch and automatically save the state when exiting the game. {{:switch-button.png?20|}}
  
 Only for emulators which support save states in the first place. Only for emulators which support save states in the first place.
-<-- + 
---> INCREMENTAL SAVESTATES #+==== INCREMENTAL SAVESTATES ====
 Choose how the current save slot increments when launching games or saving states. Choose how the current save slot increments when launching games or saving states.
-<-- + 
---> SHOW SAVESTATE MANAGER #+==== SHOW SAVESTATE MANAGER ====
 Display the savestate manager before launching a game. Display the savestate manager before launching a game.
-<-- + 
-SYSTEM SETTINGS +**//SYSTEM SETTINGS//** 
---> PER SYSTEM ADVANCED CONFIGURATION #+ 
 +==== PER SYSTEM ADVANCED CONFIGURATION ====
 This will let you set up most system specific configurations. This will let you set up most system specific configurations.
  
 Refer to the system's page in [[:systems|systems]] for info on each particular system's settings. Game-specific settings will take priority over settings made here. Refer to the system's page in [[:systems|systems]] for info on each particular system's settings. Game-specific settings will take priority over settings made here.
-<-- + 
---> RETROACHIEVEMENT SETTINGS #+==== RETROACHIEVEMENT SETTINGS ====
 This submenu is used to set up RetroAchievements. This submenu is used to set up RetroAchievements.
  
 See [[:retroachievements_settings|RetroAchievements]] for more information. See [[:retroachievements_settings|RetroAchievements]] for more information.
---> RETROACHIEVEMENTS #+ 
 +=== RETROACHIEVEMENTS ===
 Enable the infamous [[https://www.retroachievements.org|RetroAchievements]]. {{:switch-button.png?20|}} Enable the infamous [[https://www.retroachievements.org|RetroAchievements]]. {{:switch-button.png?20|}}
  
 Make sure to provide your sign-in details first! See [[:retroachievements_settings|the RetroAchievements page]] for more info. Make sure to provide your sign-in details first! See [[:retroachievements_settings|the RetroAchievements page]] for more info.
-<-- + 
---> HARDCORE MODE #+=== HARDCORE MODE ===
 Disable certain emulator convenience features for more points. {{:switch-button.png?20|}} Disable certain emulator convenience features for more points. {{:switch-button.png?20|}}
  
 With this mode on, special features such as rewind, fast-forward and cheat codes are disabled, creating a similar environment to the original experience. For hardcore fans. With this mode on, special features such as rewind, fast-forward and cheat codes are disabled, creating a similar environment to the original experience. For hardcore fans.
-<-- + 
---> LEADERBOARDS #+=== LEADERBOARDS ===
 Compete in high-score and best time leaderboards. {{:switch-button.png?20|}} Compete in high-score and best time leaderboards. {{:switch-button.png?20|}}
  
 Supported only by certain games. This setting requires **HARDCORE MODE** to be enabled. Supported only by certain games. This setting requires **HARDCORE MODE** to be enabled.
-<-- + 
---> VERBOSE MODE # +=== VERBOSE MODE === 
-Show achievement progression on game launch and other notifications.+Show achievement progression on game launch and other notifications. {{:switch-button.png?20|}}
  
 When you unlock an achievement, get details about the achievement you have unlocked, with a cute little badge in the upper left corner of your screen. When you unlock an achievement, get details about the achievement you have unlocked, with a cute little badge in the upper left corner of your screen.
-<-- + 
---> RICH PRESENCE #+=== RICH PRESENCE ===
 FIXME {{:switch-button.png?20|}} FIXME {{:switch-button.png?20|}}
-<-- + 
---> ENCORE MODE #+=== ENCORE MODE ===
 Unlocked achievements can be earned again. {{:switch-button.png?20|}} Unlocked achievements can be earned again. {{:switch-button.png?20|}}
  
 This is only in regards to the notification. The actual achievements themselves won't become locked again on your account. This is only in regards to the notification. The actual achievements themselves won't become locked again on your account.
-<-- + 
---> AUTOMATIC SCREENSHOT #+=== AUTOMATIC SCREENSHOT ===
 Automatically take a screenshot when an achievement is earned. {{:switch-button.png?20|}} Automatically take a screenshot when an achievement is earned. {{:switch-button.png?20|}}
  
 Do you want to keep a screenshot of the moment you unlocked a RetroAchievement? They are stored in the Batocera screenshot directory. Do you want to keep a screenshot of the moment you unlocked a RetroAchievement? They are stored in the Batocera screenshot directory.
-<-- + 
---> CHALLENGE INDICATORS # +=== CHALLENGE INDICATORS === 
-Shows icons in the bottom right corner when eligible achievements can be earned.+Shows icons in the bottom right corner when eligible achievements can be earned. {{:switch-button.png?20|}}
  
 Useful for seeing if you have failed the condition for earning a particular achievement or not. Useful for seeing if you have failed the condition for earning a particular achievement or not.
-<-- + 
---> UNLOCK SOUND #+=== UNLOCK SOUND ===
 Choose which sound will play when an achievement is unlocked. Choose which sound will play when an achievement is unlocked.
  
 A few sounds to choose from are included, some you may already be familiar with. Custom sounds can also be selected, simply add the ''.ogg'' sound file to ''/userdata/sounds/retroachievements/'' (other formats are not compatible). A few sounds to choose from are included, some you may already be familiar with. Custom sounds can also be selected, simply add the ''.ogg'' sound file to ''/userdata/sounds/retroachievements/'' (other formats are not compatible).
-<-- + 
---> USERNAME #+=== USERNAME ===
 The username for the [[https://www.retroachievements.org|RetroAchievements]] account. The username for the [[https://www.retroachievements.org|RetroAchievements]] account.
-<-- + 
---> PASSWORD #+=== PASSWORD ===
 The password for the [[https://www.retroachievements.org|RetroAchievements]] account. The password for the [[https://www.retroachievements.org|RetroAchievements]] account.
-<-- 
---> SHOW RETROACHIEVEMENTS ENTRY IN MAIN MENU # 
  
-GAME INDEXES +=== SHOW RETROACHIEVEMENTS ENTRY IN MAIN MENU === 
---> INDEX NEW GAMES AT STARTUP # +Shows a menu entry for your RetroAchievements right in the main menu. {{:switch-button.png?20|}} 
-Checks newly added games to see if they are compatible with RetroAchievements.+ 
 +**//GAME INDEXES//** 
 + 
 +=== INDEX NEW GAMES AT STARTUP === 
 +Checks newly added games to see if they are compatible with RetroAchievements. {{:switch-button.png?20|}}
  
 This only affects the frontend, the actual achievements themselves are always earnable once the game is launched. This only affects the frontend, the actual achievements themselves are always earnable once the game is launched.
-<-- + 
---> INDEX GAMES #+=== INDEX GAMES ===
 A tool to index the availability of achievements for games. A tool to index the availability of achievements for games.
  
 In order to show a little icon in the Batocera menu for the games that have RetroAchievements. This tool calculates the MD5 checksums of your ROM files and checks them against [[https://www.retroachievements.org|the RetroAchievements database]]. This only affects the frontend, the actual achievements themselves are always earnable once the game is launched. In order to show a little icon in the Batocera menu for the games that have RetroAchievements. This tool calculates the MD5 checksums of your ROM files and checks them against [[https://www.retroachievements.org|the RetroAchievements database]]. This only affects the frontend, the actual achievements themselves are always earnable once the game is launched.
---> GAMES TO INDEX #+ 
 +=== GAMES TO INDEX ===
 Filter to only scan achievements for games that haven't been scanned before. Filter to only scan achievements for games that haven't been scanned before.
  
 Useful to run this tool with the option set to ALL to ensure that games with achievements added recently are indexed. Useful to run this tool with the option set to ALL to ensure that games with achievements added recently are indexed.
-<-- + 
---> SYSTEMS INCLUDED #+=== SYSTEMS INCLUDED ===
 Filter to scan games of only particular systems. Filter to scan games of only particular systems.
-<-- + 
-<-- +==== NETPLAY SETTINGS ====
---> NETPLAY SETTINGS #+
 This submenu is used to set up netplay. This submenu is used to set up netplay.
  
 See [[:netplay|Netplay]] for more information. See [[:netplay|Netplay]] for more information.
  
-SETTINGS +**//SETTINGS//** 
---> ENABLE NETPLAY # + 
-Allow for the launching and joining of netplay games from the menu.+=== ENABLE NETPLAY === 
 +Allow for the launching and joining of netplay games from the menu. {{:switch-button.png?20|}}
  
 Once activated, pressing the {{:wiki:north.png?nolink&20|North button (X SNES)}} button now launches you into the netplay lobby menu. Once activated, pressing the {{:wiki:north.png?nolink&20|North button (X SNES)}} button now launches you into the netplay lobby menu.
-<-- + 
---> NICKNAME # +=== NICKNAME === 
-Instead of appearing as player #42957, customise your nickname!+Instead of appearing as player #42957, customize your nickname!
  
 This is how you will be presented in the netplay game rooms (useful for the other players to find you and make sure they join the right room). This is how you will be presented in the netplay game rooms (useful for the other players to find you and make sure they join the right room).
-<-- + 
---> PORT #+=== PORT ===
 If you need to define a specific port to use. If you need to define a specific port to use.
  
 This is dependent on the current network's configuration. If the router has UPNP enabled, leaving this field empty will use the correct port automatically. Otherwise, the default port to use is ''55435''. This is dependent on the current network's configuration. If the router has UPNP enabled, leaving this field empty will use the correct port automatically. Otherwise, the default port to use is ''55435''.
-<-- + 
---> USE RELAY SERVER #+=== USE RELAY SERVER ===
 Enables use of a man-in-the-middle to assist in connecting to game lobbies. Enables use of a man-in-the-middle to assist in connecting to game lobbies.
  
 In case the network does not support UPNP. It does introduce a little more latency though, so use this option only if your network can't open UPNP ports automatically. In case the network does not support UPNP. It does introduce a little more latency though, so use this option only if your network can't open UPNP ports automatically.
-<-- + 
---> SHOW UNAVAILABLE GAMES # +=== SHOW UNAVAILABLE GAMES === 
-Show rooms for games not present on this machine. +Show rooms for games not present on this machine. {{:switch-button.png?20|}} 
-<-- + 
-GAME INDEXES +**//GAME INDEXES//** 
---> INDEX NEW GAMES AT STARTUP # + 
-Checks newly added games to see if they are netplay-compatible. +=== INDEX NEW GAMES AT STARTUP === 
-<-- +Checks newly added games to see if they are netplay-compatible. {{:switch-button.png?20|}} 
---> INDEX GAMES # + 
---> GAMES TO INDEX #+=== INDEX GAMES === 
 +FIXME 
 + 
 +=== GAMES TO INDEX ===
 Filter to only scan for games compatible with netplay that haven't been scanned before. Filter to only scan for games compatible with netplay that haven't been scanned before.
  
 Useful to run this tool with the option set to ALL to ensure that netplay-compatible games on systems added to the netplay servers recently are indexed. Useful to run this tool with the option set to ALL to ensure that netplay-compatible games on systems added to the netplay servers recently are indexed.
-<-- + 
---> SYSTEMS INCLUDED #+=== SYSTEMS INCLUDED ===
 Filter to scan games of only particular systems. Filter to scan games of only particular systems.
-<-- + 
-<-- +==== MISSING BIOS CHECK ====
-<-- +
---> MISSING BIOS CHECK #+
 Checks the ''bios'' folder for currently missing or untested [[:add_games_bios#adding_bios_files|BIOS]] files. Checks the ''bios'' folder for currently missing or untested [[:add_games_bios#adding_bios_files|BIOS]] files.
  
 If no flaws are detected, nothing is shown. Congratulations! Keep in mind that not all BIOS files are required to run the emulators, just some. It's recommended to read the wiki for each particular [[:systems|system]] you intend to run to find proper explanations on what exactly is needed. If no flaws are detected, nothing is shown. Congratulations! Keep in mind that not all BIOS files are required to run the emulators, just some. It's recommended to read the wiki for each particular [[:systems|system]] you intend to run to find proper explanations on what exactly is needed.
-<-- 
---> CHECK BIOS FILES BEFORE RUNNING A GAME # 
-Pre-emptively display a warning if no BIOS is found when attempting to run a game for the first time. 
-<-- 
-<-- 
-<-- 
  
-==== Controllers Settings ====+==== CHECK BIOS FILES BEFORE RUNNING A GAME  
 +Pre-emptively display a warning if no BIOS is found when attempting to run a game for the first time. {{:switch-button.png?20|}} 
 + 
 +===== CONTROLLER AND BLUETOOTH SETTINGS =====
 Configure your [[supported_controllers]] and player order here. Configure your [[supported_controllers]] and player order here.
-  * **Configure A Controller** Clicking this option will show a window asking to hold a button on the gamepad to configure, it will then ask for a list of inputs. See [[configure_a_controller|Configure A Controller]] for more info. 
-  * **Pair A Bluetooth Controller** : Pressing this will make you able to pair a Bluetooth controller, for some unfortunately you might need to [[bluetooth_controllers_-_manual_setup|pair it manually using the command-line]]. 
-  * **Forget Bluetooth Controllers** : Choosing this will list your paired Bluetooth controllers, and let you unpair them. 
-  * **Gamepad order** : The list here can be used to affect specific gamepads to specific players. 
-  * **Show Controller Activity** {{:switch-button.png?20|}} : Checking this option shows the number of controllers connected with icons inside EmulationStation, and they will blink when used. 
  
-==== UI Settings ====+==== CONTROLLER MAPPING ==== 
 +Remap a controller. 
 + 
 +This process will automatically go through all buttons on the controller. The mapping can be altered after D-pad down and D-pad up have been assigned, by navigating to that button and pressing {{:wiki:south.png?nolink&20|South button (B SNES)}}. No two mappings can share the same button, and the D-pad buttons must be assigned. This limitation may be removed in the future. 
 + 
 +==== PAIR A BLUETOOTH DEVICE ==== 
 +Pair and connect to the first Bluetooth device seen in its pairing mode. 
 + 
 +If having difficulties, refer to [[:bluetooth_controllers_-_manual_setup|the manual Bluetooth setup]] page. If your Batocera is connecting to unwanted devices, that's [[https://github.com/batocera-linux/batocera.linux/issues/4634|too bad]]. 
 + 
 +==== FORGET A BLUETOOTH DEVICE ==== 
 +Choosing this will list the currently paired Bluetooth devices, and let you unpair any of them. 
 + 
 +==== SHOW CONTROLLER ACTIVITY ==== 
 +Show the number of controllers connected as icons in EmulationStation. {{:switch-button.png?20|}} 
 + 
 +Requires the theme to support the icon. Themes without an icon will use a placeholder square. 
 + 
 +==== SHOW CONTROLLER BATTERY LEVEL ==== 
 +Show the battery level of the controllers alongside the icons. {{:switch-button.png?20|}} 
 + 
 +There will then be a list of up to 8(?) available controllers and what player order they are in. 
 + 
 +===== USER INTERFACE SETTINGS ===== 
 +Settings to adjust the various aspects of the menu and theme. 
 + 
 +**//APPEARANCE//** 
 + 
 +==== THEME SET ==== 
 +Choose the theme to use. 
 + 
 +Additional themes can be downloaded from the [[:updates_and_downloads|Updates & Download]] category in the main menu. See [[:theme_set|Theme Set]] for more info. 
 + 
 +==== THEME CONFIGURATION ==== 
 +These options are specific to the theme currently being used. 
 + 
 +Options edited here will be saved per theme, so don't be afraid of trying out new themes as the settings for the previous theme will be remembered. Select **RESET CUSTOMIZATIONS** to revert back to the theme's default settings. 
 + 
 +**//DISPLAY OPTIONS//** 
 +==== SCREENSAVER SETTINGS ==== 
 +=== START SCREENSAVER AFTER === 
 +How long the system must stay unused before triggering the screensaver. 
 + 
 +=== SCREENSAVER TYPE === 
 +Choose what kind of screensaver to use. 
 + 
 +  * DIM/BLACK: Darkens the screen either a bit or a lot. There are no settings for these types of screensavers. 
 +  * RANDOM VIDEO/SLIDESHOW: Play videos/show screenshots from scraped games. 
 +  * SUSPEND: Puts the machine into a low-power state. 
 + 
 +This selection will affect the options available in the screensaver settings menu. 
 + 
 +=== STOP MUSIC ON SCREENSAVER === 
 +Stops the background music playing when the screensaver starts. {{:switch-button.png?20|}} 
 + 
 +Useful if you'd prefer to hear the video's audio instead for the video screensaver. 
 + 
 +**//RANDOM VIDEO/SLIDESHOW SCREENSAVER SETTINGS//** 
 +=== VIDEO/IMAGE DURATION (SECS) === 
 +How long to display the video/image for before automatically switching to the next one. {{:switch-slider.png?30|}} 
 + 
 +=== SHOW GAME INFO === 
 +Adds an overlay of the game's title or its marquee. {{:switch-button.png?20|}} 
 + 
 +=== USE MARQUEE AS GAME INFO === 
 +If the game has been scraped and has a marquee, use that instead of plain text for its info. {{:switch-button.png?20|}} 
 + 
 +=== DECORATION SET USED === 
 +Adds the system bezel or a random one for that system to the screensaver. 
 + 
 +The marquee is shown over the bezel, while the screenshot/video is shown inside the bezel. 
 + 
 +=== STRETCH VIDEOS/IMAGES === 
 +Distort videos/images to fill the space. {{:switch-button.png?20|}} 
 + 
 +=== MUTE VIDEO AUDIO === 
 +Keep the video silent. {{:switch-button.png?20|}} 
 + 
 +Useful if you'd prefer to keep listening to the background music. Only available for the video screensaver. 
 + 
 +=== SCREENSAVER CONTROLS === 
 +Change the controls during the screensaver: 
 + 
 +  * ''[START]'' launches the game currently being shown. 
 +  * D-pad right moves onto the next game. 
 +  * D-pad left moves back to the previous game. 
 + 
 +If disabled, then any button press instead just closes the screensaver. 
 + 
 +=== USE CUSTOM VIDEOS/IMAGES === 
 +Use a custom folder to grab videos/images from for the screensaver. {{:switch-button.png?20|}} 
 + 
 +By default, the folder is ''/userdata/screenshots/''. Drop a few videos for old video game commercials in there, and sit back for some nostalgia. 
 + 
 +=== CUSTOM VIDEO/IMAGE DIRECTORY === 
 +Define a custom path where videos/images should be retrieved from. 
 + 
 +If none is specified, will use ''/userdata/screenshots/''. 
 + 
 +=== USE VIDEOS/IMAGES IN SUBFOLDERS OF CUSTOM DIRECTORY === 
 +Scan for and use videos/images in subfolders of the specified directory too. {{:switch-button.png?20|}} 
 + 
 +=== CUSTOM VIDEO/IMAGE FILE EXTENSIONS === 
 +Manually edit the acceptable file extensions. 
 + 
 +Be careful of adding extensions for formats that cannot be played by EmulationStation. 
 + 
 +===== USER INTERFACE SETTINGS =====
  
-=== Appearance === 
-  * **Theme Set** : This is used to choose the theme you are using, additional themes can be downloaded from the Updates & Download category in the main menu, see [[:theme_set|Theme Set]] for reference. 
-  * **Theme Configuration** : This opens a submenu to customize your currently used theme, customization options are specific to the used theme. 
   * **UI Mode** : You can select different modes for batocera, Kiosk mode and Kid mode will reduce the amount of possibilities, see also [[:ui_mode|UI mode]].   * **UI Mode** : You can select different modes for batocera, Kiosk mode and Kid mode will reduce the amount of possibilities, see also [[:ui_mode|UI mode]].
  
Line 319: Line 421:
   * **Transition Style** : This is used to decide if the menu should have a fade-in transition effect, a moving effect, or change instantly when starting a game.   * **Transition Style** : This is used to decide if the menu should have a fade-in transition effect, a moving effect, or change instantly when starting a game.
   * **Carousel Transitions** {{:switch-button.png?20|}} Instantly show next/previous system   * **Carousel Transitions** {{:switch-button.png?20|}} Instantly show next/previous system
-  * Screen Saver Settings 
-    * **Screen Saver After** {{:switch-slider.png?30|}} : This is used to decide how long the system must stay unused before triggerring the screensaver. 
-    * **Screen Saver Behavior** : This is used to choose what the screensaver will do. 
-      * **Dim** : Simply dim the screen. 
-      * **Black** : Turns the screen black. This does not actually turn off the monitor. 
-      * **Slideshow** : Displays on full screen screenshots that have been scraped for the games available on your system (on rotation after a given time). When this is selected, new options will appear. 
-      * **Random video** : Play a random video from a selection of videos. When this is selected, new options will appear. 
-        * **Random video** : To play videos from a custom folder (by default, ''/userdata/screenshots/''). Drop a few videos for old video game commercials in there, and sit back for some nostalgia. And if there is a video you don't like, just press ''[D-PAD RIGHT]'' to skip to the next. 
-    * **Stop Music on Screensaver** {{:switch-button.png?20|}} : Enabling this will stop the main menu music from playing when the screensaver is used, if video files are used as a screensaver, their audio will be then used instead.  
-    * **Random Video Screensaver Settings** : Show a random video snap. 
-    * **Slideshow Screensaver Settings** : Show a random screenshot image. 
-      * **Swap image after** {{:switch-slider.png?30|}} indicates the time in seconds before switching to the next image when the screensaver takes over 
-      * **Show game info** adds an overlay of the game title and platform 
-      * **Use marquee as Game Info** {{:switch-button.png?20|}} if you scraped the game marquees and prefer to display a graphic image rather than plain text 
-      * **Decorations** - do you want to add a bezel to the picture? You can select between the default bezel for the **system** showed in the snap, a **random** bezel, or **none**. 
-      * **Stretch images** {{:switch-button.png?20|}}  
-      * **Use custom images** {{:switch-button.png?20|}} enable this option if you want to display custom images from a folder, rather than your scraped pictures 
-      * **Custom image dir** path where custom pictures will be fetched -- by default ''/userdata/screenshots'' 
-      * **Custom image dir recursive** in case you want to search for video files in subfolders of the previous path 
-      * **Custom image filter** extensions for videos -- by default ''.png,.jpg'' 
-    * **Screen Saver Controls** {{:switch-button.png?20|}} : Enable the use of the buttons to perform different actions during the screensaver. 
   * **Game Launch Transition** : auto, fade, slide or instant   * **Game Launch Transition** : auto, fade, slide or instant
   * **Show Clock** {{:switch-button.png?20|}} : Displays the hour on EmulationStation   * **Show Clock** {{:switch-button.png?20|}} : Displays the hour on EmulationStation
Line 352: Line 433:
   * **Show '..' parent folders** {{:switch-button.png?20|}} : When subfolders are shown, enabling this will show a ''..'' entry to go back one folder, this entry can be hidden.   * **Show '..' parent folders** {{:switch-button.png?20|}} : When subfolders are shown, enabling this will show a ''..'' entry to go back one folder, this entry can be hidden.
   * **Show Filenames in Lists** {{:switch-button.png?20|}} : Shows the filename instead of scrapped game name.   * **Show Filenames in Lists** {{:switch-button.png?20|}} : Shows the filename instead of scrapped game name.
- +===== GAME COLLECTION SETTINGS =====
-==== Game Collection Settings ====+
  
 More information about custom collections at [[:game_collection_settings|its respective page]]. More information about custom collections at [[:game_collection_settings|its respective page]].
Line 381: Line 461:
   * **Show System Name in Collections** {{:switch-button.png?20|}} Add a system description to a ROM file e.g. //Sonic [Megadrive]//   * **Show System Name in Collections** {{:switch-button.png?20|}} Add a system description to a ROM file e.g. //Sonic [Megadrive]//
  
-==== Sound Settings ====+===== SOUND SETTINGS ===== 
   * **Frontend Music** {{:switch-button.png?20|}} : Is used to enable or disable the music in EmulationStation.   * **Frontend Music** {{:switch-button.png?20|}} : Is used to enable or disable the music in EmulationStation.
   * **Display Song Titles** {{:switch-button.png?20|}} : Used to show the name of the music file in EmulationStation when it starts playing.   * **Display Song Titles** {{:switch-button.png?20|}} : Used to show the name of the music file in EmulationStation when it starts playing.
Line 392: Line 473:
   * **Enable Video Audio** {{:switch-button.png?20|}} : When you have a video played back in the EmulationStation menu -- either through a video thumbmail of a game that you scraped or when you use the video screensaver option -- you can toggle on/off this option so that it does not interfere with the **FRONTEND MUSIC** option that might have been set up above.   * **Enable Video Audio** {{:switch-button.png?20|}} : When you have a video played back in the EmulationStation menu -- either through a video thumbmail of a game that you scraped or when you use the video screensaver option -- you can toggle on/off this option so that it does not interfere with the **FRONTEND MUSIC** option that might have been set up above.
  
-==== Network Settings ====+===== NETWORK SETTINGS ===== 
   * //Informations//   * //Informations//
   * **IP Address** This displays your IP address which can be useful if you want to access your device over the network (you should be able to access your device in Windows through the file explorer. Type ''\\(IP address of Batocera)'' in the address bar to gain access to the share.)   * **IP Address** This displays your IP address which can be useful if you want to access your device over the network (you should be able to access your device in Windows through the file explorer. Type ''\\(IP address of Batocera)'' in the address bar to gain access to the share.)
Line 406: Line 488:
   * **WIFI Key** This is the password to your wireless network that you're attempting to connect to. Special characters may need to be escaped with a preceding ''\''.   * **WIFI Key** This is the password to your wireless network that you're attempting to connect to. Special characters may need to be escaped with a preceding ''\''.
  
-==== Scrape ====+===== SCRAPE ===== 
 Allows you to [[scrape_from|scrape boxart/marquees for your game collection]] from an online database. Allows you to [[scrape_from|scrape boxart/marquees for your game collection]] from an online database.
   * **Scrape From** Choose your database source. Remaining options will appear/disappear based on this. Read [[scrape_from|Scrape From]] for more info.   * **Scrape From** Choose your database source. Remaining options will appear/disappear based on this. Read [[scrape_from|Scrape From]] for more info.
Line 417: Line 500:
   * **Scrape Manual** {{:switch-button.png?20|}} Batocera 5.27+ offers you the ability to show game manuals (by hitting ''[Select]'' on a game) if you scraped the manuals.   * **Scrape Manual** {{:switch-button.png?20|}} Batocera 5.27+ offers you the ability to show game manuals (by hitting ''[Select]'' on a game) if you scraped the manuals.
   * **Scrape Pad2key settings** {{:switch-button.png?20|}} For Batocera v29+, you can automatically download a [[emulators:pad2key|pad2key profile to use the joypad to emulate a keyboard]].   * **Scrape Pad2key settings** {{:switch-button.png?20|}} For Batocera v29+, you can automatically download a [[emulators:pad2key|pad2key profile to use the joypad to emulate a keyboard]].
-  * **Username** if you use [[scrape_from|screenscraper as a source]], and you have an account with multiple threads, using your screenscraper username and password here will leverage scraping with as many parallel threads as you have access to. It's **a lot** faster.+  * **Username** if you use [[scrape_from|screenscraper as a source]], and you have an account with multiple threads, using your screenscraper username and password here will leverage scraping with as many parallel threads as you have access to. It's **a lot** faster.  <WRAP center round important 100%> 
 +**Be sure to enter the screenscaper username**, not the email address.</WRAP>
   * **Password**   * **Password**
   * **Scrape Now** Begin scraping. Your system may become unresponsive for a moment, but scraping will begin in the background. When done, be sure to **Update Games Lists** to see your boxart!   * **Scrape Now** Begin scraping. Your system may become unresponsive for a moment, but scraping will begin in the background. When done, be sure to **Update Games Lists** to see your boxart!
  
-==== Updates & Downloads ====+===== UPDATES & DOWNLOADS ===== 
 Download freely distributed content for Batocera! See [[updates_and_downloads|Content downloader/updates]] for more info. Download freely distributed content for Batocera! See [[updates_and_downloads|Content downloader/updates]] for more info.
   * //Downloads//   * //Downloads//
Line 432: Line 517:
   * **Start Updates** Start the update! You'll be asked for confirmation.   * **Start Updates** Start the update! You'll be asked for confirmation.
  
-==== System Settings ====+===== SYSTEM SETTINGS ===== 
   * //System//   * //System//
   * Information   * Information
Line 444: Line 530:
       * CPU Max Frequency       * CPU Max Frequency
   * Language   * Language
-  * Power Saver Modes+  * Power Saver Modes: Reduce CPU consumption during idle time by reducing frequency of menu animation frames. 
 +      * **Default:**  Menu rendering is paused once Game Description animation completes. 
 +      * **Enhanced:** Menu rendering is paused once Game Name animation completes. Use when you don't need/read Description or Video previews. 
 +      * **Instant:** Menu rendering is paused immediately (few or no animations)  
 +      * **Disabled:**  Menu is re-rendered for every frame, even when static.
   * Kodi Settings   * Kodi Settings
       * **Enable Kodi**  {{:switch-button.png?20|}}        * **Enable Kodi**  {{:switch-button.png?20|}} 
Line 484: Line 574:
       * **Format disk** Lets you format disks (exfat, ext4, btrfs)       * **Format disk** Lets you format disks (exfat, ext4, btrfs)
       * **Use OMX Player (HW accelerated)** {{:switch-button.png?20|}}       * **Use OMX Player (HW accelerated)** {{:switch-button.png?20|}}
 +
 +===== QUIT =====
 +
 +<WRAP center round todo>
 +to do
 +</WRAP>
  
 ===== Quick Access ===== ===== Quick Access =====
  • menu_tree.1658491906.txt.gz
  • Last modified: 4 years ago
  • by atari