🎮 Retro Game Sets Xtra (RGSX)

Discord Support • Installation • French Documentation • Troubleshoot / Common Errors •

A free, user-friendly ROM downloader for Batocera, Knulli, and RetroBat with multi-source support.

---

🚀 Installation

Quick Install (Batocera / Knulli)

SSH or Terminal access required:

curl -L bit.ly/rgsx-install | sh

After installation:

1. Update game lists: Menu > Game Settings > Update game list
2. Find RGSX under PORTS or Homebrew and ports

Manual Install (All Systems)

1. Download: RGSX_full_latest.zip
2. Extract:
   • Batocera/Knulli: Extract ports folder to /roms/
   • RetroBat: Extract both ports and windows folders to /roms/
3. Refresh: Menu > Game Settings > Update game list

Manual Update (if automatic update failed)

Download latest release : RGSX_update_latest.zip

Installed paths:

• /roms/ports/RGSX (all systems)
• /roms/windows/RGSX (RetroBat only)

---

🎮 Usage

First Launch

• Auto-downloads system images and game lists
• Auto-configures controls if your controller is recognized
• Controls broken? Delete /saves/ports/rgsx/controls.json and restart

Keyboard Mode: When no controller is detected, controls display as [Key] instead of icons.

Pause Menu Structure

Root categories

• Games (downloads, scans, platform visibility)
• Language (switch UI language)
• Controls (help and remap)
• Display (layout, fonts, monitor/mode, visual options)
• Settings (music, symlink, auto extract, network and API status)
• Support (generate support ZIP/log bundle)
• Quit (exit or restart)

Controls

• View Controls Help (shows current mapped actions)
• Remap Controls (reconfigure keyboard/controller mapping)

Display

• Layout (3×3, 3×4, 4×3, 4×4)
• Font Size submenu (general UI + footer text)
• Font Family (Pixel or DejaVu)
• Monitor selection (when multiple monitors are detected)
• Screen Mode (Windows only)
• Light Mode (performance-friendly rendering)
• Hide Unknown Extension Warning (toggle unsupported extension warnings)

Games

• Update Game Cache (redownload systems/games data)
• Scan Owned ROMs (add locally owned ROMs to history)
• Download History (view/manage download entries)
• Show Unsupported Platforms (toggle platforms without local ROM folders)
• Filter Platforms (source/platform visibility menu)

Settings

• Background Music Toggle (enable/disable music)
• Symlink Options (choose copy/symlink behavior)
• Auto Extract Toggle (automatic archive extraction)
• ROMs Folder Selector (set custom ROM root folder)
• Web Service (Batocera/Knulli) (start web UI at boot)
• Custom DNS (Batocera/Knulli) (workaround for ISP/domain blocking)
• API Keys Status (check provider key presence)
• Connection Status (test required updates/sources sites)

---

✨ Features

• 🎯 Smart System Detection – Auto-discovers supported systems from es_systems.cfg
• 📦 Intelligent Archive Handling – Auto-extracts archives when systems don't support ZIP files
• 🔑 Premium Unlocking – 1Fichier API + AllDebrid/Debrid-Link/Real-Debrid fallback for unlimited downloads
• 🎨 Fully Customizable – Layout (3×3 to 4×4), fonts, font sizes (UI + footer), languages (EN/FR/DE/ES/IT/PT)
• 🎮 Controller-First Design – Auto-mapping for popular controllers + custom remapping support
• 🔍 Advanced Filtering – Search by name, hide/show unsupported systems, filter platforms
• 📊 Download Management – Queue system, history tracking, progress notifications
• ♿ Accessibility – Separate font scaling for UI and footer, keyboard-only mode support

🔑 API Keys Setup

For unlimited 1Fichier downloads, add your API key(s) to /saves/ports/rgsx/:

• 1FichierAPI.txt – 1Fichier API key (recommended)
• AllDebridAPI.txt – AllDebrid fallback (optional)
• DebridLinkAPI.txt – Debrid-Link fallback (optional)
• RealDebridAPI.txt – Real-Debrid fallback (optional)

Each file must contain ONLY the key, no extra text.

Downloading Games

1. Browse platforms → Select game
2. Direct Download: Press Confirm
3. Queue Download: Press X (West button)
4. Track progress in History menu or via popup notifications

🌐 Web Interface (Batocera/Knulli Only)

RGSX includes a web interface that launched automatically when using RGSX for remote browsing and downloading games from any device on your network.

Accessing the Web Interface

1. Find your Batocera IP address:

   • Check Batocera menu: Network Settings
   • Or from terminal: ip addr show

2. Open in browser: http://[BATOCERA_IP]:5000 or http://BATOCERA:5000

   • Example: http://192.168.1.100:5000

3. Available from any device: Phone, tablet, PC on the same network

Web Interface Features

• 📱 Mobile-Friendly – Responsive design works on all screen sizes
• 🔍 Browse All Systems – View all platforms and games
• ⬇️ Remote Downloads – Queue downloads directly to your Batocera
• 📊 Real-Time Status – See active downloads and history
• 🎮 Same Game Lists – Uses identical sources as the main app

Enable/Disable Web Service at Boot, without the need to launch RGSX

From RGSX Menu

1. Open Pause Menu (Start/ALTGr)
2. Navigate to Settings > Web Service
3. Toggle Enable at Boot
4. Restart your device

Port Configuration: The web service runs on port 5000 by default. Ensure this port is not blocked by firewall rules.

---

📁 File Structure

/roms/
├── ports/
│   ├── RGSX/
│   │   ├── __main__.py                # Entry point
│   │   ├── controls.py                # Input handling
│   │   ├── display.py                 # Rendering engine
│   │   ├── network.py                 # Download manager
│   │   ├── rgsx_settings.py           # Settings manager
│   │   ├── assets/controls/           # Controller profiles
│   │   ├── languages/                 # Translations (EN/FR/DE/ES/IT/PT)
│   │   └── logs/RGSX.log              # Runtime logs
│   ├── gamelist.xml
│   ├── images/
│   └── videos/
└── windows/
    ├── RGSX Retrobat.bat              # Launcher for Windows only (can be used without retrobat too)
    ├── gamelist.xml
    ├── images/
    └── videos/

/saves/ports/rgsx/
├── rgsx_settings.json        # User preferences
├── controls.json             # Control mapping
├── history.json              # Download history
├── systems_list.json         # Detected systems
├── global_search_index.json  # Global search index cache
├── platform_games_count_cache.json
├── torrent_manifest_cache.json
├── games/                    # Game databases (per platform)
├── images/                   # Platform images
├── 1FichierAPI.txt           # 1Fichier API key
├── AllDebridAPI.txt          # AllDebrid API key
├── DebridLinkAPI.txt         # Debrid-Link API key
└── RealDebridAPI.txt         # Real-Debrid API key

---

🛠️ Troubleshooting

Issue	Solution
Controls not working	Delete /saves/ports/rgsx/controls.json + restart app, you can try delete /roms/ports/RGSX/assets/controls/xx.json too
No games ?	Pause Menu > Games > Update Game Cache, then check Pause Menu > Games > Filter Platforms and Show Unsupported Platforms
Missing systems on the list?	RGSX read es_systems.cfg to show only supported systems, if you want all systems : Pause Menu > Games > Show unsupported systems
App crashes	Check /roms/ports/RGSX/logs/RGSX.log or /roms/windows/logs/Retrobat_RGSX_log.txt
Layout change not applied	Restart RGSX after changing layout
Problem downloading some Games ?	Open Pause Menu > Settings > Connection Status. If one or more required sites are red, enable Custom DNS in Settings and reboot. Also check ISP/router protections (especially ASUS web threat blocking).

Need help? Share logs from /roms/ports/RGSX/logs/ on Discord.

---

🤝 Contributing

• Bug Reports: Open GitHub issue with logs or post on Discord
• Feature Requests: Discuss on Discord first, then open issue
• Code Contributions:

  git checkout -b feature/your-feature
  # Test on Batocera/RetroBat
  # Submit Pull Request
  

---

📝 License

Free and open-source software. Use, modify, and distribute freely.

Thanks to all contributors, and followers of this app

If you want to support my project you can buy me a beer : https://bit.ly/donate-to-rgsx

Developed with ❤️ for the retro gaming community.