-
Notifications
You must be signed in to change notification settings - Fork 2
Extraction System
Yamata Launcher includes a built-in extraction system designed to automatically decompress downloaded game files. The extraction engine uses 7-Zip across all supported platforms, including:
- Android
- Windows
- macOS
- Linux
- SteamOS
- Batocera
This ensures consistent behavior and broad support for compressed formats.
Most game downloads provided by external sources are distributed as compressed archives.
Common reasons include:
- Reduced file size
- Easier distribution
- Multi-file packaging
- Preservation of folder structure
Because of this, automatic extraction is enabled by default to streamline the workflow after a download completes.
The 7-Zip engine supports multiple compression formats, including:
- 7z
- ZIP
- RAR
- TAR
- GZ
- BZ2
- XZ
- ISO (extraction support when applicable)
Additional formats supported by 7-Zip may also work depending on the archive structure.
After a download finishes:
- The file is added to the extraction queue
- The archive is extracted to the configured destination
This behavior allows users to immediately use the game without manual intervention.
Automatic extraction can be controlled in two ways.
You can enable or disable automatic extraction from:
Settings → Extract roms after download
This controls the default behavior for all future downloads.
When starting a download:
- The download dialog includes an Extract contents after download option
- Unchecking this option will skip extraction for that specific download
This is useful when:
- You want to keep the archive
- You plan to extract manually
- The file should remain compressed
To maintain system stability and performance, Yamata processes extractions using a controlled queue.
- Maximum concurrent extractions: 4
Platforms:
- Windows
- macOS
- Linux
- SteamOS
- Batocera
- Maximum concurrent extractions: 2
This lower limit helps prevent excessive CPU and memory usage on mobile devices.
If a download source provides archive passwords:
- Yamata will automatically try the passwords during extraction
- No manual input is required
Passwords are taken from the Download Source configuration.