This project is meant so that I can play interactive fiction games, but it's also good for any similar project. You can even play my LizardUp game if you download the source as a zip and open it.
- Use "Open with..." from your file app on a
.zipfile or standalone.htmlfile, and select "Offline Zip Browser". - Enter a name for it (you cannot change this yet)
- The app will attempt to guess if .zip or .html but may get it wrong so it's good to specify .zip or .html in the name too.
- The file will be saved to app's storage and now any time you open the app you will have access to this file. LocalStorage will persist across sessions. Which means most interactive fiction games with save states will work.
Note: if you use termux + curl to download files, you will have to set the
allow-external-apps property must be set to true in ~/.termux/termux.properties in termux.
Create a ozb_manifest.json file in your zipped html app next to your index.html with a variety of useful settings that will control how the app is loaded. Generally these properties will help misbehaving applications work better.
Theoretically I'd like to be able to clear cache for a site on startup, but it's not built into web views by default that I can tell.
Offset based timestamp, loaded with OffsetDateTime.parse. Values like "2025-01-30T19:00:00-05:00" will work.
Set the base url of the app to a "real" url. The app will still try to prevent access to the wider web.
Deep links to link into the app. Because the app is intentionally not communicating with servers or other apps, deep links do not work inside the app, so you can only link in from another app.
Debug builds of the app use a different deep link hostname (add .debug to the end of the hostname)
- Delete a file
- Rename a file
- Deep link to play a game app://foss.zip.offline.browser.offlinezipbrowser/play/Your_game_here.html
rename a file
delete a file
- Clear Cache options
- Have multiple instances of the app open at once