NX Remote Play

Fix a problem

Start with what you see, then collect logs if you need help.

Start with what you see. Each problem below lists the checks in the order most likely to fix it. If none of them work, the last section shows how to collect logs so the problem can be found.

Can’t join

USB doesn’t connect

Connected, but no picture

Picture, but no sound

Buttons do nothing

Stutters or falls behind

Browser says the page isn’t secure

The Windows app makes its own certificate for the web player, so browsers warn about it the first time. It’s safe to continue to your own link. To remove the warning for Public links, turn on Automatic public-IP HTTPS certificate in the Windows app’s Web Sharing settings and accept the agreement.

Collect logs and report a problem

Reproduce the problem once, note the time and your time zone, then export the logs as soon as you can. Say what you were doing when it happened. Avoid clearing app data or running several unrelated tests before exporting, so the files still cover the problem.

Collect logs from the Switch being played and the device you played on. Each export contains that device’s own logs, not the whole setup:

Switch

  1. After reproducing the problem, open NX Remote Play from the homebrew launcher. Close any other running homebrew app before opening hbmenu through Album.
  2. Open Settings → Actions → Export logs, then choose Create log file.
  3. Wait for Saved to the SD card root. The file is /NX-Remote-Play-logs.txt.
  4. Copy that file to the device you will use to submit the issue. You can use an FTP connection you already have set up, or fully shut down the Switch before removing the SD card and reading it on a computer. Do not remove the card while the Switch is running or asleep.

Each export replaces NX-Remote-Play-logs.txt. Keep a separate copy if you need logs from more than one test or console. Export from the host Switch even when the problem appears on the viewer.

Windows

  1. Reproduce the problem, then disconnect or stop the stream. Keep NX Remote Play open so you can export; traces still being written can be left out of the ZIP.
  2. Open Settings → Diagnostics & Logging → Export logs.
  3. Wait for the export notice. The Diagnostics folder opens automatically.
  4. Find NX-Remote-Play-desktop-logs-YYYYMMDD-HHMMSS.zip, using the time in its name to choose the export for this report. The folder is %LOCALAPPDATA%\NX-Remote-Play\Diagnostics; you can paste that path into File Explorer’s address bar if it did not open.

Attach the ZIP, rather than only a screenshot of the export notice. It contains the support report, app logs and recent connection traces.

Android, Android TV and Google TV

  1. Reproduce the problem, then end the streaming session and return to the NX Remote Play start screen.
  2. Open Settings → About → Export logs.
  3. Wait for Logs saved to Downloads/NX-Remote-Play.
  4. Open your device’s file manager and go to Downloads → NX-Remote-Play. The manual export is named NX-Remote-Play-logs-export-<timestamp>.zip. Choose the file created for this report.
  5. On a TV, copy the ZIP using your usual file-transfer method to a phone or computer where you can attach it to GitHub.

The same folder can also contain automatic exports. Use the file from the problem session:

The timestamp placeholders above are numbers in the actual filenames; they are not the Switch’s Session ID or Password. The Android ZIP does not include the Switch’s logs.

This beta’s built-in log export needs Android 10 or later. On Android 7–9, the app keeps private logs but cannot export them through this button. Report the Android version and the export message, and attach the host Switch’s logs and any Windows or browser logs involved. Do not clear app data to try to make the export work.

Web player, including iPhone and iPad

  1. Reproduce the problem and keep the player page open. Export before refreshing or closing the page: its log is kept only while that page is open.
  2. Open ☰ Menu → Export logs. If joining failed, use Export logs on the join screen instead.
  3. Save NX-Remote-Play-web-log-YYYYMMDD-HHMMSS.txt (the filename uses UTC). Your browser either downloads it or opens a share sheet. On iPhone or iPad, choose Save to Files if offered, then choose a folder you can find again.
  4. Collect the Windows app’s ZIP and the host Switch’s text file too. They help show what happened before the picture reached the browser.

Review the files before uploading

GitHub issues and their attachments are public. Open the exported text files and the files inside each ZIP before attaching them. Logs can include network addresses, device details or identifiers. Keep your originals privately; if anything needs removing, make a copy, remove those details and ZIP the reviewed files again.

Do not upload your whole SD card or configuration folders, passwords, Session ID, owner keys, or private browser-sharing links. Use the exported logs and describe any information you removed.

Attach the logs to a GitHub issue

  1. Sign in to GitHub and open NX Remote Play’s Issues page. Search for the same problem first. If an issue already covers it, add your details and logs in a comment there.
  2. Otherwise choose New issue and give it a short title describing the problem, such as “Android audio stops after returning from HOME”.
  3. Describe the steps to reproduce it, what you expected and what actually happened. Include the app version on each device, Switch model and firmware, viewer device and operating-system version, and whether you used USB, the local network, the internet or browser/Bridge Mode. Give the time of the problem and your time zone, and identify which log came from each device.
  4. Drag the reviewed ZIP or TXT files into the issue’s description, or use the attachment control below the text box to select them. On a phone, select the files from Downloads or Files.
  5. Wait for each upload to finish and for its attachment link to appear in the description. Then submit the issue. For an existing issue, wait for the links before posting your comment.

Do not paste a long log into the description instead of attaching the file. A screenshot or short recording can help show the problem, but include the logs as well when you can. If an export fails, report the exact message and attach the logs you could collect from the other devices.