mirror of https://github.com/cemu-project/Cemu.git synced 2024-11-23 11:29:53 +00:00

Cemu - Wii U emulator

Go to file

Exzap 6f9f3d52ea Some checks failed Build check / build (push) Has been cancelled Details Generate translation template / generate-pot (push) Has been cancelled Details CI: Remove outdated workflow		2024-11-13 06:38:17 +01:00
.github	CI: Remove outdated workflow	2024-11-13 06:38:17 +01:00
bin	Update translation files	2024-09-08 15:40:13 +00:00
cmake	nsyshid: Add backends for cross platform USB passthrough support (#950 )	2023-09-19 01:27:40 +02:00
dependencies	CI+build: Improve macOS builds (#1310 )	2024-08-28 11:06:49 +02:00
dist	appimage: Do not copy `libstdc++.so.6` to `usr/lib/` (#1319 )	2024-09-02 21:22:38 +02:00
src	config: Fix receive_untested_updates using the wrong default	2024-11-13 06:29:24 +01:00
.clang-format	clang-format: Put class braces on a new line (#1283 )	2024-08-08 19:35:50 +02:00
.gitignore	Implement proc_ui.rpl + stub SYSSwitchToEManual() to avoid softlocks	2024-04-30 23:29:15 +02:00
.gitmodules	git: unshallow vcpkg, shallow vulkan-headers and imgui (#1282 )	2024-08-08 15:58:24 +02:00
BUILD.md	CI+build: Improve macOS builds (#1310 )	2024-08-28 11:06:49 +02:00
CMakeLists.txt	Various smaller code improvements (#1343 )	2024-09-17 02:00:26 +02:00
CMakeSettings.json	Code cleanup	2023-10-01 11:46:26 +02:00
CODING_STYLE.md	Minor localization adjustments (#984 )	2023-09-30 15:27:56 +02:00
LICENSE.txt	Expand readme with links and description	2022-08-23 02:37:05 +02:00
README.md	README.md: Fix minor ambiguity	2024-03-08 14:48:59 +01:00
vcpkg.json	vcpkg: Update dependencies (#1229 )	2024-06-05 16:34:42 +02:00

README.md

Cemu - Wii U emulator

This is the code repository of Cemu, a Wii U emulator that is able to run most Wii U games and homebrew in a playable state. It's written in C/C++ and is being actively developed with new features and fixes.

Cemu is currently only available for 64-bit Windows, Linux & macOS devices.

Links:

Other relevant repositories:

Download

You can download the latest Cemu releases for Windows, Linux and Mac from the GitHub Releases. For Linux you can also find Cemu on flathub.

On Windows Cemu is currently only available in a portable format so no installation is required besides extracting it in a safe place.

The native macOS build is currently purely experimental and should not be considered stable or ready for issue-free gameplay. There are also known issues with degraded performance due to the use of MoltenVK and Rosetta for ARM Macs. We appreciate your patience while we improve Cemu for macOS.

Pre-2.0 releases can be found on Cemu's changelog page.

Build Instructions

To compile Cemu yourself on Windows, Linux or macOS, view BUILD.md.

Issues

Issues with the emulator should be filed using GitHub Issues.
The old bug tracker can be found at bugs.cemu.info and still contains relevant issues and feature suggestions.

Contributing

Pull requests are very welcome. For easier coordination you can visit the developer discussion channel on Discord or alternatively the Matrix Server. Before submitting a pull request, please read and follow our code style guidelines listed in CODING_STYLE.md.

If coding isn't your thing, testing games and making detailed bug reports or updating the (usually outdated) compatibility wiki is also appreciated!

Questions about Cemu's software architecture can also be answered on Discord (or through the Matrix bridge).

License

Cemu is licensed under Mozilla Public License 2.0. Exempt from this are all files in the dependencies directory for which the licenses of the original code apply as well as some individual files in the src folder, as specified in those file headers respectively.