R
Ren'Py Pocket
Help Center
Support Download

FAQ

Quick answers to common questions.

đŸ“Ĩ Importing Games

How do I add a game to Ren'Py Pocket?

Two methods:

Method A — Import from Files

  1. Download the Windows/PC ZIP in Safari
  2. Open Ren'Py Pocket → tap +
  3. Select Add from Files, choose the ZIP

Method B — WiFi Transfer (large files)

  1. Same WiFi network on both devices
  2. Tap + → Upload from PC
  3. Open the shown address on PC, drag the ZIP
Ren'Py Pocket vs Ren'Py 7 Pocket — which one?

Start with Ren'Py Pocket (v8)

Works for the vast majority of games, including most Ren'Py 7 titles.

Use Ren'Py 7 Pocket if:

  • The app warns "Ren'Py 7 game detected"
  • You're playing Doki Doki Literature Club (original)
  • Other older games that fail on v8
Ren'Py Pocket (v8) Ren'Py 7 Pocket
ZIP import failed — how to fix?

Some Windows-generated ZIPs are incompatible with iOS.

Quick fix:

  1. Open the ZIP in the iOS Files app to extract it
  2. Long-press the extracted folder → Compress
  3. Import this new ZIP — it should work

🎮 Game Compatibility

Which games work with Ren'Py Pocket?

Most Ren'Py 8.x and Ren'Py 7.x games work. Some titles use Python extensions or custom builds that may not run on iOS.

Check the Compatibility Directory → for community data on specific games.

My game crashes on startup — what to do?

Try in order:

  1. Confirm you imported the Windows/PC version
  2. Try the other app (v8 ↔ v7 Pocket)
  3. Roll back any mods: Mod Management → Rollback
  4. Delete and re-import the game
  5. Check the Compatibility Directory

Still stuck? Join Discord and share the error.

🌐 Translation

How does real-time translation work?

Ren'Py Pocket hooks into the game's dialogue stream and passes each line to Apple's on-device Translation framework. The result appears as a bubble at the bottom of the screen — no internet required.

  • Tap the translation button on the right side panel
  • Adjust text size with the Aa button
What iOS version is required for translation?

⚠ī¸ iOS 26 or later required

Translation uses Apple's Translation framework, available only from iOS 26 onward.

After updating: Settings → General → Language & Region → Translation Languages → download your target language.

Translation is on but nothing appears
  1. Confirm iOS 26+ is installed
  2. Tap the translation button on the right panel — confirm it's toggled on
  3. Download the source language in Settings → Translation
  4. Set the source language manually in the Aa panel if auto-detect is wrong
  5. Translation only fires on dialogue lines, not menus or choices

💾 Save Management

How do I back up my saves?

Select a game → tap Save Management.

đŸ“Ļ Backup All

Export as ZIP via Share Sheet

đŸ“Ĩ Import

Restore from a ZIP backup

📤 Export

Export a single save file

🗑ī¸ Delete

Remove all saves (irreversible)

How do I transfer saves from PC to iPhone?
  1. On PC, find game/saves/ in the game folder
  2. Copy .save files to iCloud Drive or Dropbox
  3. Ren'Py Pocket → game → Save Management → Import Save Files
Save won't load — security token error

PC saves sometimes include tokens that don't match on a different device.

Use the Ren'Py Save Repack tool:

saveeditor.online/renpy-repack

Upload the save + security_keys.txt. Download the fixed file, then import it.

🕹ī¸ Controls & Mods

What do the floating buttons do?
☰ Menu

Open game menu (ESC)

⏭ Skip

Hold to fast-forward

↩ Rollback

Go back one line

Translate

Toggle translation (iOS 26+)

Aa Settings

Font size + translation bubble size

Drag by ☰ to reposition. Tap 👁 to hide/show the panel.

How do I install a mod?
  1. Select game → Mod Management
  2. Tap Import Mod, select the file (.rpy, .rpyc, .py, or .zip)
  3. Relaunch the game to apply

Mod broke the game?

Mod Management → Rollback Mod removes the last mod safely.

Can't find your answer?

Ask on Discord