# Cemu — Open Source Wii U Emulator with Vulkan Rendering

> High-accuracy Wii U emulator written in C++ that runs most of the Wii U library with Vulkan and OpenGL backends, async shader compilation, and motion control support.

## Install

Save in your project root:

# Cemu — Open Source Wii U Emulator with Vulkan Rendering

## Quick Use
```bash
# Linux (Flatpak)
flatpak install flathub info.cemu.Cemu
flatpak run info.cemu.Cemu
# Windows: download from cemu.info and extract the archive
# AppImage also available from the GitHub releases page
```

## Introduction
Cemu is an open-source Wii U emulator that was originally released as a closed-source Windows application in 2015 and transitioned to open source under the MPL-2.0 license in 2022. It can run nearly the entire Wii U library, including demanding titles, at full speed on modern hardware with graphical enhancements beyond the original console.

## What Cemu Does
- Emulates the Wii U's Espresso tri-core PowerPC CPU and Latte GPU
- Renders via Vulkan or OpenGL with resolution scaling and anti-aliasing
- Supports async shader compilation to reduce stuttering during gameplay
- Handles Wii U GamePad, Pro Controller, and Wiimote input including gyroscope and touchscreen
- Provides graphic packs for per-game resolution, FPS, and visual modifications

## Architecture Overview
Cemu translates the Wii U's PowerPC instructions into x86-64 code using a recompiler. The GPU emulation converts Wii U GX2 graphics commands into Vulkan or OpenGL calls. A shader cache system stores compiled shaders to eliminate hitching after the first encounter. The emulator supports the Wii U's unique dual-screen setup, displaying the GamePad screen in a separate window or as an overlay.

## Self-Hosting & Configuration
- Download from cemu.info or install via Flatpak on Linux
- Optionally install decryption keys for disc-based game dumps
- Configure the GPU backend to Vulkan for best performance and async shader compilation
- Install community graphic packs from the built-in downloader for resolution scaling and FPS mods
- Map controllers including motion controls for games that require gyroscope input

## Key Features
- Vulkan backend with async shader compilation for smooth gameplay
- Community graphic packs that enable 4K resolution, 60 FPS mods, and visual tweaks per game
- Dual-screen output with configurable GamePad display positioning
- Online service emulation through Pretendo Network for supported titles
- Save and load state support for quick experimentation

## Comparison with Similar Tools
- **Dolphin** — emulates GameCube and Wii (predecessor consoles); more mature with broader compatibility
- **Ryujinx/Yuzu** — targeted Nintendo Switch; both discontinued due to legal action
- **RPCS3** — PS3 emulator from the same console generation; different hardware architecture
- **RetroArch** — multi-system frontend that does not include a Wii U core; Cemu is the standalone option

## FAQ
**Q: Is Cemu legal?**
A: The emulator itself is legal and contains no Nintendo code. You need your own Wii U games and firmware.

**Q: What are graphic packs?**
A: Community-made configuration files that modify resolution, frame rate, and visual settings per game. They are downloadable from within Cemu.

**Q: Does it support online play?**
A: Official Nintendo servers are shut down for Wii U. Cemu supports Pretendo Network, a community replacement for online services.

**Q: What hardware is recommended?**
A: A modern quad-core CPU and a Vulkan-capable GPU. Most titles run at full speed on mid-range hardware from the last few years.

## Sources
- https://github.com/cemu-project/Cemu
- https://cemu.info/

---
Source: https://tokrepo.com/en/workflows/asset-2e59d44e
Author: AI Open Source