How hydralauncher/hydra works
Hydra is an Electron gaming platform: players discover games, manage a library, download and install titles, then use game, social, achievement, and cloud-save features. The main process coordinates desktop services; React provides the standard and controller-oriented interfaces, while Rust supplies native capabilities including cloud-save and torrent code. The README establishes the product capabilities; sampled imports and calls support only some internal links, so unsampled subsystem connections are omitted or marked unverified.
Main entry points: app.tsx Big Picture shell · download-manager.ts Download manager · index.ts Achievement views · game-files-manager.ts Game file manager
Components 18
Player interfaces
- Electron app
src/renderer/src/app.tsx - Big Picture shell
src/big-picture/src/app.tsx
Library and play
- Game catalogue
src/big-picture/src/pages/catalogue/catalogue.tsx - Game library
src/big-picture/src/pages/library/page.tsx - Game details
src/big-picture/src/components/pages/game/index.ts - Downloads UI
src/big-picture/src/components/pages/downloads/index.ts - Cloud-save UI
src/big-picture/src/components/pages/game/cloud-save-v2/index.ts
Community features
- Profiles and friends
src/renderer/src/app.tsx - Achievement views
src/big-picture/src/components/pages/game-achievements/index.ts
Desktop runtime
- Main process
src/main/main.ts - Hydra API service
src/main/services/hydra-api.ts - Download manager
src/main/services/download/download-manager.ts - Game file manager
src/main/services/game-files-manager.ts - Achievement watcher
src/main/services/achievements/achievement-watcher-manager.ts
Native capabilities
- Cloud-save engine
native/hydra-native/src/cloud_save/mod.rs - Torrent binding
native/hydra-native/src/torrent/mod.rs - Libtorrent bridge
native/torrent-bridge/bridge.cpp
Other components
- Player
Connections 18
- Player → Big Picture shell: navigates
README.md - Player → Electron app: uses
README.md - Big Picture shell → Game catalogue: routes to
src/big-picture/src/main.tsx - Big Picture shell → Game library: routes to
src/big-picture/src/main.tsx - Big Picture shell → Downloads UI: routes to
- Big Picture shell → Achievement views: routes to
- Player → Game library: manages games
README.md - Player → Game catalogue: discovers games
README.md - Player → Profiles and friends: views profile
README.md - Player → Cloud-save UI: saves progress
README.md - Player → Achievement views: unlocks
README.md - Main process → Download manager: coordinates
- Download manager → Torrent binding: requests status
src/main/services/download/download-manager.ts - Download manager → Game file manager: hands off installs
src/main/services/download/download-manager.ts - Game file manager → Cloud-save engine: uses cloud saves
src/main/services/game-files-manager.ts - Achievement watcher → Achievement views: syncs results
- Hydra API service → Profiles and friends: provides account data
- Torrent binding → Libtorrent bridge: wraps engine