Touchable
Native iOS experience for your own Switch games
English | įŽäŊä¸æ
Touchable brings ported games a **native iOS experience**, with better touch controls, virtual buttons, graphics, and performance. **Bring your own Switch game files**, and build native iPhone and iPad games on an Apple Silicon Mac.
## General Improvements
Every supported game gets these improvements:
- đĢ§ **Liquid Glass controls**: on-screen buttons use the iOS Liquid Glass style.
- đŗ **HD rumble**: precise vibration through the Taptic Engine or a connected controller.
- đŽ **Game controllers**: play with a physical controller.
- đą **iPhone and iPad**: one app runs full screen on both.
- đ **Game Mode**: native iOS and iPadOS Game Mode gives the game priority for performance.
- đ **Language setting**: choose the game language per app in iOS Settings.
## Exclusive Improvements
Select a game to see its improvements.
## Get started
1. Install the full Xcode and sign in to your Apple Account in Xcode.
2. Put your `prod.keys` in `MyGameFiles/keys/`.
3. Put each NSP in the folder for its game.
4. Double-click `Touchable.command`.
5. Select a game.
6. Select "Build and install" or "Build IPA only".
The first run needs a network connection. The launcher prepares the local tools.
## Where to find things
| Location | Purpose |
| --- | --- |
| [MyGameFiles](MyGameFiles/README.md) | Put your own NSP files and keys here |
| [IPA](IPA/README.md) | Find the finished install packages |
| [docs](docs/README.md) | Read the user guides |
| [internal](internal/README.md) | See the code and developer tools |
For detailed requirements, see [Supported games](docs/supported-games.md).
For install steps, see [Signing and installation](docs/signing-and-install.md).
If an error occurs, first read [Troubleshooting](docs/troubleshooting.md).
Before development, read [AGENTS.md](AGENTS.md).
This project is based on [d2r-mobile](https://github.com/jhaizhou-ops/d2r-mobile).
## Community
Join the [Discord server](https://discord.gg/AKhWUYNKg7) to ask questions, report problems, and share feedback.
## Credits
If you use or adapt Touchable's touch control design in your own project, please credit **mzhao** and link to [this repository](https://github.com/MZhao-ouo/Touchable).
The design includes the Liquid Glass virtual controller, the per-level touch areas, sliding between buttons, and the direct-touch menus.
To cite the project, use **Cite this repository** on GitHub, or see [CITATION.cff](CITATION.cff).
## License and disclaimer
The code is under the [MIT License](LICENSE).
This project is not affiliated with or endorsed by Nintendo, Team Cherry, or any other game publisher.
It does not contain game files, keys, or firmware. You must supply files from games that you own.
Game names, logos, and artwork belong to their owners. The app icons and the Silksong logo in this repository are used only to identify the games.
