Troubleshooting

Troubleshooting

The 3DS isn't found / won't connect

• Is the homebrew running? NTR-HR (or HzMod) must be launched and running on the 3DS — not just installed. This is by far the most common cause. See Installation.
• Same network? The 3DS and PC must be on the same LAN / Wi-Fi. Guest networks and "AP isolation" block them from seeing each other.
• Right IP? Check the IP the 3DS shows in the NTR/HzMod menu and match it exactly. Use Find to auto-detect.
• Firewall. Allow 3DSnickerStream through your PC firewall (UDP, default port 8001).
• Port. If you changed the Listen port, make sure it matches what NTR expects (default 8001).

Connected, but the picture is black / stuck on "Connecting…"

• Give it a few seconds — NTR re-inits the stream on connect, so the first frame can lag.
• Try a different Compression Formats — start with JPEG (Reliable Stream), or fall back to JPEG Compat (UDP).
• Lower Quality / raise QoS, or pick a framerate preset — a congested Wi-Fi can starve a high-quality stream. See Quality and Settings.
• Toggle Priority screen (P) if only one screen is updating.

Low or unstable framerate

• The framerate ceiling is set by the 3DS encoder and your Wi-Fi, not the PC. Heavy scenes will dip — this is normal.
• Use JPEG (Reliable Stream, Delta) to send less per frame, or a framerate preset.
• 5 GHz Wi-Fi (or moving closer to the router) helps a lot. Uncompressed (UDP) is inherently heavy — prefer a Reliable-Stream mode for smoothness.

Tearing / stale bands

• Expected on Uncompressed (UDP) under packet loss (best-effort UDP). Switch to a Reliable-Stream mode, which retransmits lost packets.

The window hides the stream when I shrink it

• Fixed at v2.3: at a fixed % zoom the picture now scales down to stay visible. If you're on an older build, switch Zoom to Fit, or update to the latest release.

OCR says it needs Tesseract (macOS / Linux)

• Install the system Tesseract: brew install tesseract (macOS) / sudo apt install tesseract-ocr (Debian-Ubuntu) / sudo dnf install tesseract (Fedora). See Copy Text (OCR).

macOS says the app is "damaged" / won't open

• The macOS build is unsigned. Right-click → Open, or clear the quarantine flag: xattr -cr 3DSnickerStream.app. Cleanest of all: build it locally.

Still stuck?

Open an issue on the tracker with your OS, the homebrew + version on the 3DS, the compression format, and what you see.