/ckau-book-custom-systems

EmulationStation displays systems based on a file called es_systems.cfg. In other distributions, this is typically the only file. However, in Batocera FIXME and higher, the /userdata/system/configs/emulationstation/es_systems_<custom_name>.cfg can be used as an overlay to the original /usr/share/emulationstation/es_systems.cfg file.

ckau-book-custom-systems

Emulationstation Customized ES Systems for Batocera and Retrobat.

Purpose

EmulationStation displays systems based on a file called es_systems.cfg. In other distributions, this is typically the only file. However, in Batocera FIXME and higher, and in Retrobat 5 and higher, one or more es_systems_<custom_name>.cfg files can be used as an overlay to the original /usr/share/emulationstation/es_systems.cfg file.

This repository contains .cfg files for adding additional systems to your Batocera or Retrobat installation, all supported by Ckau Book theme.

You must use a unique <custom_name> field when adding a new system if you wish to keep the old one in addition. However, if using duplicate shortnames is a necessity and you still want the new and old system to exist simultaneously, you can also put both systems in a single CFG file.

Once implemented in your system, you can use our Emulationstation Theme: https://github.com/CkauNui/ckau-book

How to install new systems

Batocera

Additional .cfg files are located in two directories of this repository:

/Batocera/Raspberry Pi 4 (base)/system /Batocera/x86 64bit (additional)/system

while .cfg files in Raspberry Pi 4 (base) can be used in any Batocera installation, the ones in x86 64bit (additional) can be only added in a x86 PC Batocera environment.

To add the new systems, the desired .cfg files must be copied in the same directory as es_systems.cfg, which for Batocera is

/usr/share/emulationstation/

When done, for each added system you should create the proper /roms/<system_name> directory and put your roms into it. Please check the right name to create, following the examples located in /Batocera/Raspberry Pi 4 (base)/roms or /Batocera/x86 64bit (additional)/roms directories of this repository.

You'll also find a _info.txt file that explains which extensions are allowed for each system. For some systems, there may be also the need to install additional emulators (check the same _info.txt file for instructions).

A newly added system, if there is at least one rom file, will automatically be recognized by Batocera at the next boot.

Retrobat

Additional .cfg files are located in the following directory of this repository:

/Retrobat/system

Also for Retrobat, the additional .cfg files must be in the same directory as es_systems.cfg. However, Retrobat install location may vary according to what you have chosen during the installation profile. Assuming that Retrobat is installed in C:\Retrobat, es_systems.cfg directory is located in

C:\RetroBat\emulationstation\.emulationstation\

Please replace C:\Retrobat with your actual installation path.

When done, for each added system you should create the proper /roms/<system_name> directory and put your roms into it. Please check the right name to create in the /Retrobat/roms directory of this repository.

You'll also find a _info.txt file that explains which extensions are allowed for each system. For some systems, there may be also the need to install additional emulators in Retrobat (check the same _info.txt file for instructions). A newly added system, if there is at least one rom file, will automatically be recognized by Retrobat at the next boot.

Credits

License

  • ALLOWED
    • Share and duplicate as it is
    • Edit, alter, change it
  • REQUIREMENTS:
    • Attribution, give credit to the creator
    • Indicate changes to it
    • Publish the changes under the same license
  • PROHIBITED:
    • Commercial distribution

Copyrights / Sources

  • Each brand of hardware and software here represented as a tribute.
  • All logos, trademarks and photos are copyright of their respective owners.
  • es_systems_switch.cfg generate after install nintendo switch emulator from project: https://github.com/ordovice/batocera-switch.
  • es_systems_makecode.cfg generate after install MakeCode Arcade emulator from project: https://github.com/Vegz78/McAirpos.

Logo Notice

The used logos and trademarks are copyright of their respective owners.

Shield: CC BY-NC-SA 4.0

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

CC BY-NC-SA 4.0