Repository navigation
Releases
NS2Bench v0.0.20
- Several consoles, safer:
- When NS2Bench starts with several consoles, it asks which one the controller is plugged into, since the cable may have moved while it was closed.
- Every action that can press a button (power, the health check, tests, sequences) only goes to the console the controller is on.
- A test or sequence stops if the controller is moved while it runs.
- The cable-move check no longer goes off when a console just sleeps and wakes, and notices when the board itself restarts.
- Removing a console stops its sound and recording, so its capture card is free again.
- Console names with accents work from agents.
- Two consoles no longer share a capture-format fallback.
- A damaged consoles file is kept aside instead of being overwritten.
- Console strip and settings:
- The picture follows the console you watch, also when the controller moves.
- Changing a console's capture card reconnects its picture.
- One stuck card no longer freezes all the thumbnails.
- A failed save in Settings → Consoles shows what was really saved.
- Keyboard focus on ZL and ZR is fully visible again.
- Security fix: the network helper reads the computer's network adapters more carefully (a macOS netmask record can be shorter than a full address; it was read past its end). Flagged by GitHub code scanning.
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/
macOS first install: if macOS says Apple could not verify the .dmg, run xattr -dr com.apple.quarantine ~/Downloads/NS2Bench-*.dmg in Terminal, or click Open Anyway in System Settings → Privacy & Security. NS2Bench is signed but not notarized. Updates from inside the app don't need this.
Windows: if SmartScreen says it protected your PC, choose More info → Run anyway.
NS2Bench v0.0.18
- Several consoles, now as live pictures. Under the console, each console has a small live picture with its name and colour, and 🎮 on the one the controller is plugged into. Click one to watch it big, or + Add console.
- New top buttons. ZL, L, R and ZR are spread evenly along the top and reach halfway over the screen. Prefer them meeting in the middle? Settings → Appearance → Top buttons → Full span. Nothing covers the screen any more.
- Setup guide: how input devices connect. What a Linux board, a Pico and a CH9329 each need to reach the console and the computer, and why a Linux board like the Luckfox is the recommended one.
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/
macOS first install: if macOS says Apple could not verify the .dmg, run xattr -dr com.apple.quarantine ~/Downloads/NS2Bench-*.dmg in Terminal, or click Open Anyway in System Settings → Privacy & Security. NS2Bench is signed but not notarized. Updates from inside the app don't need this.
Windows: if SmartScreen says it protected your PC, choose More info → Run anyway.
NS2Bench v0.0.17
- Several consoles on one bench. Give each console a name, a model (Switch 2 or Switch 1), its own capture card and network address. All their pictures run at once.
- A console bar above the picture switches between them. Screenshots, clips, screen reading and tests work on the console you're watching.
- They can share one controller: 🎮 shows which console it's plugged into, and buttons only ever go there. Move its cable and click I moved the controller to …. If NS2Bench sees the cable move without being told, it pauses input and asks.
- The board switches to the right controller mode for each model (Switch 2: Pro Controller; Switch 1: standard).
- Set it up in Settings → Consoles. Agents name a console with
console(MCP) or?console=(API), andlist_consoleslists them. A single console works exactly as before.
- Safer offline network. NS2Bench can no longer hand out addresses on your home network, even if a settings file goes missing. The leak watch keeps checking while the network helper is stopped, and says so.
- Signed downloads for the board, Pico and network helper, like app updates.
- Fixes:
- A mouse button no longer stays held after the controller disconnects mid-click.
- With the app and a browser tab both open, one no longer lets go of buttons the other holds.
- Windows: serial input no longer stutters, and flow-control settings left by other programs are cleared.
- A hardware video encoder that doesn't work on this computer no longer stops the picture.
- The × on messages works again while Settings is open.
- The shared network setup picks the right network adapter by itself.
- Pro Controller mode no longer reports success when the board couldn't set it up.
- The controller drawing's L/ZL and R/ZR buttons are wider and sit closer to the middle.
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/
macOS first install: if macOS says Apple could not verify the .dmg, run xattr -dr com.apple.quarantine ~/Downloads/NS2Bench-*.dmg in Terminal, or click Open Anyway in System Settings → Privacy & Security. NS2Bench is signed but not notarized. Updates from inside the app don't need this.
Windows: if SmartScreen says it protected your PC, choose More info → Run anyway.
NS2Bench v0.0.16
- Keep consoles offline on your home Wi-Fi, with no extra hardware. New in Settings → Network: Shared home network.
- Pick your computer's network adapter from a list, enter the consoles' addresses, and NS2Bench shows exactly what to type on each console.
- Each console's gateway is its own address, so nothing leaves your network, by name or by IP address.
- NS2Bench answers only the connection test, so consoles say they're connected. Every other name is refused, Nintendo's included, and only the consoles you list get any answer.
- Leak watch: if a console is on your network but stops using NS2Bench (for example after a reset put it back on automatic settings), NS2Bench warns you.
- Step-by-step guide with a diagram: setup guide, section D.
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/
macOS first install: if macOS says Apple could not verify the .dmg, run xattr -dr com.apple.quarantine ~/Downloads/NS2Bench-*.dmg in Terminal, or click Open Anyway in System Settings → Privacy & Security. NS2Bench is signed but not notarized. Updates from inside the app don't need this.
Windows: if SmartScreen says it protected your PC, choose More info → Run anyway.
NS2Bench v0.0.15
- Windows: NS2Bench closing by itself. Some people saw NS2Bench find the capture card and then close with no message.
- It now has more room to run on Windows.
- If it still closes, it leaves a crash file saying why, and the diagnostics report includes it. Please send us that report.
- Updates are signed. Every update is now signed by NS2Bench's release key, and the app installs nothing whose signature doesn't match. It also refuses an older version offered under a newer number.
- No more stuck buttons:
- If the page goes quiet while you hold a button (a laptop going to sleep, Wi-Fi dropping), NS2Bench lets go within a few seconds.
- "Release everything" also lets go of mouse buttons.
- A test or sequence that stops partway releases what it was holding.
- Two fingers on the same on-screen button no longer release it early.
- Live view:
- Smoother and lighter: no extra work after reconnecting, and no decoding while the tab is hidden.
- The first frame after connecting is no longer dropped.
- Reconnecting slows down while the engine is away instead of retrying every second.
- Sound comes back after a dropped connection on macOS and Safari instead of staying silent.
- Faster and steadier capture:
- Frames are handled with less copying and less scanning.
- Changing video settings waits for the card to be released, so Windows no longer reports it as busy.
- Screen-change checks are about 40% faster on 4K.
- Reading the screen (OCR) gives up after 30 s instead of waiting forever, and finds Tesseract on Windows even when it isn't on PATH.
- Board (NS2Bench Bridge):
- Pro Controller mode stays on while the console is asleep. It no longer switches back to the standard controller, or saves that switch, without asking.
- Restarting the Bridge no longer leaves two copies running.
- Slow replies no longer hold up the controller.
- The recovery script keeps going when you run it over ADB.
- Serial and CH9329:
- Windows sets fast serial speeds such as 921600 properly.
- The CH9329 pointer no longer lags behind fast mouse moves.
- A stuck CH9329 adapter no longer freezes input.
- Privacy: text typed by an agent is no longer written to logs or test reports, only its length.
- Other fixes:
- Adding NS2Bench to an agent no longer removes your existing setup if the add fails.
- A failed clip no longer leaves a broken video in the list.
- The offline network helper works on Linux with IPv6 turned off.
- On macOS, an interrupted update no longer blocks the next one.
- The diagnostics report no longer stalls on long program output.
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/
macOS first install: if macOS says Apple could not verify the .dmg, run xattr -dr com.apple.quarantine ~/Downloads/NS2Bench-*.dmg in Terminal, or click Open Anyway in System Settings → Privacy & Security. NS2Bench is signed but not notarized. Updates from inside the app don't need this.
Windows: if SmartScreen says it protected your PC, choose More info → Run anyway.
NS2Bench v0.0.14
- Updates now work like ps5upload.
- NS2Bench checks at start, every 6 hours, and whenever you open Settings → Updates (before, it checked once a day and the Updates page showed an old answer).
- New versions download in the background and install when you quit NS2Bench, or right away with Restart now.
- Each part can be turned off in Settings → Updates.
- Close to the menu bar / system tray, like ps5upload. Closing the window keeps NS2Bench running in the menu bar (macOS) or system tray (Windows, Linux), so agents, tests and the engine keep working. The icon brings the window back and has Quit. Minimizing to the tray is a separate option (Windows, Linux). Settings → Appearance → Window. Opening NS2Bench again brings back the running window instead of starting a second copy.
- macOS install help: the README, FAQ, setup guide, website download cards and each release page explain the "Apple could not verify… is free of malware" message and how to allow NS2Bench once.
- Fixes from an audit:
- "Restart now" no longer runs the installer twice, and checking again no longer throws away a finished download.
- Windows asks the capture card for its exact frame rate (59.94), opens serial ports COM10 and up, and finds cards that also carry sound.
- A card picked automatically is kept, so its sound pairs with it, and virtual cameras (OBS, webcam apps) are skipped.
- Wake presses the power button only after 6 seconds of no signal, never during a dark loading screen.
- Reports never include a
--tokenvalue. - Opening NS2Bench a second time no longer reports that the last run "ended unexpectedly".
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/
macOS first install: if macOS says Apple could not verify the .dmg, run xattr -dr com.apple.quarantine ~/Downloads/NS2Bench-*.dmg in Terminal, or click Open Anyway in System Settings → Privacy & Security. NS2Bench is signed but not notarized. Updates from inside the app don't need this.
Windows: if SmartScreen says it protected your PC, choose More info → Run anyway.
NS2Bench v0.0.13
- Reports that help fix problems:
- Help → Save bug report now holds everything needed in one zip:
- the system (OS version, WebView2 on Windows, ffmpeg and the other parts NS2Bench uses);
- the capture cards, sound devices and serial ports NS2Bench sees;
- the check;
- the last two days of logs, startup traces and crash reports;
- settings with secrets removed.
- When the window won't open:
ns2bench reportorns2bench-app reportsaves the same report to Downloads. - Crash files: if NS2Bench stops unexpectedly, it saves the reason in
~/.ns2bench/logs/crash-….txt. On Windows it also says where the file is. - After an unexpected close: the next start offers to save a report.
- Safe mode:
ns2bench-app --safestarts without capture, input or sound, for when a device makes NS2Bench crash. - Help → Open logs folder opens the logs folder.
- Help → Save bug report now holds everything needed in one zip:
- Windows:
- when no capture card is chosen, NS2Bench uses the first one it finds instead of failing;
- cards that don't report their sizes still appear in the Video panel;
- ffmpeg no longer opens console windows.
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/
NS2Bench v0.0.12
- The Discord link in the app (Help and About), README and website now says UndefinedLab Discord, the PhantomPtr server shared with ps5upload, and uses a permanent invite.
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/
NS2Bench v0.0.11
- Windows: capture cards show up by name. The Video panel lists every DirectShow capture card (internal PCIe cards such as the Elgato 4K Pro included) with the sizes and frame rates it offers. Before, Windows showed only a raw list you couldn't pick from. Linux lists its /dev/video cards the same way.
- Windows: cards that don't offer exactly 1080p60 start anyway. NS2Bench asks for a size and frame rate the card offers, and if the card still refuses, uses the card's own default (as OBS does).
- Windows: the card's sound is found by name ("Game Capture 4K Pro" and similar), and the Video panel has a Sound picker on Windows and Linux.
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/
NS2Bench v0.0.10
- Network helper (macOS): it now takes requests only from the console's adapter. Before, it also heard other adapters' broadcasts, for example your home router's address requests, and answered them on the console network. Its answers never left the console adapter, but it shouldn't listen anywhere else. After updating, click Settings → Install → Network helper → Update helper.
Downloads: macOS .dmg (Apple silicon: mac-arm64, Intel: mac-x64), Windows -setup.exe (win-x64 or win-arm64), Linux .AppImage or .deb.
Input devices: ns2bench-board-* for Linux USB-gadget boards, ns2bench-pico-*.uf2 for a Raspberry Pi Pico.
Setup guide: https://ns2bench.phantomptr.com/setup/ · FAQ: https://ns2bench.phantomptr.com/faq/