Skip to content

zoeyjodon/moonlight-N3DS

 
 

Repository files navigation

Moonlight for the *New* Nintendo 3DS

Moonlight is an open source client for Sunshine and NVIDIA GameStream for the *New* Nintendo 3DS, forked from Moonlight Embedded. Moonlight allows you to stream your full collection of games and applications from your PC to other devices to play them remotely.

Original 3DS Note

While this app is operable on the original 3DS, the hardware decoder must be disabled and the framerate will be significantly lower due to the slower CPU.

First time setup/use

Pairing

After modding your 3DS and installing the Moonlight CIA, open the moonlight application from your home menu.

  • You will be greeted with a screen prompting you to select a host server address. Assuming you don't already have a host configured, press the A button to begin setting up a new host connection.
  • Enter your host computer's IP address
    • Windows: Open the Start menu, type cmd, and press Enter. In the black window, type ipconfig and press Enter. Look for "IPv4 Address".
    • Mac: Click the Apple icon > System Settings (or Preferences) > Network. Select your Wi-Fi or Ethernet connection to see the IP address.
  • Once you enter your IP address, your 3DS will connect to your PC and give you the option to pair
  • Follow the prompts through the pairing process, entering the PIN generated by your 3DS on the PIN page of Sunshine.
  • Once pairing is complete, you can connect with your PC (identified by its IP address on the main menu)

Streaming

  • Once you connect with a paired PC, you will see a menu giving you the option to stream. Select this option, then choose which application you want to stream from your PC.
  • Once the stream begins, you will see a menu on the bottom screen offering view/control options. Touch any of these buttons to select a streaming view.
  • NOTE: You can re-open the streaming menu any time during the stream by pressing the 3DS's HOME button.
    • Pressing the HOME button from the menu will return you to the 3DS's home menu.
    • The stream will remain active while you are in the 3DS home menu, but closing the app will close the stream.
  • NOTE: When the Magnify view is active, you can lock the region you are magnifying by holding either of the shoulder buttons (L or R).
    • When the view is locked, you can use the touchscreen to click, drag, and release items in the selected region of the screen (similar to the Mirror and Stretch views)

Configuration

You can modify documented settings either in the app, or by creating/modifying the config file located at sd:/3ds/moonlight/moonlight.conf. The default settings are recommended for *New* 3DS users.

Documentation

More information about installing and runnning Moonlight Embedded is available on the wiki.

Build

I have included a Dockerfile which has all of the required build dependencies pre-installed. The easiest way to build moonlight.cia is by building and running the docker image. If you are using VS Code as your editor, you can use the Build Docker and Run Docker tasks for this. If you are not using VS Code, you can build and run the docker image with the following terminal commands from the root of the repository:

docker build --network=host -t moonlight-n3ds .
docker run --rm -it -v .:/moonlight-N3DS -w /moonlight-N3DS moonlight-n3ds:latest

Then, run the following command in the docker commandline:

make

Install

You can download the CIA file (moonlight.cia) from the Releases page, and install it using FBI.

Please note that to run Moonlight on the 3DS, you will need to install custom firmware. You can find instructions for installing CFW here.

See also

Moonlight-common-c is the shared codebase between different Moonlight implementations

Contribute

  1. Fork us
  2. Write code
  3. Send Pull Requests

About

Gamestream client for the New 3DS

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

No contributors

Languages

  • C++ 59.8%
  • C 25.5%
  • CMake 8.0%
  • Makefile 4.8%
  • Shell 1.2%
  • Dockerfile 0.7%