Experimental Nintendo Switch Emulator written in C#
Find a file
jduncanator 8275bc3c08 Implement libsoundio as an alternative audio backend (#406)
* Audio: Implement libsoundio as an alternative audio backend

libsoundio will be preferred over OpenAL if it is available on the machine. If neither are available, it will fallback to a dummy audio renderer that outputs no sound.

* Audio: Fix SoundIoRingBuffer documentation

* Audio: Unroll and optimize the audio write callback

Copying one sample at a time is slow, this unrolls the most common audio channel layouts and manually copies the bytes between source and destination. This is over 2x faster than calling CopyBlockUnaligned every sample.

* Audio: Optimize the write callback further

This dramatically reduces the audio buffer copy time. When the sample size is one of handled sample sizes the buffer copy operation is almost 10x faster than CopyBlockAligned.

This works by copying full samples at a time, rather than the individual bytes that make up the sample. This allows for 2x or 4x faster copy operations depending on sample size.

* Audio: Fix typo in Stereo write callback

* Audio: Fix Surround (5.1) audio write callback

* Audio: Update Documentation

* Audio: Use built-in Unsafe.SizeOf<T>()

Built-in `SizeOf<T>()` is 10x faster than our `TypeSize<T>` helper. This also helps reduce code surface area.

* Audio: Keep fixed buffer style consistent

* Audio: Address styling nits

* Audio: More style nits

* Audio: Add additional documentation

* Audio: Move libsoundio bindings internal

As per discussion, moving the libsoundio native bindings into Ryujinx.Audio

* Audio: Bump Target Framework back up to .NET Core 2.1

* Audio: Remove voice mixing optimizations.

Leaves Saturation optimizations in place.
2018-11-15 03:22:50 +01:00
ChocolArm64 Fix BLR when the source reg is X30 (#493) 2018-11-09 16:41:20 -02:00
Ryujinx Implement libsoundio as an alternative audio backend (#406) 2018-11-15 03:22:50 +01:00
Ryujinx.Audio Implement libsoundio as an alternative audio backend (#406) 2018-11-15 03:22:50 +01:00
Ryujinx.Common Timing: Optimize Timestamp Aquisition (#479) 2018-10-28 19:31:13 -03:00
Ryujinx.Graphics Force cache to remove entries when memory usage exceeds a given threshold (#492) 2018-11-14 23:22:02 +01:00
Ryujinx.HLE Implement libsoundio as an alternative audio backend (#406) 2018-11-15 03:22:50 +01:00
Ryujinx.LLE Add Sqdmulh_S, Sqdmulh_V, Sqrdmulh_S, Sqrdmulh_V instructions; add 6 Tests. Now all saturating methods are on ASoftFallback. (#334) 2018-08-10 14:27:15 -03:00
Ryujinx.ShaderTools Add Sqdmulh_S, Sqdmulh_V, Sqrdmulh_S, Sqrdmulh_V instructions; add 6 Tests. Now all saturating methods are on ASoftFallback. (#334) 2018-08-10 14:27:15 -03:00
Ryujinx.Tests Add Flush-to-zero mode (input, output) to FP instructions (slow paths); update FP Tests. Update Naming Conventions for Tests project. (#489) 2018-11-01 01:22:09 -03:00
Ryujinx.Tests.Unicorn Remove unnecessary usings (#463) 2018-10-17 14:55:10 -03:00
.gitattributes aloha 2018-02-04 20:08:20 -03:00
.gitignore .gitignore: ignore autogenerated launchSettings.json (#292) 2018-07-19 13:45:50 -03:00
.travis.yml Add some tests (#18) 2018-02-15 21:04:38 -03:00
appveyor.yml fix extra space 2018-07-19 18:53:49 +00:00
CONFIG.md Add Controller Support (#196) 2018-07-02 19:08:54 -03:00
KEYS.md Add XCI, NSP and NCA loading support (#404) 2018-09-08 15:33:27 -03:00
LICENSE.txt aloha 2018-02-04 20:08:20 -03:00
README.md Update README.md 2018-07-12 00:08:20 +02:00
Ryujinx.sln Move logging to Ryujinx.Common and make it a static class (#413) 2018-10-17 14:15:50 -03:00

Ryujinx Build status

Experimental Switch emulator written in C#

Don't expect much from this. Some homebrew apps work, Puyo Puyo Tetris shows the intro logo (sometimes), and a handful of games boot / work; but that's about it for now. Contributions are always welcome.

Building

To build this emulator, you will need the .NET Core 2.1 (RC1) (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 / *.NSO 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:

    • 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
    • For more information on how to configure these buttons see CONFIG.md

  • Controller Input is partially supported:

    • Left Joycon:

      • Analog Stick = Left Analog Stick
      • DPad Up = DPad Up
      • DPad Down = DPad Down
      • DPad Left = DPad Left
      • DPad Right = DPad Right
      • Minus = Select / Back / Share
      • L = Left Shoulder Button
      • ZL = Left Trigger
    • Right Joycon:

      • Analog Stick = Right Analog Stick
      • A = B / Circle
      • B = A / Cross
      • X = Y / Triangle
      • Y = X / Square
      • Plus = Start / Options
      • R = Right Shoulder Button
      • ZR = Right Trigger
    • For more information on how to configure these buttons see CONFIG.md

  • Config File: Ryujinx.conf should be present in executable folder. For more information you can go here.

  • If you are a Windows user, you can configure your keys, the logs, install OpenAL, etc... with Ryujinx-Setting. Download it, right here

Help

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 make changes in order to make the requested app / game work.

Contact

For help, support, suggestions, or if you just want to get in touch with the team; join our Discord server!
https://discord.gg/VkQYXAZ

For donation support, please take a look at our Patreon: https://www.patreon.com/ryujinx

Running

To run this emulator, you need the .NET Core 2.1 (or higher) SDK and the OpenAL 11 Core 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!)

Compatibility

You can check out the compatibility list within the Wiki. Only a handful of games actually work.

Latest build

These builds are compiled automatically for each commit on the master branch. They may be unstable or might not work at all.
The latest automatic build for Windows (64-bit) can be found on the official website.