LogoLogo
Retrobat WebsiteForumGithub
English
English
  • Welcome!
  • Get Started
    • Prerequisites
    • Installation & First Startup
    • RetroBat Folder Structure
    • Adding a game
    • Running a game
    • Adding BIOS files
  • NAVIGATION
    • Navigation Keys
    • Hotkeys
    • System View and Game View
    • Main Menu
    • View Options
    • Game Options
    • Configuration of systems and games
    • Scraping & Metadata
    • Game Collections
  • Systems & Emulators
    • Arcade Guide
    • Supported Game Systems
      • Game Consoles
        • 3DO
        • Actionmax
        • Adventure Vision
        • Amstrad GX4000
        • APF MP-1000
        • Arcadia 2001
        • Atari (consoles)
          • Atari 2600
          • Atari 5200
          • Atari 7800
          • Atari XEGS
          • Jaguar
          • Jaguar CD
        • Bally Astrocade
        • Casio Loopy
        • Channel F
        • ColecoVision
        • Commodore (game consoles)
          • Amiga CDTV
          • Amiga CD32
        • Intellivision
        • Lowres NX
        • Microsoft (consoles)
          • Xbox
          • Xbox 360
        • NEC (consoles)
          • PC Engine/TurboGrafx-16
          • PC Engine CD-ROM/TurboGrafx-CD
          • SuperGrafx
          • PC-FX
        • Nintendo (game consoles)
          • Nintendo Entertainment System - Family Computer
          • Family Computer Disk System
          • NES 3D
          • Super Nintendo Entertainment System - Super Famicom
          • Satellaview
          • SuFami Turbo
          • Super NES MSU-1
          • Super Game Boy
          • Nintendo 64
          • Nintendo 64 Disk Drive
          • GameCube
          • Wii
          • WiiU
          • Switch
        • Philips CD-i
        • Odyssey²
        • Othello Multivision
        • PV-1000
        • Sega (game consoles)
          • SG-1000
          • Master System - Mark III
          • Megadrive - Genesis
          • Megadrive - Genesis (MSU)
          • Mega-CD - Sega-CD
          • Sega 32X
          • Saturn
          • Dreamcast
        • SNK (game consoles)
          • Neo Geo
          • Neo Geo CD
        • Sony (game consoles)
          • PlayStation
          • PlayStation 2
          • Playstation 3
          • Playstation 4
        • Super Cassette Vision
        • Super A'Can
        • Uzebox
        • VC4000
        • Vectrex
        • Vircon32
        • VTech
          • CreatiVision
          • V.Smile
      • Portable Game Consoles
        • Arduboy
        • Atari (portable game consoles)
          • Lynx
        • Gamate
        • Game.com
        • Game Pocket Computer
        • Game Master
        • Game & Watch
        • GP 32
        • LCD Games
        • Mega Duck
        • Nintendo (portable game consoles)
          • Game Boy
          • Game Boy MSU
          • Game Boy 2 players
          • Virtual Boy
          • Game Boy Color
          • Game Boy Color 2 players
          • Game Boy Advance
          • Game Boy Advance 2 players
          • Nintendo DS
          • Pokémon Mini
          • Nintendo 3DS
        • Nokia
          • N-Gage & Symbian
        • Sega (portable game consoles)
          • Game Gear
        • SNK (portable game consoles)
          • Neo Geo Pocket
          • Neo Geo Pocket Color
        • Sony (portable game consoles)
          • PlayStation Portable
          • PlayStation Vita
        • Supervision
        • Wonderswan
          • WonderSwan
          • WonderSwan Color
      • Home Computer
        • Acorn Computers
          • Archimedes
          • ATOM
          • BBC Micro
          • Electron
        • Amstrad CPC
        • Apple
          • Apple II
          • Apple IIGS
        • Atari (computers)
          • Atari 800
          • Atari ST
        • Camputers Lynx
        • Coleco Adam
        • Pegasus
        • Commodore (computers)
          • Commodore PET
          • Commodore VIC-20
          • Commodore 64
          • Commodore Plus/4
          • Commodore 128
          • Amiga 500
          • Amiga 1200
          • Amiga 4000
        • Dragon 32/64
        • Fujitsu
          • FM-7
          • FM-TOWNS
        • Mattel
          • Aquarius
        • Microsoft (computers)
          • MSX
          • MSX2
          • MSX2+
          • MSX turbo R
        • NEC (computers)
          • NEC PC-8800
          • NEC PC-9800
        • Oric Atmos
        • Philips
          • P2000t
          • VG5000µ
        • Sam Coupé
        • Sharp
          • Sharp X1
          • Sharp X68000
        • Sinclair Research
          • ZX 81
          • ZX Spectrum
        • SpectraVideo (SV-318)
        • Thomson - MO/TO
        • TI-99/4A
        • Tomy Tutor
        • TRS-80 Color Computer
      • Arcade
        • Atomiswave
        • Capcom Play Systems
          • CPS I
          • CPS II
          • CPS III
        • Cave CV1000
        • Final Burn Neo
        • Gaelco
        • HomeBrew MAME
        • Hyper Neo Geo 64
        • LaserDisc
        • MAME
        • Namco 246/256
        • SEGA
          • Sega Model 2
          • Sega Titan-Video
          • Sega Model 3
          • Sega NAOMI
          • Sega NAOMI 2
          • Sega Hikaru
          • Triforce
          • Sega Chihiro
        • TeknoParrot
        • Zinc
      • Game Engines
        • EasyRPG
        • GemRB
        • IKEMEN
        • Löve
        • Lutro
        • MUGEN
        • Open Beats Of Rage
        • Singe
        • Solarus
      • Pinball
        • Future Pinball
        • Pinball FX
        • Pinball FX2
        • Pinball FX3
        • Pinball M
        • Visual Pinball
        • Zaccaria Pinball
      • Others
        • Cannonball
        • Cave Story
        • CDogs
        • Commander Genius
        • DevilutionX
        • Dinothawr
        • Doom III
        • DOS
        • Duke Nukem 3D
        • Flash
        • GzDoom
        • Java ME
        • Karaoke
        • OpenGOAL
        • OpenJazz
        • Perfect Dark
        • Pico-8
        • Ports
        • PrBoom
        • Quake
        • Quake 2
        • Raze
        • REminiscence
        • Ship Of Harkinian
        • Starship
        • Sonic 3 AIR
        • Sonic Mania
        • Sonic Retro
        • Super Mario War
        • ScummVM
        • The Force Engine
        • Theme Hospital
        • TIC-80
        • Tomb Raider
        • TV Games
        • WASM-4
        • Windows
        • Wolfenstein 3D
  • Controllers
    • Supported Controllers
      • 🎮Gamepads
        • Special controllers
      • 🕹️Arcade Sticks
      • 🔫Lightguns
        • WiimoteGun
      • 🛞Wheels
      • ⌨️Keyboard
    • Controllers Configuration
    • Gun controls
    • Emulator specific controls mapping
      • Dolphin controller mapping
      • MAME64 controller mapping
      • Model2 controller mapping
      • RetroArch controller mapping
      • Teknoparrot controller mapping
    • Pad2Key
  • Advanced Features
    • Decorations (bezels)
    • Updates & Content Download
    • Kiosk and Kid mode
    • Save States
    • Retroachievements
    • Netplay
    • AI Translation Service
    • Batgui
    • retrobat.ini
    • Latency and blur reduction
    • Softpatching
  • TUTORIALS
    • Know issues & fixes
    • Symbolic links
    • Adding RetroArch Shader Sets to Retrobat
    • Customize Mega-Bezels
Powered by GitBook

Copyright The RetroBat Team 2019-2024

On this page
  • Remap Retroarch controls for a game
  • Remap Retroarch Hotkeys
  • Remap controller hotkeys
  • Remap keyboard hotkeys
  • Additional information
  • Location of the the remap file
  • RetroArch mapping principle

Was this helpful?

Export as PDF
  1. Controllers
  2. Emulator specific controls mapping

RetroArch controller mapping

PreviousModel2 controller mappingNextTeknoparrot controller mapping

Last updated 1 day ago

Was this helpful?

If the configuration of the buttons does not suit you for a game or a system managed by Retroarch (libretro cores), it is possible to create a specific mapping for a game.

Here is how to proceed.

Remap Retroarch controls for a game

Open RetroBat and launch the game for which you require a specific remapping.

Once in the game, press SELECT + buttons simultaneously to open the RetroArch menu, and select Quick Menu:

In the QUICK MENU list, you will find " Controls "

From there, proceed with the required remapping:

In this example, i have mapped the RetroPad left analog up input to the key defined for A in RetroBat (which is W on my keyboard):

Note that you can only remap the keys that have been passed by RetroBat to retroArch based on your controller.

Should you need to add new keys that were not configured in RetroBat, you would need to also change the mapping in the general settings of RetroArch.

Once the mapping is performed, exit and go back to the CONTROLS menu, then select the "Manage Remap Files" option:

In the next submenu, save the remap file for the game (it will apply to this game only)

Once saved, the new remap will now be used next time you run the game.

You cannot use the option to "save for core", as this would automatically be erased by RetroBat upon next launch.

Remap Retroarch Hotkeys

If you want to change the assignment of Retroarch hotkeys to controller or keyboard buttons, RetroBat offers a way to do so by appending dedicated files, here is how to proceed.

Template files can be found in the \system\resources\inputmapping\ folder of your RetroBat installation:

The file retroarch_controller_hotkeys.yml can be used to overwrite controller hotkeys assignment, and the file retroarch_kb_hotkeys.yml to overwrite keyboard hotkeys.

Remap controller hotkeys

Copy the file retroarch_controller_hotkeys.yml to the \user\inputmapping\ folder of your RetroBat installation.

Open the file with your preferred text editor.

The file is a yml-formatted file, by default all values are commented.

The first thing to do is to uncomment the actual section where the buttons are defined, as well as the container section, this is done by removing the # character on all lines after the #default: line, including the latter:

In this example, we will replace the fast-forward and rewind hotkeys with R1 and L1 buttons, and move the disk_eject and ai_service to the d-pad:

to do this, just assign the rewind feature to pageup (L1) and the hold_fast_forward to pagedown (R1), and then assign the disk_eject_toggle and ai_service to their respective d-pad buttons (left & right):

Now save the file:

Next time you run a game, the hotkeys will be the ones defined in the file:

In addition, it is also possible to perform a specific hotkey mapping for a single retroarch core, in this example, the mapping is different between the flycast core, by using toggle instead of hold for fast forward:

Remap keyboard hotkeys

Copy the file retroarch_kb_hotkeys.yml to the \user\inputmapping\ folder of your RetroBat installation.

Open the file with your preferred text editor.

The file is a yml-formatted file, by default all values are commented.

The first thing to do is to uncomment the actual section where the buttons are defined, as well as the container section, this is done by removing the # character on all lines after the #default: line, including the latter:

In this example, we will replace the fast-forward and rewind hotkeys with F9 and F10 keys:

to do this, just assign the rewind feature to F9 and the hold_fast_forward to F10:

Now save the file:

Next time you run a game, the hotkeys will be the ones defined in the file:

In addition, it is also possible to perform a specific hotkey mapping for a single retroarch core, in this example, the mapping is different between the flycast core, by using toggle instead of hold for fast forward:

Additional information

Location of the the remap file

Remap files are stored in the following folder of your RetroBat installation:

\emulators\retroarch\config\remaps\<core shortname>\

As you can see in this example: the value for "input_player1_stk_l_y-" is the value 8 (which corresponds to the change i have done above).

RetroArch mapping principle

Information on how RetroArch manages controls can be found here:

RetroArch has a 2-step approach with controllers mapping:

  • Step 1: mapping of your physical gamepad with RetroArch "RetroPad"

  • Step 2: mapping of the Retropad with the original console or computer game controller

The guide in this page only treats about the second step, as it is assumed that RetroBat is passing all your physical gamepad buttons to RetroArch (this should always be the case if you have correctly configured your controller in RetroBat).

The mapping done in Step 1 can be found in the following section of RetroArch configuration:

Changing the Step 1 mapping is not recommended, moreover the mapping would automatically be overwritten by RetroBat upon next launch of RetroArch.

()

click here to find this option
Input and Controls - Libretro Docs
Logo