renpy/doc/cookbook/Single-Directory Mac Application
From Ren'Py Visual Novel Engine
Single-Directory Mac Application
| This documentation is out of date. Ren'Py 6.9.3 now packages Mac apps as bundles which appear as one double-clickable Mac app, not alongside other directories — unless you choose a Universal distribution. |
The default Ren'Py distribution builder builds Mac applications like they were Windows or Linux applications, with the base directory files at the same level as the Mac Application. A more traditional Mac application would hide the base directory inside the .app directory. We support that, here's how:
- Be on a Mac, or at least a Linux box. The Windows filesystem doesn't support the executable bit, and so if you unpack and repack a Mac zip on Windows, you'll lose information and it probably won't work.
- Extract the Mac distribution of your game. We'll assume you built the game "mygame", and packed it into a zip of the name "mygame-1.0-mac.zip". So when you extract it, things will go into "mygame-1.0/".
- Create mygame-1.0/mygame.app/Contents/Resources/autorun . You'll probably have to go and right or control-click on mygame.app in order to browse into it. (If control-clicking does not work, removing the ".app" from mygame.app may allow you to open it like a directory.)
- Copy everything from mygame-1.0/ into mygame-1.0/mygame.app/Contents/Resources/autorun . Obviously, you'll want to leave out mygame.app, and also any README files you want to keep.
That's it. You now have a working single-directory Mac application, which you can then zip up, put into a dmg, or whatever.
You might also want to change the icon, by replacing mygame-1.0/mygame.app/Contents/Resources/launcher.icns with your own icns file.
