2018-02-10 20:51:07 +01:00
# Ryujinx [![Build status](https://ci.appveyor.com/api/projects/status/ssg4jwu6ve3k594s?svg=true)](https://ci.appveyor.com/project/gdkchan/ryujinx)
2018-02-05 00:11:01 +01:00
Experimental Switch emulator written in C#
2018-02-20 21:10:03 +01:00
Don't expect much from this. Some homebrew apps work, and Puyo Puyo Tetris shows the intro logo (sometimes) but that's about it for now.
2018-02-05 00:11:01 +01:00
Contributions are always welcome.
2018-02-05 01:39:03 +01:00
2018-02-10 20:51:07 +01:00
**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.
2018-02-20 21:10:03 +01:00
Or just drag'n'drop the *.NRO / * .NSO or the game folder on the executable if you have a pre-build version.
2018-02-10 20:51:07 +01:00
**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:
2018-02-24 22:47:08 +01:00
- Left Joycon:
- Stick Up = W
- Stick Down = S
- Stick Left = A
- Stick Right = D
- Stick Button = F
- DPad Up = Up
- DPad Down = Down
- DPad Left = Left
- DPad Right = Right
- Minus = -
- L = E
- ZL = Q
- Right Joycon:
- Stick Up = I
- Stick Down = K
- Stick Left = J
- Stick Right = L
- Stick Button = H
- A = Z
- B = X
- X = C
- Y = V
- Plus = +
- R = U
- ZR = O
2018-02-18 01:46:29 +01:00
- Config File: `Ryujinx.conf` should be present in executable folder.
For more informations [you can go here ](CONFIG.md ).
2018-02-10 20:51:07 +01:00
**Help**
2018-02-20 21:10:03 +01:00
If you have some homebrew that currently don't work on the emulator, you can contact us through Discord with the compiled NRO/NSO (and source code if possible) and then we'll make changes to make the requested app / game work.
2018-02-10 20:51:07 +01:00
**Contact**
2018-02-20 21:10:03 +01:00
For help, support, suggestions, or if you just want to get in touch with the team, join our Discord server!
2018-02-10 20:51:07 +01:00
https://discord.gg/VkQYXAZ
2018-02-05 01:39:03 +01:00
**Running**
To run this emulator, you need the .NET Core 2.0 (or higher) SDK.
2018-02-10 20:51:07 +01:00
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!).
2018-02-08 17:52:02 +01:00
2018-02-20 21:10:03 +01:00
**Latest build**
2018-02-10 20:51:07 +01:00
2018-02-20 21:10:03 +01:00
These builds are compiled automatically for each commit on the master branch. They may be unstable or not work at all.
2018-02-25 05:34:16 +01:00
To download the latest automatic build for Windows (64-bits), [Click Here ](https://ci.appveyor.com/api/projects/gdkchan/ryujinx/artifacts/ryujinx_latest_unstable.zip?pr=false ).