Installing Batocera: Linux Gaming Distribution

Jarret B

Well-Known Member
Staff member
Joined
May 22, 2017
Messages
364
Reaction score
403
Credits
13,257
Batocera is a gaming OS that you can install on a PC, Single Board Computer (SBC), Steamdeck and others. The OS support is for multiple SBC devices, not just Raspberry Pi devices.

This article may be a little involved at times. Especially if you want to run this Operating System (OS) under VirtualBox.

Download Batocera

Go to 'https://batocera.org/download' and you can see quite a list of devices that you can download the Batocera OS. For my examples, I will use the one for the PC. When I wrote this article, I downloaded the current version of Batocera 38 for the PC. The filename was 'batocera-x86_64-x86_64-38-20231014.img.gz'.

Since the 3 GB image file has been gzipped, we will need to extract the 8 GB contents. Open a terminal and switch to the folder with the file in question. Run the command:

gzip -dk <filename>

So in my case, the command was:

gzip -dk batocera-x86_64-x86_64-38-20231014.img.gz

The file that is extracted is called ' batocera-x86_64-x86_64-38-20231014.img'. Of course, if you want to try this out in VirtualBox, you need a VDI file.

Convert the IMG to VDI

You may think it would be better with an ISO file, but the IMG has multiple partitions in it. Because of the multiple partitions, you cannot convert it to an ISO file. The best thing is to convert it straight to a Virtual Disk Image (VDI) that is used as the hard drive for a virtual machine.

To convert the IMG file, we need to use the 'vboxmanage' program that is installed with VirtualBox. So, to use this program from a command-line, we need to know its location. By default, it should be '/usr/bin/vboxmanage', but we can verify it.

To find a file, you can use the 'find' command:

sudo find / -name vboxmanage

The command shows we are starting in the root folder of the system (/) and because of this, we need sudo privileges to access most of the folders to scan. The result shows the location of the 'vboxmanage' file.

Now that we have the location, the examples I use will place the file at '/usr/bin/'. You use your file location if it is different.

To convert the IMG file, it is in my Home folder and renamed to 'batocera.img', I use the command:

/usr/bin/vboxmanage convertdd --format VDI ~/batocera.img ~/batocera.vdi

Remember that the size of the VDI should be 3.1 GB. We can increase this to 20 GB to allow for the addition of game files. For my example, I'll make it 20 GB, or 20,000 MB. The command is:

/usr.bin/vboxmanage modifyhd ~/batocera.vdi --resize 20000

After a short time, the VDI files grow to 20 GB, you can specify more or less space as you need. Do not change the VDI while the VM is running.

The conversion should not take too long. Once it is done, you can leave the VDI file or move it to the default location of the Virtual Machines. You can find the default location in the settings under VirtualBox.

Add VDI to VirtualBox

Now that we have the VDI file, we need to create a new virtual machine in VirtualBox to use the VDI.

Select 'New' to create a new virtual machine (VM). For the settings, use a name that you like for the VM. I named mine 'Batocera'. For the ISO file, leave it at 'None'. The 'Type' should be 'Linux' and the 'Version' is 'Other Linux (64-bit)'. Select the 'Next' button.

Now you'll need to set the memory and number of CPUs to use for the VM. These would vary depending on your system resources available. Click 'Next' again.

The last step to create the VM is to click on 'Use an existing Virtual Hard Disk File'. Click on 'Add' and then find the VDI, highlight it and then click 'Select'. Click 'Next' then 'Finish' to get the VM created.

You can now select the new VM and then click on 'Settings' to change other options, such as video memory, network adapter, etc. It may be best to set the network type to ‘Bridged’.

Burn to a USB

For better performance, you can use Balena Etcher or another image writing program to burn the IMG file to a USB Flash Drive.

Once done, you only need to boot from the USB drive.

Starting Batocera

When first started, there are few games on the OS. The systems with a game show up on the list. The full list of emulators is:

3do​
3DO Interactive Multiplayer​
3ds​
Nintendo 3DS​
abuse​
Abuse SDL​
adam​
Coleco_Adam​
advision​
Adventure Vision​
amiga1200​
Amiga 1200/AGA​
amiga500​
Amiga 500/OCS/ECS​
amigacd32​
Amiga CD32​
amigacdtv​
Commodore CDTV​
amstradcpc​
Amstrad CPC​
apfm1000​
APF-MP1000/MP-1000/M-1000​
apple2​
Apple II​
apple2gs​
Apple IIGS​
arcadia​
Arcadia 2001/et al.​
archimedes​
Archimedes​
arduboy​
Arduboy​
astrocde​
Bally Astrocade/Arcade/ABA-1000​
atari2600​
Atari 2600/VCS​
atari5200​
Atari 5200​
atari7800​
Atari 7800​
atari800​
Atari 800​
atarist​
Atari ST​
atom​
Acorn Computers​
atomiswave​
Sammy Atomiswave​
bbc​
BBC Micro/Master/Archimedes​
bottles​
Bottles​
c128​
Commodore 128 (C128)​
c20​
Commodore VIC-20/VC-20​
c64​
Commodore 64​
camplynx​
Camputers Lynx​
cannonball​
Cannonball​
cavestory​
Cave Story​
cdi​
Compact Disc Interactive/CD-i​
cdogs​
C-Dogs​
channelf​
Fairchild Channel F​
coco​
TRS-80/Tandy Color Computer​
colecovision​
ColecoVision​
cplus4​
Commodore Plus/4​
crvision​
CreatiVision/Educat 2002/Dick Smith Wizzard/FunVision​
daphne​
DAPHNE (Laserdisc)​
devilutionx​
DevilutionX​
dos​
DOSbox​
dreamcast​
Sega Dreamcast​
easyrpg​
EasyRPG​
ecwolf​
ECWolf​
eduke32​
EDuke32​
electron​
Acorn Electron​
Emulator: Dolphin​
Dolphin​
fbneo​
FinalBurn Neo​
fds​
Family Computer Disk System/Famicom​
flash​
Flashpoint​
flatpak​
Flatpak​
fm7​
Fujitsu Micro 7 (FM-7)​
fmtowns​
FM Towns/Towns Marty​
fpinball​
Future Pinball​
fury​
Ion Fury​
gamate​
Gamate/chāojí xiǎozi/Super Boy/chāojí shéntóng/Super Child Prodigy​
gameandwatch​
Game & Watch​
gamecom​
Game.com​
gamecube​
Nintendo GameCube​
gamegear​
Game Gear​
gb​
Game Boy​
gb2players​
Game Boy 2 Players​
gba​
Game Boy Advance​
gbc​
Game Boy Color​
gbc2players​
Game Boy Color 2 Players​
geforcenow​
GeForce NOW​
gmaster​
Game Master/Systema 2000/Super Game/Game Tronic​
gx4000​
Amstrad GX4000​
gzdoom​
GZDoom​
hcl​
Hydra Castle Labyrinth​
heroic​
Heroic Games Launcher (Epic Games)​
hurrican​
Hurrican​
ikemen​
Ikemen Go​
intellivision​
Intellivision​
jaguar​
Atari Jaguar​
laser310​
Laser 310​
lcdgames​
Handheld LCD Games​
lowresnx​
Lowres NX​
lutro​
Lutro​
lynx​
Atari Lynx​
macintosh​
( needs link to appropriate model description)​
mame/model1​
Sega Model 1​
mastersystem​
Sega Master System/Mark III​
megadrive​
Sega Genesis/Mega Drive​
megaduck​
Mega Duck/Cougar Boy​
model2​
Sega Model 2​
model3​
Sega Model 3​
moonlight​
Moonlight​
mrboom​
Mr. Boom​
msx1​
Microsoft MSX1​
msx2​
Microsoft MSX2​
msx2+​
Microsoft MSX2plus​
msxturbor​
Microsoft MSX turboR​
mugen​
M.U.G.E.N​
n64​
Nintendo 64​
n64dd​
Nintendo 64DD​
naomi​
Sega NAOMI​
naomi2​
Sega NAOMI 2​
nds​
Nintendo DS​
neogeo​
Neo Geo​
neogeo​
NEO•GEO MVS​
neogeocd​
Neo Geo CD​
nes​
Nintendo Entertainment System/Famicom​
ngp​
Neo Geo Pocket​
ngpc​
Neo Geo Pocket Color​
odyssey2​
Magnavox Odyssey²/Philips Videopac G7000/Philips Odyssey/Odyssey²​
openbor​
Open Beats of Rage​
openjazz​
Openjazz​
pc88​
NEC PC-8800​
pc98​
NEC PC-9800/PC-98​
pcengine​
PC Engine/TurboGrafx-16​
pcenginecd​
PC Engine CD-ROM²/PC Engine Duo R/PC Engine Duo RX/TurboGrafx-CD/TurboDuo​
pcfx​
NEC PC-FX​
pet​
Commodore PET​
pico​
Sega Pico​
pico8​
PICO-8 fantasy console​
plugnplay​
Plug 'n' Play/Handheld TV Games​
pokemini​
Pokémon Mini​
ports​
Native ports​
prboom​
PrBoom​
ps2​
Sony PlayStation 2​
ps3​
Sony PlayStation 3​
psp​
PlayStation Portable​
psvita​
PlayStation_Vita​
psx​
Sony PlayStation​
pv1000​
Casio PV-1000/ぴーぶいせん/Pi Bui-Sen​
pygame​
pygame​
raze​
Raze​
RetroArch​
RetroArch​
samcoupe​
SAM Coupé​
satellaview​
Satellaview​
saturn​
Sega Saturn​
scummvm​
ScummVM​
scv​
Super Cassette Vision/スーパーカセットビジョン/Suupaa Kasetto Bijon​
sdlpop​
SDLPoP​
sega32x​
Sega 32X​
segacd​
Sega CD/Mega CD​
sg1000​
Sega SG-1000/SG-1000 II/SC-3000​
sgb​
Super Game Boy​
snes​
Super Nintendo Entertainment System​
snes_msu-1​
Super NES CD-ROM/SNES MSU-1​
socrates​
Socrates/Prof. Weiss-Alles/Professeur Saitout; Jeu Educatif Video​
solarus​
Solarus​
sonicretro​
Star Engine/Sonic Retro Engine​
steam​
Steam​
sufami​
SuFami Turbo​
superbroswar​
Super Mario War​
supergrafx​
PC Engine SuperGrafx/SuperGrafx/PCエンジンスーパーグラフィックス/Pī Shī Enjin SūpāGurafikkusu/PC Engine 2​
supervision​
Watara Supervision​
supracan​
Super A'Can​
thomson​
Thomson MO/TO Series Computer​
ti99​
TI-99/4 (TI-99/4A)​
tic80​
TIC-80 fantasy console​
triforce​
Triforce​
tutor​
Tomy Tutor/Pyūta/Grandstand Tutor​
tyrquake​
TyrQuake​
uzebox​
Uzebox Open-Source console​
vectrex​
Vectrex​
vgmplay​
MAME Video Game Music Player​
videopacplus​
Philips Videopac+ G7400/G7420​
virtualboy​
Virtual Boy​
vpinball​
Visual Pinball​
vsmile​
V.Smile (TV LEARNING SYSTEM)​
wasm4​
WASM4 fantasy console​
wii​
Nintendo Wii​
wiiu​
Nintendo Wii U​
windows​
WINE​
windows_installers​
N/A, Batocera utility​
wswan​
WonderSwan​
wswanc​
WonderSwan Color​
x1​
Sharp X1​
x68000​
Sharp X68000​
xash3d_fwgs​
Xash3D FWGS​
xbox​
Microsoft Xbox​
xbox360​
Microsoft Xbox 360​
xegs​
Atari XEGS​
xrick​
Rick Dangerous​
zx81​
Sinclair ZX81​
zxspectrum​
ZX Spectrum​

The first column is the shortened name, or folder name, and the second column is the full name of the console.

Once in Batocera, you can press the F1 key to get to a folder listing of Linux, which is PCManFM.

There is a folder named 'ROMS' which where these folders exist. Place any ROMS you have into the folders and when you restart Batocera, you'll see the emulator on the list.

To add files to the list, you can access a set share on the system. You'll need to use F1 and then get to a terminal. In a Terminal, use the command 'ip a' and find your IP Address of the Batocera system. Connect to the share from another system, which will be '\\IP-Address\share'.

From here, you simply copy the ROMS to their folder.

Conclusion

From here, you can get started with Batocera. Keep in mind that you can run this OS on many types of devices.

Enjoy old-style games and have some fun!
 


Latest posts

Top