Watch

mirror of https://github.com/citron-neo/emulator.git synced 2026-10-24 21:17:12 -05:00

The switch fell off https://citron-neo.org/

C++ 65.5%
cpp 27.8%
Kotlin 3.2%
CMake 1.5%
Shell 1.1%
Other 0.8%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
cheezwiz7899 56dad81195 Merge pull request #443 from cheezwiz7899/re-nuke-tarball build:nuke tarball again		2026-10-25 09:56:39 +13:00
.reuse	deps: remove microprofiler	2026-03-17 05:47:57 +00:00
AppImageBuilder	build:nuke tarball again	2026-10-24 18:05:51 +13:00
CMakeModules	game_list: refactor "Run with AOT", add SNX_PROGRESS_FILE JSON event tracking, bundle ScarletNX support, and pass SNX_KEYS/SNX_TITLE_KEYS env vars	2026-10-23 17:57:56 +13:00
dist	Treat non-ASCII Windows paths the same as ASCII paths.	2026-09-14 10:01:42 +09:00
docs	minor documentation updates	2026-07-16 18:38:46 +10:00
externals	Revert "Merge pull request #376 from bikeborb/cxx23-dynarmic-and-flat-ir"	2026-10-19 23:05:13 +00:00
hooks	chore: update project branding to citron	2025-05-06 16:06:48 +10:00
LICENSES	general: fix trailing whitespace	2024-01-08 09:34:32 -05:00
patches	Revert "Merge pull request #376 from bikeborb/cxx23-dynarmic-and-flat-ir"	2026-10-19 23:05:13 +00:00
src	nce: replace kernel uapi signal headers with hardcoded ABI constants, add static_assert validation	2026-10-24 10:09:46 +13:00
tools	video_core: reserve shared GC staging through mapped readback	2026-10-10 09:02:00 +08:00
.codespellrc	core: refactor emulated cpu core activation	2023-12-04 10:37:16 -05:00
.git-blame-ignore-revs	Skip git blame	2023-11-04 18:26:49 +00:00
.gitattributes	chore: make yuzu REUSE compliant	2022-07-27 12:53:49 +02:00
.gitignore	feat: add .diagnostics to .gitignore for improved file management	2026-07-12 10:05:35 +08:00
.gitmodules	Revert "Merge pull request #376 from bikeborb/cxx23-dynarmic-and-flat-ir"	2026-10-19 23:05:13 +00:00
build-citron-linux.sh	build:nuke tarball again	2026-10-24 18:05:51 +13:00
build-clangtron-windows.bat	fix stupid msys2 and windows cmd path handling	2026-04-18 14:40:08 +10:00
build-clangtron-windows.sh	build: fix clang-cl relwithdebinfo hangs on full LTO builds. Also prevent mingw headers from leaking in through the ffmpeg build cache	2026-09-27 08:12:34 +10:00
CHANGELOG	Add new file	2025-10-03 15:05:41 +10:00
CMakeLists.txt	game_list: refactor "Run with AOT", add SNX_PROGRESS_FILE JSON event tracking, bundle ScarletNX support, and pass SNX_KEYS/SNX_TITLE_KEYS env vars	2026-10-23 17:57:56 +13:00
Doxyfile	chore: update project branding to citron	2025-05-06 16:06:48 +10:00
LICENSE	chore: update project branding to citron	2025-05-06 16:06:48 +10:00
README.md	docs: show the README logo at 128 px	2026-10-11 23:38:49 -04:00
vcpkg.json	Treat non-ASCII Windows paths the same as ASCII paths.	2026-09-14 10:01:42 +09:00

README.md

Citron Neo

Citron Neo is an open-source emulator that continues the Citron codebase. It runs on Windows, Linux, macOS and Android (arm64). Development and maintenance happen on Discord.

Building

Library dependencies are fetched at configure time by CPM, so you don't need to initialise submodules first.

Linux. Run ./build-citron-linux.sh setup once, then ./build-citron-linux.sh use --pgo none --lto full for a build without the profiling round. The binary lands in build/use-nopgo/bin/citron, with an AppImage beside it. docs/BUILDING-CITRON-LINUX.md covers the PGO stages, which give the best performance.

Windows. Build with clang-cl natively, or cross-compile from Linux with llvm-mingw. docs/BUILDING-CITRON-WINDOWS.md has both.

Android. From src/android, run ./gradlew assembleMainlineRelease. Without a release keystore in the environment, the APK is signed with the bundled debug key.

Contributing

Issues and pull requests are welcome. Ask on Discord before starting something large. When reporting a bug, say which platform, GPU and driver you're on, and which commit or build you're running.

Licence

GPL-3.0-or-later. See LICENSE. Third-party components and their licences are in LICENSES/.