Skip to content

YamanAddas/YancoHub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YancoHub

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.

Platform Python License

YancoHub library

Why YancoHub

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

Features

Game Library

  • 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

Built-in Retro Emulator

  • 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

CatByte AI

  • 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

Interface

  • 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

Configuration

Connect Steam

  1. Get a free API key: steamcommunity.com/dev/apikey
  2. Settings → Accounts → Connect Steam → paste API key + Steam ID/profile URL

Connect Epic

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.

Add ROMs

Settings → Directories → ROM Directories → Add a folder organized by system (e.g., roms/snes/, roms/gba/)

BIOS

Place BIOS files in bios/ directory. Open-source GBA and PS1 BIOS included. See bios/README.md.

Download

Option A: Installer (recommended)

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.

Option B: Portable (no install)

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.

Option C: From source

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.py

Requirements (from source): Python 3.10+, Windows 10/11

Testing

pip install -r requirements-dev.txt
python -m pytest tests/ -v

381 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.

Building from Source

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 only

Output 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.

Security Note

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.

License

MIT

About

Unified Windows launcher for Steam, Epic, GOG, Xbox, EA, Ubisoft, Battle.net, local games, and retro-games with a built-in emulator and AI assistant.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors