NS-USBloader

NSP 업로더 (Awoo / Goldleaf 호환)

Awoo Installer 호환 애플리케이션에는 USB와 네트워크 모두로 NSP를 전송할 수 있고, Goldleaf에는 USB로 전송합니다. 드래그 앤 드롭 또는 ‘Select NSP files’ 버튼으로 여러 파일을 한 번에 추가할 수 있고, 체크박스로 전송 대상 파일을 선택합니다. Goldleaf v0.6.1 이상에서는 ‘Explore content → Remote PC (via USB)’에서 HOME:/와 VIRT:/ 드라이브가 노출되며, VIRT:/는 앱 테이블에 추가된 파일을 반영합니다.

RCM 페이로드 인젝터

Hekate, LockPick_RCM 등 페이로드 파일을 선택해 RCM 모드인 Switch로 전송합니다. 드래그 앤 드롭을 지원하며 페이로드에 대한 일부 유효성 검사가 앱 내부에서 수행됩니다.

파일 분할 및 병합

‘Folder with arrows and zeroes’ 탭에서 ‘Split’ 또는 ‘Merge’를 선택해 대용량 NSP/XCI/NSZ/XCZ 파일을 분할하거나, 분할된 파일을 하나로 병합할 수 있습니다. 드래그 앤 드롭도 지원합니다.

네트워크 전송 및 설정

‘Gears’ 탭에서는 네트워크 전송과 관련된 호스트 IP·포트, 자동 업데이트 확인, Goldleaf 파일 필터링 등을 설정할 수 있습니다. ‘Don’t serve requests’ 옵션을 켜고 원격 경로를 지정하면 Awoo가 해당 위치에서 직접 파일을 가져오도록 안내합니다.

CLI (명령행 인터페이스)

GUI 없이 JAR 파일을 직접 실행해 동작시킬 수 있습니다. --help로 옵션 목록을 확인하고, Awoo 네트워크 모드(-n), Awoo USB 모드(-t), Goldleaf 모드(-g), RCM 페이로드 전송(-r), 파일 분할(-s)/병합(-m) 등을 수행할 수 있습니다.

Windows

설치 프로그램(Nullsoft 인스톨러)을 실행하거나 winget install --id developersu.ns-usbloader --exact로 설치합니다. 앱을 처음 실행한 뒤 톱니바퀴 아이콘에서 ‘Download and install drivers’를 눌러 USB 드라이버를 설치합니다.

macOS

다운로드한 .jar 파일을 더블 클릭해 실행합니다. Mojave 이후 사용자용 JAR과 Apple Silicon(M1)용 -m1.jar 파일이 별도로 제공됩니다. Apple Silicon에서는 터미널에서 brew install libusb를 실행해 libusb를 수동 설치해야 하며, macOS에서는 JDK 19 사용이 권장됩니다.

Linux / Raspberry Pi

JRE/JDK 8u60 이상을 설치한 뒤 java -jar /path/to/NS-USBloader.jar로 실행합니다. 일반 사용자 권한으로 Switch를 사용하려면 해당 VID/PID(057e:3000, 0955:7321)에 대한 udev 규칙을 추가하고 udevadm control --reload-rules && udevadm trigger로 적용합니다. Raspberry Pi에서는 sudo apt install default-jdk openjfx로 JDK와 JavaFX를 설치합니다. HiDPI 환경에서는 java -Dglass.gtk.uiScale=150% -jar application.jar 형태로 스케일링을 지정할 수 있습니다.

Q. Java가 없는 환경에서 어떻게 실행하나요?

JRE/JDK 8u60 이상을 설치해야 합니다. OpenJDK와 Oracle JRE 모두 호환되며, macOS와 Linux에서는 JDK 17이 권장됩니다.

Q. Windows에서 USB 드라이버 관련 오류가 발생합니다.

Windows 설치 프로그램을 사용하면 libusbK 드라이버가 자동으로 설치됩니다. 수동 설치가 필요하면 앱 설정의 드라이버 설치 옵션을 이용하거나 Zadig로 libusbK 드라이버를 설치할 수 있습니다.

Q. macOS Mojave 이전 버전에서는 어떻게 실행하나요?

‘-legacy’ 접미사가 붙은 JAR 파일을 사용하세요. Apple Silicon Mac은 별도로 -m1.jar 파일을 사용하고 Homebrew로 libusb를 설치해야 합니다.

Q. Linux에서 root 계정이 아니면 동작하지 않나요?

README에 안내된 udev 규칙을 등록해 일반 사용자 권한으로 Switch를 사용할 수 있습니다. NSP 전송용(057e:3000)과 RCM용(0955:7321) 두 규칙이 별도로 필요합니다.

화면으로 보는 주요 기능

NS-USBloader v5.2 시작 화면

NS-USBloader v5.2의 시작 화면입니다. 상단에는 'Aw00'과 'NET' 드롭다운 메뉴, 'NS IP: 192.168.1.150' 입력란이 있습니다. 좌측에는 'RCM', 설정, 채팅 아이콘으로 구성된 네비게이션 바가 있습니다. 중앙에는 'NS-USBloader simply works everywhere' 로고가 표시되며, 그 아래에는 'Select files', 'Select split NSP', 'Upload to NS' 버튼이 있습니다. 테이블 헤더로 'Status', 'File name', 'Size', 'Upload?'가 있습니다.

NS-USBloader v4.0 페이로드 관리 화면

NS-USBloader v4.0의 'Fusée Gelée RCM' 화면입니다. 'Payload:' 섹션에 'hekate.bin'과 'Lockpick_RCM.bin' 파일이 나열되어 있으며, 'hekate.bin'은 선택되어 있습니다. 각 파일 옆에는 폴더 아이콘과 삭제 아이콘(크로스)이 있습니다. 하단에는 'Inject payload' 버튼이 있습니다.

NS-USBloader v5.1 파일 분할 및 병합 도구

NS-USBloader v5.1의 'Split & merge files tool' 화면입니다. 왼쪽에는 'Something about the mortgage and animals in the middle of ocean.nsp', '100 y.o. guy wakes up and tries to figure out what is happened.nsp' 등의 NSP 파일 목록이 있습니다. 오른쪽에는 'Split'과 'Merge' 라디오 버튼, 'Select File', 'Save to:' 경로(현재 'C:UsersloperDesktop') 및 'Change' 버튼, 'Convert' 버튼이 있습니다.

NS-USBloader v5.1 설정 화면

NS-USBloader v5.1의 'Main settings' 화면입니다. 'Language'는 'English (en_US)'로 설정되어 있고, 'OK' 버튼이 있습니다. 'Auto check for updates' 옵션과 'Select folder with ROM files instead of selecting ROMs individually.' 옵션이 있습니다. 'GoldLeaf' 섹션에는 'Show only *.nsp in GoldLeaf.' 및 'GoldLeaf version v0.8-0.9' 드롭다운이 있습니다. 'Aw00 Installer and compatible' 섹션에는 'Allow XCI / NSZ / XCZ files selection for Aw00', 'Always validate NS IP input.', 'Expert mode (NET setup)' 옵션이 있으며, 'Auto-detect IP'와 'Randomly get port'는 선택되어 있습니다. 'Host IP:port/extra' 입력란에는 '0.0.0.0 : 6042'가 표시되어 있습니다.