README.md 5.4 KB
torzu
torzu is a fork of yuzu, an open-source Nintendo Switch emulator.
It is written in C++ with portability in mind and runs on Linux, Windows and Android
Fake websites
A lot of fake Torzu websites have popped up. These are not mine. This project will not have a clearnet website for the foreseeable future! I highly advice against downloading anything from these websites, specially if their intention is clearly to make money through advertisements.
Move away from Codeberg
As requested by Codeberg staff, I have removed the Codeberg mirror repository. The new mirror repository is on NotABug.
Limited public development
I feel like working publicly on this has taken away the fun. You may not understand, but it's quite stressful to have the public eye on a project. Keep in mind, this is just a hobby project. I feel like I always have to keep updating so I don't disappoint you. It's just not a good situation for a hobby project to be in. Turns out: running an open source project takes a lot more time than I have. And then stupid and unnecessary issues like Windows Defender flagging the emulator as malware ruin the rest. I am grateful for all your bug reports, help and support, but all that has distracted me from taking the project into the direction I would've liked.
It is not all over though. My plan is to:
- Continue the blog
- Keep this repository updated enough so it stays compilable on Linux and Windows
- Keep the externals updated
- NOT publish releases. If someone feels like publishing builds they should feel free to do that
- NOT offer support in any way
- Feel free to open issues on the main repository though if you feel like an issue REALLY needs my attention
- Accept pull requests as long as they are of reasonable quality
Again, thanks to everyone who has supported my efforts so far in any way (even by creating bug reports), I really appreciate it.
Compatibility
The emulator is capable of running most commercial games at full speed, provided you meet the necessary hardware requirements.
It runs most Nintendo Switch games released until the date of the Yuzu takedown.
Goals
The first and foremost goal is long-term maintenance. Even if I stop commiting new features I will always do my best to keep the emulator functional and third party dependencies updated. This also means most of the changes made will eventually be bug fixes. Essentially, the main goal is that you can still use this emulator on modern systems in 20 years. It is very important to me that this project is going to be a good base to fork once grass has grown over the whole legal dilemma and people are willing to do real work on this emulator non-anonymously.
A secondary goal is the improvement of usability on low-end systems. This includes both improving the performance of the emulator as well as making games more playable below 100% speed whenever possible (the sync CPU to render speed limit option already helps with that in few cases).
Development
All development happens on Dark Git. It's also where our central repository is hosted.
To clone this git repository, you can use these commands given tor is installed and running:
git -c http.proxy=socks5h://127.0.0.1:9050 clone --depth 1 http://vub63vv26q6v27xzv2dtcd25xumubshogm67yrpaz2rculqxs7jlfqad.onion/torzu-emu/torzu.git
cd torzu
git submodule update --init --recursive
Alternatively, you can clone from the NotABug mirror repository:
git clone https://notabug.org/litucks/torzu.git --depth 1 --recursive
Note that above repository may be taken down any time. Do not rely on its existence in production. In case the NotABug mirror goes down, another mirror will be most likely be set up on Bitbucket.
This project incorporates several commits from the Suyu and Sudachi forks (but cleaned up due to the typically mediocre code/commit quality from both projects) as well as changes listed in Changes.
Building
- Android Build (NotABug alt)
- Linux Build (NotABug alt)
- Windows Build (NotABug alt)
License
yuzu is licensed under the GPLv3 (or any later version). Refer to the LICENSE.txt file.