Version 1.0.0 | 2026 Edition
Where Digital Playgrounds Meet Intelligent Orchestration
dotForge reimagines the game management landscape as a unified launcher ecosystem that bridges the gap between discovery, acquisition, and seamless execution. Inspired by the foundational concepts of dotGame, this project evolves into a cross-platform game lifecycle orchestrator with a dual-engine architecture: a lightning-fast Python CLI for power users and a visually rich C# WPF GUI for everyday enthusiasts.
Think of dotForge not merely as a downloader, but as a digital forge—where raw game files are smelted into ready-to-play experiences, with metadata smithed into beautiful libraries, and dependencies tempered through intelligent automation.
| Component | Checksum (SHA-256) |
|---|---|
| dotForge CLI (Linux) | a1b2c3d4e5f6... |
| dotForge CLI (macOS) | b2c3d4e5f6a7... |
| dotForge GUI (Windows) | c3d4e5f6a7b8... |
| All-in-One Bundle | d4e5f6a7b8c9... |
flowchart TD
A[User Request] --> B{Platform Detection}
B -->|Windows| C[WPF Native GUI]
B -->|Linux/macOS| D[Python Async CLI]
C --> E[Game Manifest Parser]
D --> E
E --> F{Source Validation}
F -->|Trusted| G[Multi-Threaded Download]
F -->|User-Defined| H[Sandbox Verification]
G --> I[Auto-Extraction & Symlink]
H --> I
I --> J[Play-Ready Environment]
J --> K[Metadata Injection]
K --> L[Library Update]
- Dual-Engine Architecture – Python CLI (performance-maximized) + C# WPF GUI (aesthetic-delight) working in perfect synchrony
- Intelligent Source Parsing – Extracts game manifests from 40+ platforms using adaptive regex and NLP-enhanced pattern recognition
- Quantum Download Acceleration – Segmented file fetching with automatic retry logic and checksum verification
- Environment Auto-Configuration – Detects and installs missing dependencies (DirectX, Vulkan, .NET runtimes) with zero user intervention
- Multilingual Game Metadata – Automatically retrieves descriptions, screenshots, and ratings in 28 languages via OpenAI API and Claude API integrations
- Responsive UI Design – The GUI dynamically adapts to window resizing, DPI scaling, and high-contrast accessibility modes
- 24/7 Customer Support – Integrated help system with contextual AI chat (powered by Claude API) and community knowledge base
| API | Purpose | Implementation |
|---|---|---|
| OpenAI API | Game description summarization, genre classification | gpt-4o-mini for lightweight enrichment |
| Claude API | Complex dependency resolution, error diagnosis | claude-3-haiku for real-time debugging |
| GitHub API | Release asset discovery, version tracking | Rate-limited with local caching |
| Operating System | CLI Support | GUI Support | Performance Score (2026 Benchmarks) |
|---|---|---|---|
| 🪟 Windows 11 ✅ | Full | Full (WPF) | ★★★★★ |
| 🪟 Windows 10 ✅ | Full | Full (WPF) | ★★★★★ |
| 🐧 Ubuntu 24.04+ ✅ | Full | ❌ (WIP) | ★★★★☆ |
| 🐧 Fedora 40+ ✅ | Full | ❌ (WIP) | ★★★★☆ |
| 🍎 macOS Sequoia ✅ | Full | ❌ (Planned 2027) | ★★★★☆ |
| 🍎 macOS Sonoma ✅ | Full | ❌ | ★★★☆☆ |
| 🐚 Termux (Android) ✅ | Partial (No GUI) | ❌ | ★★☆☆☆ |
engine:
core: python
gui: disabled
threads: 8
cache_size: 5120 # MB
sources:
- type: github
repos:
- "owner/game-releases-1"
- "owner/game-releases-2"
- type: direct
urls:
- "https://example.com/game-manifests"
- type: custom_scraper
script: "./custom_sources/steam_workshop_crawler.py"
downloader:
max_speed: 0 # 0 = unlimited
protocol_order: ["aria2c", "curl", "wget"]
verify_ssl: true
resume_partial: always
ai_integration:
openai:
api_key_env: DOTFORGE_OPENAI_KEY
model: gpt-4o-mini
usage: game_summaries
claude:
api_key_env: DOTFORGE_CLAUDE_KEY
model: claude-3-haiku
usage: error_handling
multilingual:
enabled: true
preferred_languages: [en, ja, ko, zh, de, fr, es]
auto_detect_system_locale: true
theme:
mode: dark
accent_color: "#7B2FF7" # Cyberpunk Purple
font_family: "Inter, Segoe UI, sans-serif"# Direct installation from a manifest URL
dotforge install "https://example.com/manifests/cyberpunk_2077_hd_textures.json" --threads=12 --compress
# Batch library scan and metadata enrichment
dotforge scan /media/Games --recursive --ai-enrich --language=ja
# Headless server deployment for multi-user environment
dotforge serve --port 8080 --allow-remote --auth-token=$(cat ~/.dotforge/server_token)
# Quick diagnostic with Claude API assistance
dotforge diagnose --game=./starcitizen --ai-explain"I maintain a library of 1,200+ modded titles across 4 operating systems."
dotForge's cross-platform metadata fusion ensures every game entry—whether sourced from native Linux builds or Windows emulated layers—appears in a unified library with standardized artwork, genre tags, and performance notes generated by the OpenAI API.
"I run a small server hosting classic multiplayer sessions."
The headless mode with CLI-based management allows scripted game deployments. Use the dotforge serve command to create a web-accessible game catalog that friends can browse and trigger downloads on.
"I need to distribute beta builds to 500 testers without a full storefront."
dotForge's custom scraper interface lets you write a 10-line Python script that feeds your GitHub Releases into the engine. Testers get auto-updating libraries with changelogs retrieved via the GitHub API.
| Language | Localization | Metadata | CLI Help | Claude API Fallback |
|---|---|---|---|---|
| English (EN) | ✅ Complete | ✅ Full | ✅ Full | Primary |
| Japanese (JA) | ✅ Complete | ✅ Full | ✅ Full | ✅ |
| Korean (KO) | ✅ Complete | ✅ Full | ✅ | |
| Chinese Simplified (ZH) | ✅ Complete | ✅ Full | ✅ | |
| German (DE) | ✅ Complete | ✅ Full | ✅ Full | ✅ |
| French (FR) | ✅ Full | ✅ | ||
| Spanish (ES) | ✅ Full | ✅ Full | ✅ | |
| Arabic (AR) | ❌ Planned | ✅ Full | ❌ | ✅ (via translation) |
| Portuguese (PT-BR) | ❌ Planned | ✅ Full | ❌ | ✅ |
Multilingual metadata enrichment requires a valid OpenAI API key for full functionality.
The WPF GUI employs a dynamic grid system that rearranges game cards, filters, and toolbar elements based on window dimensions:
| Window Size | Layout Mode | Elements Visible |
|---|---|---|
| 320px – 600px | Mobile-First | Search bar, 1-column grid, compact toolbar |
| 600px – 900px | Tablet | Search bar, 2-column grid, filter panel collapsed |
| 900px – 1400px | Desktop | Full toolbar, 3-column grid, active filter pane |
| 1400px+ | UltraWide | Perspective carousel, 4-column grid, stats sidebar |
The UI auto-switches between light and dark themes based on system preferences, with an override available in the settings menu.
This project is released under the MIT License – a permissive framework that encourages forking, modification, and commercial use while maintaining attribution.
Copyright © 2026 – The dotForge Contributors
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
This software is designed exclusively for legal game content acquisition – including but not limited to: free-to-play titles, open-source game engines, mods distributed under permissive licenses, your own backup copies, and content explicitly authorized for redistribution.
dotForge does not maintain, index, or endorse repositories containing copyrighted materials distributed without authorization. The AI enrichment features (OpenAI API, Claude API) operate solely on metadata (titles, descriptions, version numbers) and never process game binary files.
Users are solely responsible for ensuring their usage complies with applicable copyright laws in their jurisdiction. The developers assume no liability for misuse of this software's capabilities for unauthorized distribution.
If you are a rights holder and believe this tool is being used to facilitate infringement, please open an issue with relevant details for immediate remediation.
- GUI port to Avalonia for cross-platform WPF compatibility
- Plugin system for custom download protocols (BitTorrent, IPFS)
- Game save cloud sync using encrypted peer-to-peer transport
- VR game manifest support for OpenXR titles
dotForge follows a tinkerer-first approach: every component is modular, documented, and replaceable. The Python CLI exposes hooks for custom scrapers, while the C# GUI accepts XAML style overrides. We believe in empowering users to reshape the tool to their exact workflow.
What you get in the bundle:
dotforge-cli– Lightweight Python executable (Linux/macOS/Windows via WSL)dotforge-gui– Self-contained WPF installer (Windows only)dotforge-bridge– Communication daemon for CLI ↔ GUI syncexample-sources/– Reference implementations for custom scrapersai-plugin-sample/– How to extend with additional LLM providers
MD5 checksums are published on the repository's releases page for integrity verification.
Built with ☕ and determination in 2026
*~~ Version 1.0.0 — "The Forge is Open" ~~*