Skip to content

Instantly share code, notes, and snippets.

@thiagoh
Created April 10, 2026 13:12
Show Gist options
  • Select an option

  • Save thiagoh/882078cf43a6f7864417a1a3ef9aa9d5 to your computer and use it in GitHub Desktop.

Select an option

Save thiagoh/882078cf43a6f7864417a1a3ef9aa9d5 to your computer and use it in GitHub Desktop.
Batocera Detailed System Report (redacted)

BATOCERA.LINUX - COMPREHENSIVE SYSTEM REPORT

Report Generated: April 4, 2026
System Analyzed: Batocera.linux v42 (Build: 2025/10/06)


EXECUTIVE SUMMARY

Batocera.linux is a specialized, open-source Linux distribution designed exclusively for retro gaming and emulation. It transforms any compatible computer, single-board computer (SBC), or handheld device into a dedicated gaming console capable of emulating over 200 gaming systems spanning from the 1970s to modern consoles.


1. WHAT IS BATOCERA.LINUX?

Core Definition

Batocera.linux is a live operating system built on Buildroot Linux that boots directly from USB drives, SD cards, or internal storage without requiring installation or modification of existing operating systems. It provides a complete, plug-and-play retro gaming solution with minimal configuration required.

Key Characteristics

Philosophy

Batocera follows a "Ready to Retro" philosophy emphasizing:

  • Zero configuration out-of-the-box experience
  • Automatic controller detection and mapping
  • Live system operation (no installation required)
  • Read-only root filesystem for stability
  • Persistent user data partition

2. SYSTEM ARCHITECTURE

Filesystem Structure

Batocera uses a unique partition layout:

Boot Partition (/dev/sda1 - 8GB):

  • Contains kernel, bootloader, and system files
  • Mounted at /boot and /media/BATOCERA
  • FAT32 or EXT4 formatted
  • Read-only during operation

Userdata Partition (/dev/sda2 - 468.9GB on this system):

  • Stores all user content: ROMs, saves, configurations
  • Mounted at /userdata and /media/SHARE
  • EXT4 formatted (supports NTFS, exFAT)
  • Read-write persistent storage

Overlay Filesystem:

  • Root filesystem (/) uses overlay mount
  • Base system (3.8GB) mounted read-only from compressed squashfs
  • Temporary changes stored in RAM (tmpfs - 256MB)
  • System resets to clean state on reboot

Directory Structure (/userdata/)

/userdata/
├── bios/           # BIOS files for emulators
├── roms/           # Game ROMs organized by system
├── saves/          # Save states and memory cards
├── system/         # Configuration files
├── themes/         # EmulationStation themes
├── music/          # Background music
├── screenshots/    # In-game screenshots
├── decorations/    # Bezels and overlays
├── cheats/         # Cheat codes
├── kodi/           # Kodi media center data
├── library/        # Game metadata
└── splash/         # Boot splash screens

3. CURRENT SYSTEM SPECIFICATIONS

Hardware Configuration

Model: Default_string
CPU: AMD Ryzen 3 4300U with Radeon Graphics

  • Cores: 4 physical cores
  • Max Frequency: 2700 MHz
  • Features: AVX2, SSE4.1
  • TDP: 35W (Ryzen Mobile)
  • Current Temperature: 33°C

GPU: AMD Radeon RX Vega 6 (Renoir - Ryzen 4000 Mobile Series)

  • Integrated graphics
  • Vulkan support enabled
  • Hardware video decoding

Memory:

  • Total RAM: 14.9 GB (14928 MB)
  • Available: 13.5 GB (13514 MB)
  • Swap: Disabled (0 GB)

Storage:

  • Total Disk: 476.9 GB SSD
  • Boot Partition: 8 GB (48% used - 3.9GB)
  • Data Partition: 468.9 GB (97% used - 447GB used, 16GB free)

Display:

  • Resolution: 1920x1080 (Full HD)
  • Refresh Rate: 59.96 Hz

Network:

  • Interface: wlan0 (Wi-Fi)
  • IP Address: <DEVICE_IP>/24
  • MAC Address: <MAC_ADDRESS>
  • Bluetooth: Enabled

Software Configuration

Operating System: Batocera.linux 42
Build Date: October 6, 2025 14:36
Build Version: 42c
Buildroot Version: 2024.11
Kernel Version: 6.15.11
Timezone: America/Toronto


4. EMULATION CAPABILITIES

Supported Systems (200+ Total)

This Batocera installation has ROM directories for 150+ gaming systems:

Home Consoles:

  • Nintendo: NES, SNES, N64, GameCube, Wii, Wii U, Switch
  • Sony: PlayStation 1/2/3, PSP, PS Vita
  • Sega: Master System, Genesis/Mega Drive, 32X, CD, Saturn, Dreamcast
  • Microsoft: Xbox, Xbox 360
  • Atari: 2600, 5200, 7800, Jaguar
  • NEC: TurboGrafx-16, PC Engine, SuperGrafx
  • 3DO, Neo Geo CD, Philips CDi, and many more

Handheld Consoles:

  • Nintendo: Game Boy, GBC, GBA, DS, 3DS, Virtual Boy
  • Sony: PSP, PS Vita
  • Sega: Game Gear
  • Atari: Lynx
  • Neo Geo Pocket, WonderSwan, and others

Arcade Systems:

  • MAME (Multiple Arcade Machine Emulator)
  • FinalBurn Neo
  • Atomiswave, Naomi, Triforce, Chihiro
  • Daphne (LaserDisc games)

Home Computers:

  • Commodore: C64, C128, Amiga 500/1200/CD32
  • Atari: ST, 800, 5200
  • Apple II, Apple IIGS
  • DOS, Windows
  • ZX Spectrum, Amstrad CPC
  • MSX, MSX2
  • And 40+ more computer systems

Modern Platforms:

  • Steam games
  • ScummVM (adventure games)
  • Ports (Doom, Quake, Duke Nukem 3D, etc.)
  • Solarus engine games
  • EasyRPG (RPG Maker games)

Emulator Engines

RetroArch Cores (114 cores installed): RetroArch is the primary emulation framework using libretro cores:

  • MAME, FBNeo (arcade)
  • Dolphin (GameCube/Wii)
  • PCSX2 (PS2)
  • PPSSPP (PSP)
  • Mupen64Plus-Next (N64)
  • Flycast (Dreamcast)
  • Beetle-Saturn, Kronos, Yabasanshiro (Saturn)
  • BSNES, Snes9x (SNES)
  • Genesis Plus GX (Genesis/Mega Drive)
  • MelonDS (Nintendo DS)
  • mGBA (Game Boy Advance)
  • And 100+ more specialized cores

Standalone Emulators:

  • Dolphin (GameCube/Wii) - Vulkan backend
  • PCSX2 (PlayStation 2) - Vulkan backend
  • PPSSPP (PSP)
  • Flycast (Dreamcast) - Vulkan backend
  • RPCS3 (PlayStation 3)
  • Xemu (Original Xbox)
  • Duckstation (PlayStation 1)
  • Citra (Nintendo 3DS)
  • ScummVM (adventure games)
  • DOSBox, DOSBox-Staging, DOSBox-X
  • VICE (Commodore emulators)
  • Hatari (Atari ST)
  • And many more

5. EMULATIONSTATION FRONTEND

Overview

EmulationStation is the graphical user interface that users interact with when Batocera boots. It provides:

  • Game library browsing organized by system
  • Box art and screenshot scraping
  • Game metadata display
  • Controller configuration
  • System settings access
  • Theme customization

Features

  • Automatic Game Detection: Scans ROM directories and displays games
  • Metadata Scraping: Downloads game information, box art, screenshots
  • Theme Support: Customizable visual themes
  • Collections: Automatic and custom game collections
  • Favorites System: Mark and organize favorite games
  • Recently Played: Track gaming history
  • Kiosk/Kid Mode: Restrict access to settings and specific games
  • Netplay Integration: Online multiplayer for supported systems

6. ADVANCED FEATURES

Graphics Enhancements

Shaders:

  • CRT simulation shaders
  • Scanline effects
  • LCD effects
  • Upscaling shaders (xBR, HQx, etc.)
  • Custom shader presets

Bezels/Decorations:

  • The Bezel Project integration
  • Custom bezels per game/system
  • Automatic bezel application

Resolution Scaling:

  • Internal resolution multipliers
  • Integer scaling options
  • Aspect ratio correction

Performance Optimization

Current System Configuration:

  • CPU Governor: Performance mode
  • GameCube: Vulkan backend, 2x internal resolution
  • Dreamcast: Vulkan backend, 1920x1440 internal resolution, 2x texture upscaling
  • PS2: Vulkan backend (PCSX2), 2x resolution, enhanced texture filtering
  • TDP Management: 100% power allocation for demanding systems

Optimization Features:

  • Per-game configuration overrides
  • Automatic performance profiles
  • Frame skipping options
  • Rewind functionality (save state every frame)
  • Fast-forward mode

RetroAchievements

Integration with RetroAchievements.org:

  • Unlock achievements in retro games
  • Track progress and leaderboards
  • Rich presence (show what you're playing)
  • Hardcore mode (no save states/cheats)

Netplay

Online multiplayer for RetroArch cores:

  • Host or join game sessions
  • Relay server support
  • Spectator mode
  • Built-in lobby system

Media Center

Kodi Integration:

  • Full Kodi media center accessible from EmulationStation
  • Play videos, music, view photos
  • Network streaming support
  • Add-on ecosystem

Network Features

  • Web Server: Access file system via web browser
  • SSH Access: Remote terminal access
  • Samba Shares: Network file sharing (Windows/Mac/Linux)
  • Bluetooth: Wireless controller support
  • Wi-Fi: Wireless networking
  • Syncthing: Sync saves/configs across multiple Batocera devices

7. CONFIGURATION SYSTEM

batocera.conf

Central configuration file at /userdata/system/batocera.conf:

Current Configuration Highlights:

audio.volume=100
system.cpu.governor=performance
system.timezone=America/Toronto
controllers.bluetooth.enabled=1
updates.enabled=1

# GameCube optimizations
gamecube.gfxbackend=vulkan
gamecube.internal_resolution=2
gamecube.wait_for_shaders=1
gamecube.powermode=highperformance

# Dreamcast optimizations
dreamcast.gfxbackend=vulkan
dreamcast.reicast_internal_resolution=1920x1440
dreamcast.reicast_texupscale=2

# PS2 optimizations
ps2.pcsx2_gfxbackend=14
ps2.pcsx2_resolution=2
ps2.pcsx2_vsync=1
ps2.pcsx2_ratio=16:9

# Global display settings
global.bezel=none
global.integerscale=0
global.shaderset=none
global.smooth=0

Per-Game Overrides

The system supports game-specific configurations:

gamecube["Super Smash Bros. Melee (USA).iso"].dolphin_aspect_ratio=1
ps2["God of War (USA).iso"].pcsx2_resolution=2

8. CONTROLLER SUPPORT

Automatic Detection

Batocera automatically detects and configures:

  • Xbox controllers (360, One, Series X/S)
  • PlayStation controllers (DualShock 3/4, DualSense)
  • Nintendo controllers (Switch Pro, Joy-Cons, Wii remotes)
  • Generic USB/Bluetooth controllers
  • Arcade sticks and fight sticks
  • Racing wheels
  • Light guns
  • Keyboard and mouse

Advanced Controller Features

  • Hotkey System: Special button combinations for emulator functions
  • Per-Emulator Remapping: Custom controls per system
  • Bluetooth Pairing: Built-in Bluetooth management
  • Multiple Controllers: Support for 4+ simultaneous players
  • Arcade Controls: Support for arcade cabinet hardware

9. INSTALLATION & DEPLOYMENT

Installation Methods

USB/SD Card (Live Boot):

  • Flash Batocera image to USB/SD
  • Boot from device
  • No installation required
  • Portable gaming solution

Internal Installation:

  • Install to internal drive
  • Dual-boot support
  • Dedicated gaming machine

Virtual Machine:

  • Run Batocera in VirtualBox, VMware, etc.
  • Testing and development

Hardware Requirements

Minimum:

  • x86_64 CPU or ARM SBC
  • 2GB RAM
  • 16GB storage
  • GPU with OpenGL 2.0

Recommended:

  • Modern multi-core CPU
  • 4GB+ RAM
  • 64GB+ storage
  • GPU with Vulkan support

Supported Devices:

  • Desktop PCs (Intel/AMD)
  • Laptops
  • Raspberry Pi (all models)
  • Odroid, Orange Pi, Rock Pi
  • Handheld gaming PCs
  • Mini PCs (Intel NUC, etc.)

10. COMPARISON WITH ALTERNATIVES

Batocera vs. RetroPie

Batocera Advantages:

  • Standalone OS (no Raspbian required)
  • Broader hardware support
  • Easier installation
  • Built-in Kodi
  • More modern emulators

RetroPie Advantages:

  • Larger community
  • More documentation
  • Raspberry Pi optimization
  • Longer development history

Batocera vs. Lakka

Batocera Advantages:

  • More emulators and systems
  • EmulationStation frontend (more user-friendly)
  • Kodi integration
  • Better standalone emulator support

Lakka Advantages:

  • Lighter weight
  • RetroArch-only focus
  • Simpler architecture

Batocera vs. Recalbox

Batocera Advantages:

  • More frequent updates
  • Better performance
  • More customization options
  • Larger system support

Recalbox Advantages:

  • Simpler interface
  • More beginner-friendly

11. COMMUNITY & ECOSYSTEM

Community Resources

  • Discord: Active chat and tech support
  • Forum: Read-only archive of discussions
  • Reddit: r/batocera community
  • GitHub: Issue tracking and development
  • Wiki: Comprehensive documentation
  • YouTube: Tutorials and showcases
  • Facebook/Twitter: News and updates

Development

  • Active open-source development
  • Regular updates and new features
  • Community contributions welcome
  • Transparent development process

Content

  • Theme Repository: 50+ EmulationStation themes
  • The Bezel Project: Thousands of game bezels
  • RetroAchievements: 100,000+ achievements
  • Translation Project: Multi-language support

12. USE CASES

Home Gaming Console

Transform any PC into a family gaming console with thousands of classic games.

Arcade Cabinet

Power custom arcade cabinets with authentic controls and CRT support.

Portable Gaming

USB stick gaming - carry your entire game library and play on any compatible PC.

Preservation

Preserve and play classic games that are no longer commercially available.

LAN Parties

Netplay support for multiplayer retro gaming sessions.

Media Center

Combined gaming and media center solution with Kodi integration.

Education

Learn about gaming history and computer architecture through emulation.


13. TECHNICAL DETAILS

Package Management

  • Pacman: Package manager for additional software
  • Overlays: Temporary system modifications
  • Custom Packages: Community-created packages

Scripting & Automation

  • Custom scripts support
  • Function key scripting
  • Event-based automation
  • Python/Bash scripting

Security

  • Secure boot support (optional)
  • SSH key authentication
  • VPN client support
  • Firewall configuration

Advanced Customization

  • Custom splash screens
  • Boot partition editing
  • System service management
  • Kernel parameter modification
  • udev rules customization

14. CURRENT SYSTEM STATUS

Storage Analysis

Critical: Low Disk Space

  • Data partition: 97% full (447GB used / 16GB free)
  • Recommendation: Clean up unused ROMs or expand storage

Performance Status

  • CPU temperature: 33°C (healthy)
  • Memory usage: 1.4GB / 14.9GB (9% - excellent)
  • System responsive and stable

Configuration Status

  • Performance mode enabled
  • Vulkan rendering active for modern systems
  • Enhanced graphics settings for GameCube, Dreamcast, PS2
  • Bluetooth and Wi-Fi operational
  • Updates enabled

Game Library

150+ system directories configured with extensive ROM collection across all major gaming platforms from 1970s-2020s.


15. MAINTENANCE & UPDATES

Update System

  • Stable Updates: Regular stable releases
  • Beta Channel: Cutting-edge features
  • Manual Updates: Download and flash new versions
  • Automatic Updates: Optional automatic update checking

Backup Recommendations

  • Backup /userdata/ partition regularly
  • Export save states
  • Document custom configurations
  • Use Syncthing for automatic sync

Troubleshooting

  • Built-in diagnostic tools
  • SSH access for advanced troubleshooting
  • Log file access
  • Community support resources

16. LEGAL & ETHICAL CONSIDERATIONS

BIOS Files

Many emulators require system BIOS files. Users must:

  • Own the original hardware
  • Dump BIOS from their own devices
  • Not distribute copyrighted BIOS files

ROM Files

  • Users must own physical copies of games
  • Downloading copyrighted ROMs is illegal in most jurisdictions
  • Homebrew and public domain games are legal alternatives

Batocera's Position

Batocera provides the emulation platform only. Users are responsible for obtaining games and BIOS files legally.


17. FUTURE DEVELOPMENT

Ongoing Improvements

  • New emulator additions
  • Performance optimizations
  • Hardware support expansion
  • UI/UX enhancements
  • Community feature requests

Version 42 Features

Current version (42) includes:

  • Linux kernel 6.15.11
  • Updated emulators
  • Enhanced Vulkan support
  • Improved controller support
  • Bug fixes and stability improvements

CONCLUSION

Batocera.linux represents a mature, comprehensive retro gaming solution that balances ease of use with advanced customization. Its live-boot architecture, extensive hardware support, and plug-and-play philosophy make it accessible to beginners while offering depth for enthusiasts.

The current system analyzed demonstrates a well-configured, high-performance setup capable of emulating systems from the earliest home consoles through modern platforms. With AMD Ryzen 4000-series hardware and optimized Vulkan rendering, this Batocera installation can handle demanding emulation tasks including GameCube, Dreamcast, and PlayStation 2 at enhanced resolutions.

As an open-source project with active development and a supportive community, Batocera continues to evolve, adding new features, emulators, and hardware support while maintaining its core mission: making retro gaming accessible to everyone.


Report End
System: Batocera.linux 42 on AMD Ryzen 3 4300U
Generated: April 4, 2026
Total Systems Supported: 200+
RetroArch Cores Installed: 114
Storage Used: 447GB / 469GB (95%)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment