4. Track progress in **History** menu or via popup notifications
### Custom Game Sources
Switch to custom sources via **Pause Menu > Games > Source Mode**.
Configure in `/saves/ports/rgsx/rgsx_settings.json`:
```json
{
"sources":{
"mode":"custom",
"custom_url":"https://example.com/my-sources.zip"
}
}
```
**Note**: If custom mode activated but Invalid/empty URL = using /saves/ports/rgsx/games.zip . You need to update games cache on RGSX menu after fixing URL.
---
## 🌐 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.
@@ -169,30 +165,40 @@ RGSX includes a web interface that launched automatically when using RGSX for re
├── 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
└── RealDebridAPI.txt # Real-Debrid API key
├── 1FichierAPI.txt # 1Fichier API key
├── AllDebridAPI.txt # AllDebrid API key
├── DebridLinkAPI.txt # Debrid-Link API key
└── RealDebridAPI.txt # Real-Debrid API key
```
---
@@ -202,11 +208,11 @@ RGSX includes a web interface that launched automatically when using RGSX for re
| 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 |
| 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 |
| Downloading BIOS file is ok but you can't download any games? | Activate custom DNS on Pause Menu> Settings and reboot , server can be blocked by your ISP. check any threat/website protection on your router too, especially on ASUS one|
| 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](https://discord.gg/Vph9jwg3VV).
> **Chaque fichier ne doit contenir QUE la clé, sans texte supplémentaire.**
> **Chaque fichier doit contenir UNIQUEMENT la clé, sans texte supplémentaire.**
### Télécharger des jeux
1. Parcourez les plateformes → sélectionnez un jeu
1. Parcourez les plateformes → Sélectionnez un jeu
2.**Téléchargement direct** : appuyez sur `Confirmer`
3.**Ajout à la file d'attente** : appuyez sur `X` (bouton Ouest)
4. Suivez la progression dans le menu **Historique** ou via les popups de notification
3.**File d'attente** : appuyez sur `X` (bouton Ouest)
4. Suivez la progression dans le menu **Historique** ou via les notifications popup
### Sources de jeux personnalisées
## 🌐 Interface Web (Batocera/Knulli uniquement)
Basculez vers les sources personnalisées via **Menu pause > Jeux > Mode des sources**.
Configurez dans `/saves/ports/rgsx/rgsx_settings.json` :
```json
{
"sources":{
"mode":"custom",
"custom_url":"https://example.com/my-sources.zip"
}
}
```
**Note** : si le mode personnalisé est activé mais que l'URL est invalide/vide = utilisation de `/saves/ports/rgsx/games.zip`. Vous devez mettre à jour le cache des jeux dans le menu RGSX après avoir corrigé l'URL.
---
## 🌐 Interface web (Batocera/Knulli uniquement)
RGSX inclut une interface web qui se lance automatiquement avec RGSX pour parcourir et télécharger des jeux à distance depuis n'importe quel appareil de votre réseau.
RGSX inclut une interface web qui se lance automatiquement quand vous utilisez RGSX, pour parcourir et télécharger des jeux à distance depuis n'importe quel appareil de votre réseau.
### Accéder à l'interface web
1.**Trouvez l'adresse IP de votre Batocera** :
-Dans le menu Batocera : `Paramètres réseau`
1.**Trouvez l'IP de votre Batocera** :
-Vérifiez dans le menu Batocera : `Paramètres réseau`
- Ou depuis un terminal : `ip addr show`
2.**Ouvrez dans un navigateur** : `http://[IP_BATO]:5000` ou `http://BATOCERA:5000`
2.**Ouvrez dans un navigateur** : `http://[IP_BATOCERA]:5000` ou `http://BATOCERA:5000`
- Exemple : `http://192.168.1.100:5000`
3.**Accessible depuis n'importe quel appareil** : téléphone, tablette, PC sur le même réseau
3.**Disponible depuis n'importe quel appareil** : téléphone, tablette, PC sur le même réseau
### Fonctionnalités de l'interface web
- 📱 **Compatible mobile**– Design responsive qui fonctionne sur tous les écrans
- 🔍 **Parcourir tous les systèmes**– Voir toutes les plateformes et les jeux
- ⬇️ **Téléchargements à distance**– Ajouter des téléchargements directement sur votre Batocera
- 📱 **Compatible mobile**– Design responsive sur tous les formats d'écran
- 🔍 **Parcourir tous les systèmes**– Voir toutes les plateformes et jeux
- ⬇️ **Téléchargements à distance**– Ajouter des téléchargements directement vers Batocera
- 📊 **Statut en temps réel**– Voir les téléchargements actifs et l'historique
- 🎮 **Même liste de jeux**– Utilise les mêmes sources que l'application principale
@@ -157,42 +153,52 @@ RGSX inclut une interface web qui se lance automatiquement avec RGSX pour parcou
**Depuis le menu RGSX**
1. Ouvrez le **menu pause** (Start/ALTGr)
2. Allez dans **Paramètres > Service web**
3.Basculez sur**Activer au démarrage**
2. Allez dans **Paramètres > Service Web**
3.Activez/Désactivez**Activer au démarrage**
4. Redémarrez votre appareil
**Configuration du port** : le service web utilise le port `5000` par défaut. Assurez-vous qu'il n'est pas bloqué par un pare-feu.
**Configuration du port** : le service web utilise le port `5000` par défaut. Assurez-vous que ce port n'est pas bloqué par votre pare-feu.
---
## 📁 Structure des fichiers
```
/roms/ports/RGSX/
├── __main__.py # Point d'entrée
├── controls.py # Gestion des entrées
├── display.py # Moteur de rendu
├── network.py # Gestionnaire de téléchargements
├── rgsx_settings.py # Gestionnaire de paramètres
├── assets/controls/ # Profils de manettes
├── languages/ # Traductions (EN/FR/DE/ES/IT/PT)
└── logs/RGSX.log # Logs d'exécution
/roms/windows/RGSX/
└── RGSX Retrobat.bat # Lanceur RetroBat
/roms/
├── ports/
│ ├── RGSX/
│ │ ├── __main__.py # Point d'entrée
│ │ ├── controls.py # Gestion des entrées
│ │ ├── display.py # Moteur de rendu
│ │ ├── network.py # Gestionnaire de téléchargements
│ │├── rgsx_settings.py # Gestionnaire des paramètres
├── RGSX Retrobat.bat # Lanceur Windows uniquement (utilisable même sans RetroBat)
├── gamelist.xml
├── images/
└── videos/
/saves/ports/rgsx/
├── rgsx_settings.json # Préférences utilisateur
├── controls.json # Mappage des contrôles
├── controls.json # Mapping des contrôles
├── history.json # Historique des téléchargements
├── rom_extensions.json # Cache des extensions supportées
├── systems_list.json # Systèmes détectés
├── games/ # Bases de données de jeux (par plateforme)
├── images/ # Images des plateformes
├── 1FichierAPI.txt # Clé API 1Fichier
├── AllDebridAPI.txt # Clé API AllDebrid
└── RealDebridAPI.txt # Clé API Real-Debrid
├── global_search_index.json # Cache de l'index de recherche globale
├── platform_games_count_cache.json
├── torrent_manifest_cache.json
├── games/ # Bases de données des jeux (par plateforme)
├── images/ # Images de plateformes
├── 1FichierAPI.txt # Clé API 1Fichier
├── AllDebridAPI.txt # Clé API AllDebrid
├── DebridLinkAPI.txt # Clé API Debrid-Link
└── RealDebridAPI.txt # Clé API Real-Debrid
```
---
@@ -201,36 +207,37 @@ RGSX inclut une interface web qui se lance automatiquement avec RGSX pour parcou
| Problème | Solution |
|----------|----------|
| Contrôles qui ne répondent plus | Supprimer`/saves/ports/rgsx/controls.json`+ redémarrer |
| Jeux non affichés | Menu pause > Jeux > Mettre à jour le cache des jeux |
| Téléchargement bloqué | Vérifier les clés API dans `/saves/ports/rgsx/` |
| Crash de l'application | Vérifier`/roms/ports/RGSX/logs/RGSX.log` |
| Changement de layout non pris en compte | Redémarrer RGSX après modification du layout |
| Les contrôles ne fonctionnent pas | Supprimez`/saves/ports/rgsx/controls.json`puis redémarrez, vous pouvez aussi supprimer `/roms/ports/RGSX/assets/controls/xx.json` |
| Aucun jeu ? | Menu Pause > Jeux > Mettre à jour le cache des jeux, puis vérifier Menu Pause > Jeux > Filtrer les plateformes et Afficher les plateformes non supportées |
| Des systèmes manquent dans la liste ? | RGSX lit `es_systems.cfg` pour afficher uniquement les systèmes supportés. Si vous voulez tous les systèmes : Menu Pause > Jeux > Afficher les plateformes non supportées |
| L'application crash | Vérifiez`/roms/ports/RGSX/logs/RGSX.log` ou `/roms/windows/logs/Retrobat_RGSX_log.txt` |
| Changement de layout non appliqué | Redémarrez RGSX après modification du layout |
| Problème de téléchargement de certains jeux ? | Ouvrez Menu Pause > Paramètres > Statut de connexion. Si un ou plusieurs sites requis sont en rouge, activez DNS personnalisé dans Paramètres et redémarrez. Vérifiez aussi les protections ISP/routeur (notamment ASUS web threat blocking). |
**Besoin d'aide ?** Partagez les logs depuis`/roms/ports/RGSX/logs/` sur [Discord](https://discord.gg/Vph9jwg3VV).
**Besoin d'aide ?** Partagez les logs de `/roms/ports/RGSX/logs/` sur [Discord](https://discord.gg/Vph9jwg3VV).
---
## 🤝 Contribution
- **Rapports de bugs** : ouvrez une issue GitHub avec les logs ou postez sur Discord
- **Rapports de bugs** : ouvrez une issue GitHub avec les logs, ou postez sur Discord
- **Demandes de fonctionnalités** : discutez d'abord sur Discord, puis ouvrez une issue
- **Contributions de code** :
- **Contributions code** :
```bash
git checkout -b feature/your-feature
# Testez sur Batocera/RetroBat
# Soumettez une Pull Request
# Tester sur Batocera/RetroBat
# Soumettre une Pull Request
```
---
## 📝 Licence
Logiciel libre et open-source. Utilisation, modification et distribution autorisées librement.
Logiciel gratuit et open-source. Utilisation, modification et distribution libres.
## Merci à tous les contributeurs et aux personnes qui suivent l'application
## Merci à tous les contributeurs et suiveurs du projet
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
