Skip to main content

​
General Questions

Hydra is an experimental Nintendo Switch emulator for macOS. It allows you to run Nintendo Switch games and homebrew applications on your Mac. The project is still in early development stages, with limited compatibility but active ongoing development.
Hydra is in very early experimental stages. While some games and homebrew apps work perfectly, most commercial games will either crash or have issues that make them unplayable. The emulator is under active development with frequent improvements.
Yes, Hydra is completely free and open-source software licensed under GPL-3.0. You can download it, use it, and even modify it without any cost.

​
System Requirements

Hydra is specifically designed for macOS and uses Metal graphics API, which is Apple’s proprietary graphics framework. The emulator is optimized for macOS and takes advantage of platform-specific features. There are currently no plans for Windows or Linux versions.
Hydra requires a modern version of macOS with Metal support. While specific minimum requirements aren’t documented, it’s recommended to use the latest stable macOS version for best compatibility and performance. Both Intel and Apple Silicon Macs are supported.
System requirements vary by game. More demanding Switch games will require better hardware. Generally, you’ll need:
  • A Metal-compatible GPU (most modern Macs)
  • Sufficient RAM (8GB minimum, 16GB+ recommended)
  • Modern CPU (Apple Silicon or recent Intel processor)
  • Available storage for games and firmware files
Both Apple Silicon and Intel Macs are supported. Apple Silicon Macs may offer better performance and efficiency due to their modern architecture, but compatibility depends more on the specific game and emulator implementation than the CPU architecture.

​
Setup and Configuration

Hydra supports three Nintendo Switch file formats:
  • NRO - Homebrew executable format
  • NCA - Nintendo Content Archive
  • NX - Alternative format
NSP files are not directly supported but can be converted to NCA using switch-extract-macos or to NX using herakles.
Yes, many games require decrypted firmware files from a Nintendo Switch console to function properly. You can decrypt firmware files using switch-extract-macos. Configure the firmware path in ~/Library/Application Support/Hydra/config.toml.
Game patches are modifications that prevent crashes when running official games in Hydra. You’ll need to download patches from hydra-patches and follow the installation guide. Patches are essential for running most commercial games.
The configuration file is located at ~/Library/Application Support/Hydra/config.toml. This file is created automatically after launching Hydra at least once. You can edit it to configure firmware paths, graphics settings, and other options.
Yes, Hydra can be built with either SDL3 or SwiftUI frontend. To use SwiftUI, build with the -DFRONTEND=SwiftUI CMake option. The SDL3 frontend is the default.

​
Performance and Troubleshooting

Performance issues can have several causes:
  • Your Mac hardware may not meet the game’s requirements
  • The game may not be well optimized in Hydra yet
  • Graphics settings may need adjustment
  • Background applications consuming resources
  • Missing or incorrect firmware files
Try closing other applications, checking your configuration, and ensuring you’re using the latest Hydra version.
Common solutions for crashes:
  1. Ensure you have the required firmware files installed
  2. Install game patches from hydra-patches
  3. Verify your game file isn’t corrupted
  4. Check that the game format is supported (NRO/NCA/NX)
  5. Update to the latest Hydra version
  6. Report the issue on GitHub with details
Yes, graphical glitches are common in early-stage emulators. Hydra is still in experimental development, and graphics rendering is being actively improved. Report specific issues on GitHub to help developers prioritize fixes.
This isn’t explicitly documented, but as an early-stage emulator, online features and multiplayer are likely not implemented yet. Focus is currently on single-player game compatibility and core emulation accuracy.
Controller support depends on SDL3 input handling. Most standard game controllers that work with macOS should be compatible, but specific controller support may vary. Check the configuration file for input settings.

​
Development and Contributing

Contributions are very welcome! You can:
  • Submit pull requests with bug fixes or features
  • Report bugs and compatibility issues on GitHub
  • Test games and provide compatibility feedback
  • Join the Discord server for development discussions
  • Improve documentation
  • Star the project on GitHub to show support
While not explicitly stated in the documentation, Hydra is built with CMake and uses C++ (common for emulators). It uses Metal for graphics rendering and can be built with either SDL3 or SwiftUI for the frontend.
For development help:
  • Join the official Discord server
  • Open discussions on GitHub
  • Check existing issues and pull requests
  • Review the source code and documentation
See the Building from Source page for complete build instructions. You’ll need to:
  1. Install dependencies (cmake, ninja, sdl3, fmt) via Homebrew
  2. Clone the repository and update submodules
  3. Configure with CMake
  4. Build with Ninja
The build process creates a macOS app bundle at build/bin/Hydra.app.
Hydra is released under the GPL-3.0 (GNU General Public License version 3.0) open-source license. This means you can freely use, modify, and distribute the software, but any modifications must also be released under GPL-3.0.

​
Getting Help

Support is available through:
To report a bug:
  1. Search existing issues to avoid duplicates
  2. Open a new issue on GitHub
  3. Include your macOS version and hardware specs
  4. Describe the problem with steps to reproduce
  5. Attach logs, screenshots, or error messages
  6. Specify the Hydra version you’re using

Build docs developers (and LLMs) love

Get started for freeTalk to us