File Formats
Spark supports importing games from multiple archive formats.
Supported Formats
Section titled “Supported Formats”| Format | Extension | Notes |
|---|---|---|
| ZIP | .zip | Most common format. Standard compression. |
| APK | .apk | Android app packages. Spark extracts the Ren’Py game data. |
| 7-Zip | .7z | High compression ratio. Good for large games. |
| RAR | .rar | Legacy format. Fully supported. |
| TAR | .tar | Uncompressed archive format. |
| Gzip | .gz | Gzip-compressed TAR archives. |
| BZ2 | .bz2 | Bzip2-compressed TAR archives. |
| IPA | .ipa | iOS application archives. |
| APP | .app | macOS/iOS application bundles. |
File Filtering
Section titled “File Filtering”By default, Spark filters the file picker to show only supported formats. If your game file doesn’t appear when importing:
- Go to Settings > Game Library
- Disable File Extension Filter
- Try importing again
This is especially useful for APK files, which may be filtered by iOS.
Game Structure
Section titled “Game Structure”After extraction, Spark expects the standard Ren’Py directory structure:
GameName/ game/ script.rpy scripts.rpa ... renpy/ lib/Spark automatically detects the game root within the archive and extracts it correctly, even if the archive contains extra wrapper directories.
APK Import Details
Section titled “APK Import Details”When importing an Android APK:
- Spark extracts the APK (it’s a ZIP file)
- Locates the Ren’Py game data inside the
assets/directory - Determines the game name from the Android manifest,
gamename.py, or the archive filename - Copies the game files to the correct directory structure