2018-05-15 12:57:22 -04:00
![](https://ryujinx.github.io/static/img/Ryujinx_logo_128.png)
2018-02-10 14:51:07 -05:00
# Ryujinx [![Build status](https://ci.appveyor.com/api/projects/status/ssg4jwu6ve3k594s?svg=true)](https://ci.appveyor.com/project/gdkchan/ryujinx)
2018-02-04 18:11:01 -05:00
Experimental Switch emulator written in C#
2018-12-17 19:34:23 -05:00
Many games boot, only a handful are playable, see the compatiblity list [here ](https://github.com/Ryujinx/Ryujinx-Games-List/issues ).
2018-02-04 19:39:03 -05:00
2018-02-10 14:51:07 -05:00
**Building**
2018-12-17 19:34:23 -05:00
To build this emulator, you will need the [.NET Core 2.1 (or higher) SDK ](https://www.microsoft.com/net/download/ )
or just drag'n'drop the homebrew *.NRO / * .NSO or the game *.NSP / * .XCI on the executable if you have a pre-built version.
2018-02-10 14:51:07 -05:00
**Features**
2018-12-17 19:34:23 -05:00
- Audio is partially supported.
- Keyboard Input is supported, see [CONFIG.md ](CONFIG.md )
- Controller Input is supported, see [CONFIG.md ](CONFIG.md )
2018-02-17 19:46:29 -05:00
2019-02-11 07:00:32 -05:00
- Config File: `Config.jsonc` should be present in executable folder.
2018-07-02 18:08:54 -04:00
For more information [you can go here ](CONFIG.md ).
2018-05-11 19:17:43 -04:00
2018-02-10 14:51:07 -05:00
**Help**
2018-12-17 19:34:23 -05:00
If you have some homebrew that currently doesn't work within the emulator, you can contact us through our Discord with the compiled *.NRO / * .NSO (and source code if possible) and then we'll keep whatever is making app / game not work on the watch list and fix it at a later date.
2018-02-10 14:51:07 -05:00
**Contact**
2018-12-17 19:34:23 -05:00
For help, support, suggestions, or if you just want to get in touch with the team; join our [Discord server ](https://discord.gg/N2FmfVc )!
2018-02-10 14:51:07 -05:00
2018-12-17 19:34:23 -05:00
For donation support, please take a look at our [Patreon ](https://www.patreon.com/ryujinx ).
2018-07-11 18:08:20 -04:00
2018-02-04 19:39:03 -05:00
**Running**
2018-12-17 19:34:23 -05:00
To run this emulator, you need the .NET Core 2.1 (or higher) SDK.
Run `dotnet run -c Release -- path\to\homebrew.nro` inside the Ryujinx project folder to run homebrew apps.
Run `dotnet run -c Release -- path\to\game.nsp/xci` to run official games.
2018-04-24 20:06:49 -04:00
2018-05-11 19:17:43 -04:00
**Compatibility**
2018-07-11 18:08:20 -04:00
2018-12-17 19:34:23 -05:00
You can check out the compatibility list [here ](https://github.com/Ryujinx/Ryujinx-Games-List/issues ).
2018-02-08 11:52:02 -05:00
2018-02-20 15:10:03 -05:00
**Latest build**
2018-02-10 14:51:07 -05:00
2018-06-10 19:44:48 -04:00
These builds are compiled automatically for each commit on the master branch. They may be unstable or might not work at all.
2018-12-17 19:34:23 -05:00
The latest automatic build for Windows, Mac, and Linux can be found on the [official website ](https://ryujinx.org/#/Build ).