Downloads Overview
The download system allows Yamata Launcher to retrieve game files from configured Download Sources. Once download sources are properly configured and available, the application will automatically detect matches between catalog games and available downloads. The entire process is automatic and designed to provide a unified experience regardless of the source provider or download protocol.
Downloads are enabled when the following conditions are met:
- One or more Download Sources are added to the application.
- The source contains entries that match:
- The game title (normalized)
- The console slug
- A matching entry is found for a game present in the catalog.
When a match is detected:
- The game card will display an active Download button
- This indicates that at least one download option is available for that game
If no match is found, the download button will not appear.
When the Download button is clicked:
- A dialog opens showing all available download options for that game.
- Each entry may include:
- File title
- File size
- Source name
- Upload date (if available)
- If multiple Download Sources provide files for the same game, all options are displayed together.
This allows users to choose:
- Different file versions
- Different providers
- Different protocols (HTTP, Torrent, etc.)
Yamata Launcher uses aria2c as its download engine on all supported platforms.
This applies to:
- Android
- Windows
- macOS
- Linux
- SteamOS
- Batocera
Using aria2c provides a consistent and high-performance download system across environments.
The aria2-based system enables:
- Multi-connection downloads for faster speeds
- Parallel downloads (multiple files at the same time)
- Resume support for interrupted downloads
- Multi-protocol support
Supported protocols include:
- HTTP / HTTPS
- BitTorrent (torrent files and magnet links)
- Multiple mirrors for the same file
If a download source provides multiple URIs, aria2 may use them as fallback or parallel sources.
When a download entry contains a magnet link or torrent source:
- The download is handled directly by aria2
- No external torrent client is required
- Progress and status are managed inside Yamata
This allows seamless integration between direct downloads and peer-to-peer sources.