🇬🇧 English • 🇮🇷 پارسی
C++23 • Qt 6.11.2 • QML / Qt Quick • SQLite • CMake • Ninja
Windows x64 — Primary Release Platform • VoidOne Community License v1.0
Built by a gamer. Engineered like a platform. Built in the open.
Join the official VoidOne Community Discord to chat with other gamers, testers, contributors, and developers.
VoidOne is a free and source-available native PC gaming platform designed around a simple principle:
Your games should be the center of your gaming experience — not the stores distributing them.
VoidOne is being built as a native platform layer between the player, the operating system, and the gaming ecosystem. It is not a storefront and does not aim to replace the services that distribute the games you already own.
Long-term platform areas include:
- 🎮 Game libraries and discovery
- 🚀 Game execution and process management
- 🌐 Multi-provider integrations
- 🧰 Mod management
- 📊 Local analytics and diagnostics
- 🎨 Personalization
- 🧠 Optional user-controlled AI
- 🌍 Translation
- 🔌 Extensions and developer tooling
- Native first — prefer native technologies and OS capabilities when they improve performance, integration, reliability, or maintainability.
- Privacy by design — avoid unnecessary collection and transmission of player data.
- Local first — keep important player state locally controlled whenever practical.
- Lightweight by design — dependencies and background work must justify their resource cost.
- Player ownership — users control their games, configuration, data, integrations, and optional intelligence systems.
- Free by design — the platform should remain inspectable, modifiable, and extensible.
- Evidence over marketing — technical claims should be backed by implementation, tests, benchmarks, or reproducible evidence.
VoidOne is in active experimental development. The repository and CI configuration are the source of truth for implemented behavior.
| Status | Meaning |
|---|---|
| 🟢 Implemented | Present in the current repository |
| 🧪 Experimental | Implemented but under active validation |
| 🛠️ Development | Actively being developed |
| 🔭 Planned | Future direction |
| 🚀 Stable | Reserved for proven production-ready milestones |
A roadmap item is not evidence that a feature already exists.
| Technology | Role |
|---|---|
| C++23 | Native application and systems development |
| Qt 6.11.2 | Application framework |
| QML / Qt Quick | User interface |
| SQLite | Local persistence |
| CMake 3.25+ | Build system |
| Ninja | Build execution |
| CTest | Automated testing |
| GitHub Actions | CI/CD |
| MSVC x64 | Primary Windows toolchain |
| NSIS | Windows installer |
┌──────────────────────────────────────────────┐
│ Qt / QML UI │
└──────────────────────┬───────────────────────┘
▼
┌──────────────────────────────────────────────┐
│ Application entry │
│ src/main.cpp │
└──────────────────────┬───────────────────────┘
▼
┌──────────────────────────────────────────────┐
│ Native C++ core │
│ src/core/ │
└───────────────┬───────────────────┬──────────┘
▼ ▼
┌──────────────┐ ┌──────────────┐
│ SQLite │ │ OS / Qt │
│ local state │ │ integrations │
└──────────────┘ └──────────────┘
See docs/architecture/overview.md for repository boundaries and architectural rules.
- C++23 foundation
- Qt / QML application foundation
- CMake build system
- SQLite persistence
- Native application architecture
- CI/CD and Windows packaging
- Automated testing and diagnostics
- Game discovery
- Installation detection
- Library persistence and indexing
- Game identity and metadata normalization
- Provider abstraction
- Advanced library UI
- Search and filtering
- Categorization
- Artwork and metadata
- Personalization
A planned execution layer for launch arguments, per-game profiles, process lifecycle tracking, runtime state, and background-process policies.
VoidOne does not intend to bypass DRM, licensing requirements, or required platform authentication.
A planned optional intelligence layer supporting user-selected local and cloud models for assistance, diagnostics, configuration, translation, and hardware-aware workflows.
AI is intended to remain optional and replaceable rather than becoming a mandatory core dependency.
VoidOne also contains experimental AI-assisted development infrastructure for CI diagnosis and repair candidates. This is separate from player-facing VoidOne Intelligence.
AI-generated changes are treated as untrusted output and must pass deterministic validation and human review.
See docs/engineering/ai-repair.md.
Windows is currently the primary release platform. The CI pipeline performs:
- Source checkout and toolchain setup
- Git-tag/dev version resolution
- CMake configuration and Release build
- Automated tests
- Qt runtime deployment
- Installer input validation
- NSIS installer generation
- Optional Authenticode signing
- Portable ZIP generation
- Artifact upload
- GitHub Release publication for tags
- CI notifications
Release artifacts:
VoidOne-Setup-x64.exeVoidOne-Portable-x64.zip
See docs/release/windows.md for the release checklist.
The supported path is CMake presets.
git clone https://github.com/VoidOne-App/VoidOne.git
cd VoidOne
cmake --preset dev
cmake --build --preset dev
ctest --preset devFor a local optimized build:
cmake --preset release
cmake --build --preset release
ctest --preset releaseFor the strict Windows CI configuration:
cmake --preset ci-windows
cmake --build --preset ci-windows
ctest --preset ci-windowsSee docs/build.md for requirements, Qt setup, packaging, and troubleshooting.
- Build Guide
- Architecture Overview
- Windows Release Engineering
- AI-Assisted Code Repair
- Troubleshooting
- Contributing
- Security
Contributions are welcome across C++, Qt/QML, UI/UX, testing, documentation, performance, build systems, CI/CD, security, developer tooling, and platform support.
Keep changes focused and reviewable. For substantial changes, document what changed, why it changed, how it was tested, and any compatibility, performance, or security considerations.
Security is an engineering concern throughout the project. Report security issues according to SECURITY.md rather than publishing sensitive details in a public issue.
VoidOne is distributed under the VoidOne Community License v1.0. See LICENSE.
Built by a gamer. Engineered like a platform. Built in the open.
♾️ Free & Source-Available · 🚫 No Ads · 🔒 Privacy First · 🧠 Optional AI · 💬 Community Discord
⭐ Star VoidOne · 📦 Releases · 🐛 Issues · 💬 Discord · 🤝 Contributing