How adhnan23/openemux works
OpenEmux is a Linux-native GTK frontend for RetroArch. Users set up the app, import or scan their own ROMs, browse and organize the library with artwork, then launch a game through RetroArch; settings cover BIOS, input, and shaders. The graph also preserves startup provisioning and runtime support. Several subsystems are represented by their exact source directory because their individual implementation files were not sampled; those links rely on README statements where noted.
Main entry points: window.py Library window · preferences.py Preferences · runtime_manager.py Game runtime · app.py GTK application
Components 25
Startup & setup
- Application entry
src/openemux/main.py - GTK application
src/openemux/app.py - First-boot setup
src/openemux/core/first_boot.py - Core provisioning
src/openemux/core/retroarch_buildbot_updater.py
Game library
- Library window
src/openemux/ui/window.py - ROM import
src/openemux/ui/import_flow.py - Library scanning
src/openemux/core/scanner.py - Console catalog
src/openemux/core/systems.py - Collections & playlists
src/openemux/core/playlist_manager.py - ROM grid
src/openemux/ui/grid.py
Artwork
- Artwork editor
src/openemux/ui/artwork_manager.py - Artwork search
src/openemux/core/artwork_search.py - Cover sync
src/openemux/core/cover_sync.py - Local artwork lookup
src/openemux/core/scraper.py
Settings
- Configuration
src/openemux/core/config.py - Preferences
src/openemux/ui/preferences.py - BIOS status
src/openemux/core/bios_manager.py - Input & shaders
src/openemux/core
Gameplay
- Game runtime
src/openemux/core/runtime_manager.py - RetroArch launcher
src/openemux/core/retroarch_launcher.py - RetroArch commands
src/openemux/core/retroarch_command.py - Save states
src/openemux/core/save_states.py - Game window
src/openemux/ui/game_window.py
Other components
- Player
- RetroArch
Connections 28
- Player → Application entry: starts
README.md - Application entry → GTK application: builds
src/openemux/main.py - GTK application → Configuration: initializes
src/openemux/app.py - GTK application → First-boot setup: runs setup
src/openemux/app.py - First-boot setup → Core provisioning: provisions cores
README.md - GTK application → Library window: opens
src/openemux/app.py - Player → ROM import: adds ROMs
README.md - Library window → Library scanning: scans library
src/openemux/ui/window.py - Library scanning → Console catalog: resolves consoles
- Library window → Collections & playlists: manages lists
src/openemux/ui/window.py - Library window → ROM grid: displays library
src/openemux/ui/window.py - ROM grid → Local artwork lookup: loads artwork
src/openemux/ui/grid.py - Player → Artwork editor: edits artwork
README.md - Artwork editor → Artwork search: searches providers
src/openemux/ui/artwork_manager.py - Artwork editor → Local artwork lookup: saves local art
src/openemux/core/scraper.py - Library window → Cover sync: syncs covers
src/openemux/ui/window.py - Player → Preferences: configures
README.md - Preferences → Configuration: updates settings
src/openemux/ui/window.py - Preferences → BIOS status: checks BIOS
src/openemux/ui/window.py - Preferences → Input & shaders: sets controls
README.md - Preferences → Input & shaders: sets shaders
README.md - Player → Game runtime: launches game
README.md - Library window → Game runtime: starts session
src/openemux/ui/window.py - Game runtime → RetroArch launcher: starts process
src/openemux/core/runtime_manager.py - RetroArch launcher → RetroArch: launches
README.md - Game runtime → RetroArch commands: sends commands
src/openemux/core/runtime_manager.py - Game runtime → Save states: manages states
src/openemux/core/runtime_manager.py - Library window → Game window: presents gameplay
src/openemux/ui/window.py