cheezwiz7899 12a7a81a8f ci(linux): migrate PR builds to build-citron-linux.sh, remove Arch container, and clean up obsolete scripts
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
2026-07-02 10:22:10 +10:00

🍋 Citron Neo PR Builds

Build Citron Neo (Android) Build Citron Neo (Windows) Build Citron Neo (Linux) Build Citron Neo (macOS)


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 (PendingBuilding...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:


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
S
Description
No description provided
Readme GPL-3.0 425 KiB
Languages
Shell 100%