2018-05-15 09:57:22 -07:00
![](https://ryujinx.github.io/static/img/Ryujinx_logo_128.png)
2018-02-10 11:51:07 -08:00
# Ryujinx [![Build status](https://ci.appveyor.com/api/projects/status/ssg4jwu6ve3k594s?svg=true)](https://ci.appveyor.com/project/gdkchan/ryujinx)
2018-02-04 15:11:01 -08:00
Experimental Switch emulator written in C#
2018-12-17 16:34:23 -08: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 16:39:03 -08:00
2018-02-10 11:51:07 -08:00
**Building**
2018-12-17 16:34:23 -08: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 11:51:07 -08:00
**Features**
2018-12-17 16:34:23 -08: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 16:46:29 -08:00
- Config File: `Ryujinx.conf` should be present in executable folder.
2018-07-02 15:08:54 -07:00
For more information [you can go here ](CONFIG.md ).
2018-05-11 16:17:43 -07:00
2018-02-10 11:51:07 -08:00
**Help**
2018-12-17 16:34:23 -08: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 11:51:07 -08:00
**Contact**
2018-12-17 16:34:23 -08: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 11:51:07 -08:00
2018-12-17 16:34:23 -08:00
For donation support, please take a look at our [Patreon ](https://www.patreon.com/ryujinx ).
2018-07-11 15:08:20 -07:00
2018-02-04 16:39:03 -08:00
**Running**
2018-12-17 16:34:23 -08: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 17:06:49 -07:00
2018-05-11 16:17:43 -07:00
**Compatibility**
2018-07-11 15:08:20 -07:00
2018-12-17 16:34:23 -08:00
You can check out the compatibility list [here ](https://github.com/Ryujinx/Ryujinx-Games-List/issues ).
2018-02-08 08:52:02 -08:00
2018-02-20 12:10:03 -08:00
**Latest build**
2018-02-10 11:51:07 -08:00
2018-06-10 16:44:48 -07: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 16:34:23 -08:00
The latest automatic build for Windows, Mac, and Linux can be found on the [official website ](https://ryujinx.org/#/Build ).