Hakchi2 CE lets you add more games to your NES Classic Mini and SNES Classic Mini (and their Famicom/Super Famicom variants). This is a fork of TeamShinkansen/Hakchi2-CE that adds Linux support.
Get the latest version from the Releases page:
| System | File |
|---|---|
| Windows | hakchi2-ce-…-installer.exe (or …-portable.zip) |
| Linux (any distro) | Hakchi2_CE-x86_64.AppImage |
| Linux (alternative) | hakchi2-ce-linux.tar.gz |
Run the installer, or unzip the portable version anywhere and start hakchi.exe.
The AppImage is a single file that includes everything Hakchi2 CE needs; there is nothing else to install.
- Download
Hakchi2_CE-x86_64.AppImagefrom the Releases page. - Allow it to run: right-click the file → Properties → Permissions → tick Allow executing file as
program (wording varies by desktop), or in a terminal:
chmod +x ~/Downloads/Hakchi2_CE-x86_64.AppImage - Double-click it. On first start it adds Hakchi2 CE to your app menu, so next time you can open it from there.
Your settings and games are kept in
~/hakchi2. - Plug in your console (USB cable to the PC) and switch it on. If USB access isn't set up yet, Hakchi2 CE asks to set it up for you — click Yes and enter your password once.
If the AppImage doesn't start, your system is probably missing FUSE, which AppImages use to open themselves:
sudo apt install fuse3 (Ubuntu/Debian/Mint), sudo pacman -S fuse3 (Arch/CachyOS/Omarchy),
sudo dnf install fuse3 (Fedora). Or start it without FUSE:
~/Downloads/Hakchi2_CE-x86_64.AppImage --appimage-extract-and-run.
If you prefer not to use the AppImage, install Mono and run the program from a folder:
sudo pacman -S --needed mono libgdiplus libusb # Arch, CachyOS, Omarchy
sudo apt install mono-complete libgdiplus libusb-1.0-0 # Debian, Ubuntu, Mint
tar -xzf hakchi2-ce-linux.tar.gz -C ~
~/hakchi2-ce/hakchi.shThe first run adds it to your app menu. More details, including manual USB/network setup and troubleshooting, are in the Linux guide.
- Click Add more games and pick your ROM files.
- Plug in and switch on the console. When the bottom-left corner shows it's online, click Synchronize selected games with mini.
- Unplug the console and play.
A console that has never been modded needs hakchi installed first (Kernel → Install / Repair, with the console in FEL mode: hold RESET while switching it on). Back up your console from the Kernel menu before doing that.
- Windows: open
hakchi_gui.slnin Visual Studio, or see.github/workflows/dotnet-desktop.yml. - Linux: see Building from source; the AppImage is built by
linux/appimage/build-appimage.sh.