NSO-RPC Docker Image

This Docker image is designed to run the NSO-RPC application headlessly, such as on a VPS.

Note: I'm also not very skilled at writing documentation, but I've included the steps as best as I can to get this setup going.

Components

NSO-RPC: Nintendo Switch RPC Client
ARRPC: Unofficial Discord RPC Bridge
Webcord: Unofficial Discord Client

Note: Unofficial Discord clients are against Discord's Terms of Service, so use them with caution. However, this setup should be relatively safe.

Usage

Prerequisites

Docker
Docker Compose

Running the containers for the first time

To run the Docker setup, it requires a hands-on approach to get started.

Clone the repository:

git clone https://github.com/HotaruBlaze/NSO-RPC-Docker.git

Navigate to the project directory:
```
cd NSO-RPC-Docker
```
Run:
```
docker compose run --rm nso-rpc
```
This command will automatically build (if not previously built) the NSO-RPC container and allow you to do the initial setup.
Follow the instructions on the prompt. If clicking on the link gives you "The request contains an error," the URL may not have been copied correctly.
After setting your user ID, you wont get output back. Type Ctrl + C to stop the container.
Run the following to start the containers.
```
docker compose up -d
```
Open a web browser and go to http://your_server_hostname:3000 or http://your_server_ip:3000 to connect to the WebCord container.
Log in to Discord. If you have issues with the QR code, log in directly.
Once logged in, go to File > Settings, and make the following changes:
- Untick "Use built-in Content Security Policy"
- Enable Developer Mode
Close the settings window.
Restart Webcord via File > Relaunch.
Open Chrome Dev Tools in Webcord by pressing Ctrl + Shift + I, and then click on Console.
Now paste the contents of webcord-hook.js into the console and press Enter. (This script can also be found on arRPC's repo here).

NOTE 1: To be able to paste, you might need to use KasmVNC's Clipboard feature by clicking on the little arrow on the left of the screen, then clicking on "Clipboard" and pasting the webcord-hook.js contents inside the text box that shows up, before you're able to paste it on the console.

NOTE 2: The first time you try to paste on Chrome's console, you might need to type allow pasting first.

You should now be fully setup and should see Switch RPC presence on your account.

Subsequent runs

For subsequent runs, you only need to:

Run
```
docker compose up -d
```
to start the containers.
Login to Discord as described above.
Paste the webcord-hook.js into the Chrome Dev Tools console, as described above.

Troubleshooting

If you're having trouble, run the following to see the NSO-RPC log:

docker compose logs nso-rpc

The log of a successful setup should look similar to this:

nso-rpc  | [arRPC] arRPC v3.1.0
nso-rpc  | (node:7) ExperimentalWarning: Importing JSON modules is an experimental feature and might change at any time
nso-rpc  | (Use `node --trace-warnings ...` to show where the warning was created)
nso-rpc  | [arRPC > bridge] listening on 1337
nso-rpc  | [arRPC > ipc] listening at /tmp/discord-ipc-0
nso-rpc  | [arRPC > websocket] listening on 6463
nso-rpc  | [arRPC > process] started
nso-rpc  | [arRPC > ipc] new connection!
nso-rpc  | Successfully Connected to Discord.
nso-rpc  | [arRPC > bridge] web connected