직접 덤프한 Switch 게임을 아이폰·아이패드에서 네이티브로 실행되게 변환하는 macOS 앱
중간맛 분석
NX2Apple은 업스트림 프로젝트 nxnative를 기반으로, 사용자가 직접 추출한 Nintendo Switch 게임 파일을 Apple Silicon 아이폰·아이패드에서 네이티브로 돌아가게 변환하는 macOS 도구입니다. GUI 앱(NS Port Builder)은 기본 게임·업데이트·DLC·prod.keys 네 가지 입력을 받아 필요한 의존성을 자동 감지·설치하고, 빌드 단계별 진행률을 보여준 뒤 설치 가이드까지 안내합니다. 커맨드라인으로도 동일한 스크립트(scripts/build_ipa_from_nsp.py, dm/tools/romfs_arc.py)를 직접 실행할 수 있습니다. 이 포크의 핵심 추가 기능은 ROMFSARC 아카이브 포맷으로, Tears of the Kingdom처럼 30만 개가 넘는 파일로 구성된 게임을 127개 샤드로 묶어 iOS 설치 실패(PackageExtractionFailed) 문제를 해결합니다. 빌드가 중단되어도 추출·DLC·모듈 재작성·셰이더 컴파일 단계가 재사용되어 이어서 진행되며, 매일 GitHub Actions가 업스트림 변경을 자동으로 반영합니다. 58개 게임 프로필이 포함되어 있지만 이 포크에서 처음부터 끝까지 검증된 게임은 3개뿐이고, 나머지는 업스트림 기준 보고 사례입니다. 사용 전 macOS + Xcode 빌드 환경, 본인 소유 콘솔에서 추출한 prod.keys, 본인이 덤프한 게임 NSP 파일이 반드시 필요합니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 자신이 소유한 Switch 카트리지나 eShop 구매본을 덤프해 아이폰에서 네이티브로 실행하려는 사용자
- Tears of the Kingdom처럼 30만 개 이상의 파일로 구성된 대용량 게임을 iOS 설치 실패(PackageExtractionFailed) 없이 옮기려는 사용자
- 터미널 명령어 대신 GUI로 빌드 과정을 진행하고 싶은 비개발자 사용자
핵심 기능
대안 대비 차별점
nxnative 업스트림 엔진을 그대로 쓰면서, 대용량 RomFS를 설치 가능한 샤드 아카이브로 바꾸는 기능과 터미널 작업을 대체하는 GUI를 추가하고 매일 업스트림 변경을 자동 반영하는 포크라는 점이 다릅니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- macOS (Xcode 설치 필요)
- Homebrew 도구(xcodegen, zstd, spirv-cross, dotnet-sdk)
- Python3 및 lz4/capstone/fonttools/backports.zstd 패키지
- 본인 소유 Nintendo Switch 콘솔에서 추출한 prod.keys 키 파일
- 본인이 덤프한 게임 NSP 파일(카트리지 또는 eShop 구매본)
- Apple Silicon 기반 아이폰/아이패드(설치 대상 기기)
바로 시작하기
- 저장소를 클론합니다
git clone https://github.com/<you>/NX2Apple.git
cd NX2Apple
- 빌드에 필요한 도구와 패키지를 설치합니다
brew install xcodegen zstd spirv-cross
brew install --cask dotnet-sdk
python3 -m pip install lz4 capstone fonttools backports.zstd
- GUI 앱을 실행합니다 (또는 빌드된 앱을 더블클릭)
cd frontend && swift run
- (CLI 방식) 본인 소유 게임의 NSP와 prod.keys로 IPA를 빌드합니다
python3 scripts/build_ipa_from_nsp.py ~/Games/Hades2 -k ~/keys/prod.keys
- RomFS 폴더를 아이폰 설치용 샤드 아카이브로 패킹합니다
python3 dm/tools/romfs_arc.py pack <RomFS dir> <output base> --shard-mib 200
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try LNPANDY/NX2Apple
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「모바일」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/LNPANDY/NX2Apple)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기