Powerful Features for Modern DOS Gaming
Everything you need to organize, discover, and enjoy your DOS game collection. Built with modern web technologies for the ultimate retro gaming experience.
Automatic Game Discovery
DosVault intelligently scans your ROM directories and automatically identifies DOS games. No need to manually add each game - just point it to your collection and let it work its magic. Supports nested directories, various file formats, and handles duplicate detection.
- Recursive directory scanning
- Multiple file format support
- Duplicate game detection
- Automatic title extraction from filenames
Rich Metadata Integration
Automatically fetches comprehensive game information from IGDB (Internet Game Database). Each game gets professional metadata including descriptions, release dates, developers, publishers, genres, and high-quality artwork.
- IGDB API integration
- Cover art and screenshots
- Detailed game descriptions
- Genre and tag classification
- Developer and publisher information
Modern Web Interface
Beautiful, responsive web interface that works perfectly on desktop, tablet, and mobile devices. Browse your collection with style using grid or list views, advanced search, and smooth animations. Dark and light themes available.
- Responsive design for all devices
- Multiple view modes (grid/list)
- Advanced search and filtering
- Multiple theme options
- Smooth animations and transitions
Technical Excellence
Built with modern technologies for reliability and performance
Docker Ready
One-command deployment with Docker. Includes everything you need: Python runtime, web server, database, and dependencies. Perfect for home servers or NAS devices.
docker run -d \ --name dosvault \ -p 8080:8080 \ -v /path/to/roms:/roms \ -v dosvault-data:/app/data \ tty303/dosvault:latest
Multi-User Support
Create multiple user accounts with different permission levels. Demo users can browse, normal users can download, and super users can manage everything. JWT-based authentication.
- Demo: Browse only
- Normal: Browse + Download
- Super: Full admin access
Personal Collections
Mark games as favorites, organize by personal ratings, and create custom collections. Each user maintains their own favorites list and preferences.
Secure Downloads
Download Zip files directly through the web interface with proper authentication. Files are served with clean filenames and appropriate MIME types.
Admin Dashboard
Comprehensive admin interface for managing users, triggering scans, monitoring system health, and viewing detailed statistics about your collection.
Real-time Updates
Automatic background scanning for new games, metadata updates, and image downloading. Your library stays current without manual intervention.
Built for Performance
Optimized for large collections and smooth operation
SQLite Database
Fast, reliable SQLite database with proper indexing and relationships. Handles thousands of games efficiently with instant search and filtering. Automatic backup and migration support.
Async Processing
Built with modern async Python (FastAPI) for exceptional performance. Concurrent API requests, non-blocking I/O, and efficient resource usage. Scales well with your collection size.
Smart Image Management
Intelligent image caching and optimization. Downloads cover art and screenshots automatically, with fallback support and lazy loading for optimal performance and bandwidth usage.
Easy Configuration
Simple setup with powerful customization options
Environment Variables
Configure everything through environment variables or .env files. Perfect for Docker deployments and different environments.
XDG Compliant
Follows XDG Base Directory specification for clean configuration and data organization on Linux systems.
# Example configuration IGDB_CLIENT_ID=your_twitch_client_id IGDB_SECRET_KEY=your_twitch_secret ROM_PATH=/path/to/your/roms IMAGES_PATH=/path/to/store/images DATABASE_PATH=/path/to/database.db DOSVAULT_ADMIN_USER=admin [email protected] DOSVAULT_ADMIN_PASS=securepassword
Coming Soon
Exciting features in development
DOSBox Integration
Direct integration with DOSBox for browser-based gaming. Play your DOS games directly in the web interface.
Mobile App
Native mobile applications for iOS and Android with offline browsing and synchronization capabilities.
Social Features
Share your collection, rate games, write reviews, and connect with other retro gaming enthusiasts.
Ready to Organize Your DOS Games?
Join other retro gaming enthusiasts who trust DosVault