Repository navigation
v0.1.0
First public release.
Added
- Chi-based HTTP router with setup-mode middleware.
- VRHub-compatible public API:
GET /meta.7z(password-protected AES-256 7z archive)GET /{hash}/andGET /{hash}/{packageName}/HTML directory listingsGET /{hash}/{packageName}/{filename}file download with Range supportGET /config.jsonclient configuration bootstrap
- Admin REST API (X-API-Key, SHA-256 hashed):
- Games CRUD, scan, revalidate, rescan, corruption status
- Admin settings, change password, API key reveal / regenerate
- Backup / restore endpoints
- Update status, apply, reset (GitHub releases)
- Monitoring SSE stream, stats, network status, API documentation
- Admin Web UI (HTML + session cookies):
- Dashboard, configuration widget, games, backup, monitoring
- Login page with secure cookie hardening for LAN access
- Setup wizard endpoints (credentials, archive password, game folders,
scan review, launch). - Background workers:
- File-system watcher with auto-rescan
- Corruption detection and orphan OBB handling
- MetaMetadata fetcher with startup + scheduled refresh (conditional
Last-Modified/ETagrequests) - Auto backup on updates, manual export, restore
- GitHub releases checker with self-apply
- Real-time monitoring and usage statistics
- Network status indicator
- SQLite data layer (
modernc.org/sqlite, pure Go, schema created in code). - TOML configuration via
BurntSushi/toml, with first-run detection that
triggers the setup wizard whenconfig.tomlis missing. - Default data dir: Windows
%APPDATA%/vrhub-server, Unix$HOME/.vrhub-server. - Default listen:
127.0.0.1:39457. - Files served from the scanner-discovered
apk_path, with a legacy
{data-dir}/games/{hash}/{packageName}/fallback and a startup backfill
for older installs. - Cross-platform single static binary for Windows (amd64, arm64),
Linux (amd64, arm64) and macOS (amd64, arm64). - Docker image and
docker-compose.ymlunderdocker/. README.md,docs/set,LICENSE(MIT),CONTRIBUTING.md,
SECURITY.md.
Notes
- Windows binaries ship with a sidecar
vrhub-server.exe.manifest
requestingrequireAdministratorso the firewall helper
(internal/firewall) can callnetsh advfirewallwithout manual
firewall clicks. The helper is a runtime no-op on Linux and macOS. - The embedded 7z helper binaries are bundled for every supported target.