All your games. One place. No clutter.
YancoHub is a unified PC game launcher that aggregates Steam, Epic, GOG, Xbox, EA, Ubisoft, Battle.net, local games, and retro ROMs into one dark cinematic interface — with a built-in retro emulator and CatByte AI gaming companion.
| Playnite | LaunchBox | GOG Galaxy | YancoHub | |
|---|---|---|---|---|
| Free & open source | ✅ | ❌ ($30-75) | ❌ | ✅ |
| Multi-store aggregation | ✅ | ✅ | ✅ | ✅ (8 stores) |
| Built-in retro emulator | ❌ (needs RetroArch) | ❌ (needs emulators) | ❌ | ✅ (19 systems) |
| AI gaming companion | ❌ | ❌ | ❌ | ✅ (CatByte) |
| Lightweight (no .NET/WPF) | ❌ | ❌ | N/A | ✅ |
| Cinematic 3D UI | ❌ | Themes only | ❌ | ✅ |
- 8 stores — Steam, Epic, GOG, Xbox/Game Pass, EA, Ubisoft, Battle.net
- Account sync — Steam Web API (full owned library), GOG Galaxy DB (multi-platform), Epic catalog cache (automatic)
- Local games — Scan any directory for executables
- Retro ROMs — 25 systems with auto-detection and deduplication
- 19 systems run directly in-app via EmulatorJS — no external emulator needed
- Tier 1 (zero setup): NES, SNES, GB, GBC, GBA, Genesis, Master System, Game Gear, Atari 2600, Neo Geo Pocket, PS1
- Tier 2 (user BIOS): Neo Geo, CPS1/2/3, MAME, NDS
- Tier 3 (beta): N64
- Cinematic per-system boot sequences, save states, screenshots, glassmorphism pause menu
- Gaming companion with multiple AI backend options (Ollama, OpenClaw, LM Studio, OpenAI, or any OpenAI-compatible endpoint)
- Ask for tips, walkthroughs, recommendations
- Aware of your current game and library
- Screenshot analysis for stuck moments
- Dark cinematic aesthetic with teal (#00e5c1) accent
- 3D hexagonal crystal carousel with perspective transforms
- Animated starfield with nebulae and floating particles
- Glassmorphism panels and overlays
- Keyboard, mouse, and gamepad navigation
- Get a free API key: steamcommunity.com/dev/apikey
- Settings → Accounts → Connect Steam → paste API key + Steam ID/profile URL
Epic games are detected automatically from the Epic Games Launcher's local catalog cache — just log in to the Epic Launcher and your owned games will appear in YancoHub. No extra tools needed.
Settings → Directories → ROM Directories → Add a folder organized by system (e.g., roms/snes/, roms/gba/)
Place BIOS files in bios/ directory. Open-source GBA and PS1 BIOS included. See bios/README.md.
Download YancoHub-x.x.x-setup.exe from Releases. Installs to your AppData, creates Start Menu and Desktop shortcuts, and adds an uninstaller to Add/Remove Programs.
Download YancoHub-x.x.x-portable.zip from Releases. Extract anywhere and run YancoHub.exe. All data stays in the same folder — perfect for USB drives or restricted machines.
git clone https://github.com/YamanAddas/YancoHub.git
cd YancoHub
python -m venv venv
venv\Scripts\pip install -r requirements.txt
venv\Scripts\python launch.pyRequirements (from source): Python 3.10+, Windows 10/11
pip install -r requirements-dev.txt
python -m pytest tests/ -v381 tests covering constants, ROM header parsing, user data persistence, BIOS scanning, chat history, metadata caching, Flask API routes, gamepad input, security and path validation, save backups, year-summary aggregation, the settings schema, single-instance, update checks, and startup registry. All tests use temp files and mocks — no network access, no side effects.
pip install -r requirements-dev.txt
python build.py # Inno Setup installer + portable zip
python build.py --portable # Portable zip only
python build.py --installer # Installer onlyOutput goes to dist/. The installer build prefers Inno Setup 6 (recommended) and falls back to NSIS 3 if Inno Setup isn't installed.
Code signing is wired in via SIGNING.md — set YANCOHUB_SIGN_CERT (and YANCOHUB_SIGN_PASS for .pfx files) before running build.py and the resulting installer is signed automatically.
userdata.json stores your settings, including your Steam API key. This file is gitignored and local-only — do not share it or commit it to version control.
MIT
