User Tools

Site Tools


en:customize_decorations_bezels

Create a new bezels definition

  • connect to your batocera.linux, via the network for example
  • on the userdata folder (next to roms, bios, …) create a directory called decorations

  • inside the decorations folder, create a new directory, let's call him mybezels
  • go in batocera.linux menu > games > decorations
  • check that the mybezels decoration is available and select it

  • Note 1 : defaults bezels are available at https://github.com/batocera-linux/batocera-bezel
  • Note 2 : if you create a “default” folder instead of a custom name, bezels will replace the existing “default” bezel (the 2 folders will be virtually merge, taking as preference the userdata bezels)

Create a new bezel

In batocera.linux, you can create :

  • bezel for specific games
  • bezel for specific system (snes, gb, …)
  • default bezel for all

You can have the 3 at the same time. If a specific bezel if found for a game, it will be taken, otherwise, the system bezel will be taken, otherwise, the default bezel will be taken, otherwise if there is no suitable bezel, no bezel will apply.

A bezel is composed of 2 files. A .png file and a .info file.

specific games

Bezel for specific games must be placed in the games directory and have the same name as the rom.

Example: mybezels/games/mario1.png and mybezels/games/mario1.info

specific systems

Bezel for specific systems must be placed in the systems directory and have the same name as the system.

Example: mybezels/system/snes.png and mybezels/system/snes.info

default bezel

The default bezel must be at top and have the name default.png and default.info

Example

Create the file mybezel/default.png. A size of 1920×1080 is recommanded. The bezel will be drawn over the emulator rendering. Thus, you must keep transparent parts on the image.

the .info file

The .info file is a text file describing how the image must be displayed over the emulator.

  • width: width of the image
  • height: height of the image
  • top: top/left/bottom/right define the marge in pixel let to render the emulator.
  • left: top/left/bottom/right define the marge in pixel let to render the emulator.
  • bottom: top/left/bottom/right define the marge in pixel let to render the emulator.
  • right: top/left/bottom/right define the marge in pixel let to render the emulator.
  • opacity: a value between 0.0 and 1.0 to define the transparency of the image
  • messagex: the horizontal position of game messages (when a state is saved for example)
  • messagey: the vertical position of game messages (when a state is saved for example)
{
 "width":1920,
 "height":1080,
 "top":2,
 "left":241,
 "bottom":1,
 "right":243,
 "opacity":0.7000000,
 "messagex":0.220000,
 "messagey":0.120000
}
en/customize_decorations_bezels.txt · Last modified: 2019/01/23 20:16 by nadenislamarre