Skip to content

Add AppImage build instructions#254

Open
goldug wants to merge 3 commits into
Gemba:masterfrom
goldug:master
Open

Add AppImage build instructions#254
goldug wants to merge 3 commits into
Gemba:masterfrom
goldug:master

Conversation

@goldug

@goldug goldug commented Jun 5, 2026

Copy link
Copy Markdown

Summary

Adds APPIMAGE.md, a practical guide for building a portable AppImage version of Skyscraper.

The document is based on a successful real-world build and test process performed on Debian Trixie/Sid (WSL2) and verified to work on Batocera v43.

Why

While Skyscraper builds easily from source, creating a fully self-contained AppImage required a number of additional steps that were not immediately obvious:

  • Using AppImage-friendly installation paths (PREFIX=/usr, SYSCONFDIR=/usr/etc)
  • Ensuring required runtime libraries are bundled for compatibility with older target systems
  • Handling linuxdeploy detection issues
  • Verifying that platform configuration files such as peas.json are correctly included

The goal of this document is to save other users from repeating the same troubleshooting process.

Notes

This is not intended to be the definitive or only way to build an AppImage. It simply documents one workflow that was successfully tested and produced a working AppImage.

Tested on:

  • Debian Trixie/Sid (WSL2)
  • Qt 6.10.2
  • linuxdeploy continuous build
  • Batocera v43 (x86_64)

goldug added 3 commits June 5, 2026 20:22
Instructions on how to create an appimage of Skyscraper.
Made some corrections and prettied it up some.
@goldug

goldug commented Jun 5, 2026

Copy link
Copy Markdown
Author

Just to add: the reason I made it at all is because it cannot be built on Batocera. This way you can use it there too.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant