Skip to content

File Formats

Spark supports importing games from multiple archive formats.

FormatExtensionNotes
ZIP.zipMost common format. Standard compression.
APK.apkAndroid app packages. Spark extracts the Ren’Py game data.
7-Zip.7zHigh compression ratio. Good for large games.
RAR.rarLegacy format. Fully supported.
TAR.tarUncompressed archive format.
Gzip.gzGzip-compressed TAR archives.
BZ2.bz2Bzip2-compressed TAR archives.
IPA.ipaiOS application archives.
APP.appmacOS/iOS application bundles.

By default, Spark filters the file picker to show only supported formats. If your game file doesn’t appear when importing:

  1. Go to Settings > Game Library
  2. Disable File Extension Filter
  3. Try importing again

This is especially useful for APK files, which may be filtered by iOS.

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.

When importing an Android APK:

  1. Spark extracts the APK (it’s a ZIP file)
  2. Locates the Ren’Py game data inside the assets/ directory
  3. Determines the game name from the Android manifest, gamename.py, or the archive filename
  4. Copies the game files to the correct directory structure