64 lines
2.6 KiB
Markdown
64 lines
2.6 KiB
Markdown
# Ryujinx [![Build status](https://ci.appveyor.com/api/projects/status/ssg4jwu6ve3k594s?svg=true)](https://ci.appveyor.com/project/gdkchan/ryujinx)
|
|
|
|
Experimental Switch emulator written in C#
|
|
|
|
Don't expect much from this. Some homebrew apps works, and Tetris shows the intro logos (sometimes) but that's about it for now.
|
|
Contributions are always welcome.
|
|
|
|
**Building**
|
|
|
|
To build this emulator, you need the .NET Core 2.0 (or higher) SDK. https://www.microsoft.com/net/download/
|
|
In release builds, memory checks are disabled to improve performances.
|
|
|
|
Or just drag'n'drop the *.NRO or the game folder on the executable if you have a pre-build version.
|
|
|
|
**Features**
|
|
|
|
- Audio is partially supported (glitched) on Windows but you need to install the OpenAL Core SDK.
|
|
https://openal.org/downloads/OpenAL11CoreSDK.zip
|
|
|
|
- Keyboard Input is partially supported:
|
|
- Arrows.
|
|
- Enter > "Start" & Tab > "Select"
|
|
- Qwerty:
|
|
- A > "A" (QWERTY) / Q > "A" (AZERTY)
|
|
- S > "B"
|
|
- Z > "X" (QWERTY) / W > "X" (AZERTY)
|
|
- X > "Y"
|
|
- Key_Up > "Right Stick Up"
|
|
- Key_Down > "Right Stick Down"
|
|
- Key_Left > "Right Stick Left"
|
|
- Key_Right > "Right Stick Right"
|
|
- I > "Left Stick Up"
|
|
- K > "Left Stick Down"
|
|
- J > "Left Stick Left"
|
|
- L > "Left Stick Right"
|
|
- Tab > "Minus"
|
|
- Enter > "Plus"
|
|
|
|
- Config File: `Ryujinx.conf` should be present in executable folder.
|
|
For more informations [you can go here](CONFIG.md).
|
|
|
|
**Help**
|
|
|
|
If you have some homebrews that currently doesn't work on it, you can contact us through discord with the compiled NRO/NSO (and source code if possible) and will work to make them work.
|
|
|
|
**Contact**
|
|
|
|
For help, support, suggestion, or if you just want to get in touch with the team, join our Discord server!
|
|
https://discord.gg/VkQYXAZ
|
|
|
|
**Running**
|
|
|
|
To run this emulator, you need the .NET Core 2.0 (or higher) SDK.
|
|
Run `dotnet run -c Release -- path\to\homebrew.nro` inside the Ryujinx solution folder to run homebrew apps.
|
|
Run `dotnet run -c Release -- path\to\game_exefs_and_romfs_folder` to run official games (they need to be decrypted and extracted first!).
|
|
|
|
Audio is partially supported (glitched) on Linux and macOS, for Windows you need to install the OpenAL Core SDK:
|
|
https://openal.org/downloads/OpenAL11CoreSDK.zip
|
|
|
|
**Lastest build**
|
|
|
|
Those builds are compiled automatically for each commit on the master branch. They may be unstable or not work at all.
|
|
To download the lastest automatic build for Windows (64-bits), [Click Here](https://ci.appveyor.com/api/projects/gdkchan/ryujinx/artifacts/ryujinx_lastest_unstable.zip).
|