Skip to content

Launcher and Updates

mogeldev edited this page Nov 9, 2026 · 4 revisions

Launcher and updates

Touch a row or use controller/keyboard focus. Long pages scroll; Back returns to the previous page. Import choices disappear once a game is installed. Opening the app icon while the game is running returns to the game.

Menu

Entry Action
Play Start the installed game
Import game file / Extracted folder Select input using Android's picker
Compile / resume Continue pending compilation with verified work
Vulkan driver Manufacturer / Turnip; eligible Adreno devices or recovery only
Check for updates Check GitHub, including prereleases; open the newer release page
Requirements / Licenses Setup guidance / full packaged notices
Share device report Preview and share device/compatibility details
Export error logs (ZIP) Save diagnostic files to a location you choose

Export error logs

Available from 0.3.0-testing.2:

  1. Choose Export error logs (ZIP), read the warning, then Save ZIP.
  2. Choose a destination in Android's file picker.
  3. Review the ZIP before attaching it to a bug report.
Included when available Not included
Saved game logs (scda.log / numbered runs) Game assets, XBE, compiled game code
Last setup/import/compile error Saves
Last Vulkan diagnostic report Full Android logcat buffer
README Automatic upload

Logs can contain file paths. Older runs and diagnostics may describe earlier app versions or settings. No setup-error file means none was saved; it does not prove setup never failed. An abrupt log ending alone does not prove a crash.

On export failure, the destination may contain an incomplete ZIP: delete that file and retry. Do not delete app data.

Share device report

Choose a result, optionally add notes, then Share or Review on GitHub. You review and submit the report yourself; nothing is sent automatically.

  • Includes: app version, device model, Android/ABI, driver selection, Turnip eligibility and last recorded GPU/Vulkan driver.
  • Excludes: device IDs, accounts, file paths, raw logs, saves and game files.
  • After installing/updating, GPU details say Not recorded until a new game start records them.
  • GitHub issues are public and linked to your account. Keep personal information out of notes.

Use the device report for compatibility details; use the ZIP export for error investigation.

Update safely

The launcher checks GitHub quietly at each fresh start and notifies only when a newer release exists. Offline/up-to-date checks stay silent; the manual button shows the result. Nothing is downloaded or installed automatically.

  1. Download the APK from the offered page or Releases.
  2. Install over the existing app, signed with the same certificate.
  3. Choose Play. Ordinary updates need no reimport/recompile.

Do not uninstall or clear app data to bypass an error: that deletes saves/settings. Published certificate SHA-256:

1be501578a55867ac0b1fc488d516d33c07d14cfab2b43a69b8ace81e9cb8233

Licenses and source

Each release includes corresponding source and checksums; the launcher displays packaged notices. Turnip provenance is verified against upstream metadata/revision, not an independent byte-for-byte rebuild. Source record.

Clone this wiki locally