PegasusG by ROC

PegasusG by ROC is a downstream Linux SDL2 frontend for GBA-focused Pegasus content on H700 handhelds. It is a community port and adaptation project; it is not an official Pegasus Frontend release.

The repository is intended to be cloned as a complete development project. Machine-specific code is kept under H700/, application code under src/, and portable tests under tests/.

Attribution

• The original Pegasus Frontend project and its contributors retain their copyright and licensing rights. See LICENSE.md, NOTICE.md, and NOTICE.zh-CN.md.
• The H700 SDL2 port, PegasusG by ROC integration, launcher scripts, and project-specific UI work are Copyright (c) 2026 Blood_roc.
• Contact: QQ 825826146.

Downstream ports must keep these notices, the in-app 天马G ROC移植 attribution, and the relevant third-party notices. Mark significant changes clearly and do not present a port as an official Pegasus release.

Repository Layout

src/                       Portable frontend implementation
tests/                     Desktop and shell regression tests
assets/                    Small runtime assets and 11 built-in music tracks
H700/                      Cross-build, launcher, filter, input and packaging tools
docs/                      Architecture, baseline and migration documentation
third_party/licenses/      Licenses copied for bundled core binaries

ROMs, commercial game media, the full music collection, device dumps and machine-private logs are intentionally not part of this repository.

Desktop Build

On a Linux/WSL environment with SDL2, SDL2_image, SDL2_ttf and ALSA development packages:

make
make test

The Windows helper run-dev.ps1 starts build/pegasusg_by_roc.exe after the desktop build. A system font is used by default; a font can be supplied at build/package time with PEGASUSG_FONT_SOURCE or -FontSource when its license permits redistribution.

H700 Cross Build

Use the existing build entry point with either the firmware sysroot or the PortMaster Docker image. Both builders use the same source list, staging, resource validation and packaging steps.

With an AArch64 compiler and target firmware sysroot (the default), including SDL2 >= 2.0.18, SDL2_image, SDL2_ttf and ALSA headers and libraries:

.\H700\build_app.ps1 -Version 1.08 -Output Stage -Sysroot 'D:\path\to\h700\sysroot'

For Docker on Windows, install WSL 2 and Docker Desktop with WSL integration enabled for the distribution used below. Docker must be able to run linux/arm64 containers. The WSL distribution needs Bash and Python 3 for packaging. No firmware sysroot or host SDL development packages are needed for this build.

.\H700\build_app.ps1 -Builder Docker -Distro Ubuntu-24.04 -Version 1.08 -Output Zip

On Linux or directly inside WSL:

PEGASUSG_BUILDER=Docker PEGASUSG_OUTPUT=Zip bash H700/build_app.sh

The builder pulls ghcr.io/monkeyx-net/portmaster-build-templates/portmaster-builder:aarch64-latest if absent, then compiles offline in the container. Set PEGASUSG_BUILDER_IMAGE to use a locally available version or digest. Docker Desktop includes ARM emulation; a standalone Docker Engine on an x86 host needs an ARM64 binfmt/QEMU handler. The application still uses the firmware libraries on the device.

-Output Stage produces H700/dist_app/release_stage/; -Output Zip also creates the full package in H700/Downloads/. To package the existing H700 binary again without compiling, use the same entry point:

.\H700\build_app.ps1 -SkipBuild -Output Zip -Version 1.08 -Distro Ubuntu-24.04

make packzip VERSION=1.08

The default package includes the 11 tracks in assets/music/builtin/. To stage a separately obtained complete music collection, pass -MusicSource with the directory containing the MP3 files. build_split_packages.ps1 -MainOnly creates only the small main package; a complete 324-track supplement can be created with -FullMusicSource.

.\H700\build_split_packages.ps1 -Version 1.08 -MainOnly
.\H700\build_split_packages.ps1 -Version 1.08 `
  -FullMusicSource 'D:\path\to\complete\Music'

The resulting archives are written to H700/Downloads/, which is ignored by Git except for formal versioned frontend packages and the directory README. Each formal package is also published through the matching GitHub Release. See docs/PORTING_GUIDE.md before adapting the launcher to another machine.

Controls and Search

• B / Menu opens Settings, Help and Exit over the dimmed main screen. Exit asks whether to return to the system, restart, shut down or cancel.
• Y opens quick settings and a search field; R2 opens search directly.
• X toggles the full-screen grid and stops video preview in this mode.
• L2 cycles theme colours, including while quick settings are open.
• Descriptions scroll automatically. A compact control overlay stays inside the grid area; favourites have a heart in the upper-right cover corner and appear first in each category in the order they were added.
• Search accepts Chinese, full pinyin and initials, with an offline controller keyboard. L1 changes case, X deletes (hold to repeat), B cancels, Y inserts a space, Select clears and Start applies the query.
• Settings includes Default Standby (lid-open wake, the default) and Super Standby (power-button wake). Update the launcher with the executable.
• Frontend Volume controls the frontend. System Volume defaults to Sync, inheriting the frontend volume at game startup, or can use a fixed level from 1 to 9. Both settings are available in quick settings.

See H700 controls and packaging for details. make test includes search and controller interaction checks using synthetic game data.

Runtime Content

The frontend scans Pegasus metadata and ROM directories on both card roots. The H700 launcher, RetroArch core replacement, filters, recommended controls, cheat import and splash hooks are packaged as separate scripts under H700/launcher/ and related directories. No ROM image is included.

License

The frontend code is distributed under GPLv3 with the Pegasus Frontend additional terms reproduced in LICENSE.md. Bundled cores, music, logos, filters and cheat data have their own provenance and licensing conditions; read THIRD_PARTY_NOTICES.md before redistributing a package.