build-linux.yml: - Replace per-workflow build/package shell scripts (build-citron.sh, get-dependencies.sh, package-citron.sh) with a unified call to build-citron-linux.sh from the emulator repo, which handles dependency setup, CPM build, and AppImage/tar.zst packaging in one script - Remove Arch Linux container (ghcr.io/pkgforge-dev/archlinux:latest) from the linux build job; the job now runs directly on the Ubuntu GitHub-hosted runner, eliminating the nested container layer - Remove the 'Install Git' step (pacman -Syu git) that was only needed inside the Arch container - Remove the 'Install Packaging Dependencies' step (pacman gamemode) that was only needed inside the Arch container; gamemode handling is now delegated to build-citron-linux.sh Deleted files: - build-citron.sh: Arch-based build script replaced by build-citron-linux.sh - get-dependencies.sh: Arch pacman dependency installer, superseded - package-citron.sh: Arch-based AppImage/tar.zst packager, superseded - PKGBUILD: unused Arch Linux package build descriptor README.md: - Rewrite to reflect this repo's purpose as a PR test-artifact builder, not a nightly/stable release repo; redirect users to citron-neo/CI for releases - Describe the per-platform workflow_dispatch model: takes branch, PR number, and head repo as inputs; posts/updates a results comment on the PR with per-platform status and nightly.link download links - Document build-deduplication: skips re-building a commit already successfully built for that platform - Update title and badge references from 'Citron' to 'Citron Neo' - Mention tar.zst portable archive produced alongside the AppImage - Update AppImage section with uruntime fuse3/no-fuse compatibility notes - Replace bullet lists with dash lists; remove star history block, raison d'etre image, and Pkgforge attribution section
🍋 Citron Neo PR Builds
This repository builds on-demand test artifacts for open pull requests against the Citron Neo emulator — it does not produce the project's Nightly or Stable releases. For those, see citron-neo/CI.
Each platform workflow (Windows, Linux, Android, macOS) is triggered manually via workflow_dispatch, taking a target branch, a PR number, and a head repo as input. This lets a reviewer or contributor build a specific PR's branch — from any fork — without waiting for it to merge.
Once a build is requested, this repository:
- Builds the requested commit for the chosen platform.
- Posts (or updates) a single results comment on the corresponding pull request in citron-neo/emulator, with a table tracking each platform's status (
Pending→Building...→Success/Failed) and a direct download link to the artifact, powered by nightly.link. - Skips rebuilding a commit that's already been built successfully for that platform, to avoid duplicate work on repeated dispatches.
Would you like to submit a compatibility report for the emulator? You can do so here:
Direct links for other information you may need can also be found below:
- Latest Commits Can Be Found Here
- citron-neo/CI — Nightly & Stable Releases
- citron-neo/emulator — Open Pull Requests
READ THIS IF YOU HAVE ISSUES
If you are on wayland (specially GNOME wayland) and get freezes or crashes, you are likely affected by this issue that affects all Qt6 apps: citron-neo/CI#50
To fix it simply set the env variable QT_QPA_PLATFORM=xcb
Also, are you looking for AppImages of other emulators? Check: AnyLinux-AppImages
Linux AppImage builds are made using sharun, which makes it extremely easy to turn any binary into a portable package without using containers or similar tricks.
These AppImages bundle everything and should work on any Linux distro, even on musl based ones.
A tar.zst portable archive of the same build is also produced alongside the AppImage, for users who prefer an install-free tarball over the AppImage format.
These AppImages work without fuse2 as they can use fuse3 instead; they can also work without fuse at all thanks to the uruntime.
Thank-you for being a part of & using Citron Neo, we value all members of the community whom help shape the emulator into what it is today!
- The Citron Neo Team