NX2Apple
- 추천0
- GitHub 별7.9K
- 게임라이선스MIT
Switch 게임을 맥·아이폰·아이패드용 앱으로 바꿔 주는 빌더. 에뮬레이터가 아니고 터미널 없이 쓰며, 내가 가진 게임 파일만 써요(MIT)
요약
Switch 게임을 맥·아이폰·아이패드용 앱으로 바꿔 주는 빌더. 에뮬레이터가 아니고 터미널 없이 쓰며, 내가 가진 게임 파일만 써요(MIT)
설명

내 Switch 게임을 아이폰에서.
에뮬레이터가 아닙니다. 터미널도 필요 없습니다. macOS나 윈도우 앱이 클릭 몇 번으로 빌드를 전부 해 줍니다.

🆕 최근 주요 소식
- 윈도우 런처(
NX2Apple-windows-x64.zip): 윈도우에서도 같은 1.2 화면으로 아이폰·아이패드용 IPA를 만듭니다. 엔진 트리를 함께 담아 git이 필요 없고, 첫 실행 설정을 안내하며, 여러 코어로 NSO를 다시 쓰고, 앱 안에서 스스로 업데이트합니다(NX2Apple.exe). - Switch 2 게임: 맥이나 윈도우 런처에서 Switch 2 게임 폴더나
.nup파일을 고르면 됩니다.prod.keys가 필요 없고, 맥·아이폰·아이패드에서 즐길 수 있습니다. - 사용자 지정 터치 컨트롤, 분리 Joy-Con, Steam Controller(2026): 아이폰과 아이패드에서 버튼 크기를 바꾸고, 왼쪽 스틱을 옮기고, 시각적 배치 편집기로 모든 컨트롤을 배치합니다. 물리 컨트롤러는 게임별 또는 전체 버튼 재배치를 지원하고, 맥에서는 블루투스 Joy-Con 한 쌍을 옆으로 든 컨트롤러 둘로 나누며, Steam Controller(2026)도 지원합니다.
- 아이폰과 아이패드를 위한 앱 하나: 모든 게임이 셸 앱 하나에 들어갑니다(AltStore·SideStore용 서명 없는 IPA로 내보낼 수도 있어요). 게임마다 호스트 프레임워크를 따로 지녀서 엔진을 업데이트해도 다시 빌드할 필요가 없습니다. 가로 화면에서는 Cover Flow, 게임별 설정과 모드, 저장 데이터를 지키는 안전한 게임 삭제, 7개 언어를 지원합니다.
- 콘솔 모드: 컨트롤러를 꽂고 Select를 누르거나 처음부터 콘솔 모드로 시작합니다. 라이브러리가 Switch 홈 메뉴처럼 전체 화면이 되고, Home을 2초 길게 누르면 게임이 종료됩니다.
모든 릴리스는 변경 기록에 있습니다.
NX2Apple이란
NX2Apple은 내가 가진 게임 덤프로 닌텐도 Switch 게임을 맥과 아이폰에서 실행합니다. 에뮬레이터가 아닙니다. 게임의 코드가 애플 실리콘에서 그대로 돌고, Metal이 화면을 그립니다. 맥 앱인 런처가 클릭 몇 번으로 빌드(압축 풀기, 코드 다시 쓰기, 셰이더 변환, 묶기)를 마친 뒤, Switch처럼 Play로 시작하는 라이브러리에 게임을 모아 둡니다.

이 프로젝트는 **nxnative**의 커뮤니티 포크입니다. 코드 다시 쓰기, Horizon 호스트, Metal 위의 NVN, 게임별 프로필 같은 실제 작업은 nxnative가 하고, 이 포크는 런처와 몇 가지 패치를 더하며 매일 nxnative를 따라갑니다.
요구 사항
- 애플 실리콘 맥. 런처는 macOS 13 이상에서 열립니다. 빌드에는 iOS SDK가 든 Xcode가 필요하고, NVN 게임은
--allow-other-metal로 빌드하지 않는 한 Xcode 27.2(macOS 26.6 이상)가 필요합니다. 27.2는 앱 스토어의 더 새로운 Xcode가 아니라 애플 다운로드 페이지에서 받으세요. 둘 다 설치했다면 27.2에Xcode-27.2.app처럼 구별되는 이름을 붙입니다. **Settings → Build tools → Choose Xcode…**에서 NX2Apple과 함께 쓸 복사본을 고르세요(외장 드라이브에 있어도 됩니다). 첫 실행 설정 중에는 Set up later를 눌러 Settings로 간 다음, Xcode를 고르고 Run setup again을 누릅니다. Use system Xcode는 맥의 명령줄 선택을 따릅니다(예:sudo xcode-select -s /Applications/Xcode-27.2.app). - 내가 가진 게임 덤프(NSP 또는 XCI)와 내 콘솔에서 직접 뽑은 내
prod.keys. 어떤 것도 포함되거나, 내려받아지거나, 대신 찾아 주지 않습니다. 같은prod.keys하나로 가지고 있는 Switch 게임이 모두 열립니다. 최신 덤프 하나가 모든 정식 출시 타이틀을 다룹니다. Switch 2 게임(게임 폴더 또는.nup파일)은prod.keys가 필요 없습니다. - 아이폰이나 아이패드: iOS 또는 iPadOS 26 이상과 최근 기기. 더 오래된 기기는 시험하지 않았습니다.
앱이 빌드 도구와 파이썬을 스스로 담고 있어서 홈브루도 파이썬 설치도 필요 없습니다. 앱이 대신 설치해 주는 도구는 .NET SDK 10 하나뿐입니다. 런처의 의존성 페이지가 요구 사항을 하나씩 점검하고, 설치할 수 있는 것은 한 번 클릭으로 설치합니다.
설치
- 앱 받기: 최신 릴리스에서
NX2Apple-macOS-arm64.zip을 받아 압축을 풉니다. - 오른쪽 클릭 → 열기로 처음 한 번 열기. 유료 애플 개발자 인증서로 서명한 앱이 아니라서 처음 시작할 때 macOS가 물어봅니다. 그다음부터는 보통대로 열립니다.
- 설정 따라가기. 런처가 빌드에 쓰는 프로젝트를 가져옵니다(설정 페이지의 Download repository 단추,
~/NX2Apple에 얕은 복제. GitHub가 느리면 페이지에 ZIP으로 받는 방법이 나옵니다). 위의 도구를 점검하고 나중에 스스로 업데이트합니다. git은 전혀 필요 없습니다. - 게임 빌드하기. 게임 폴더(또는 기본 게임, 업데이트, DLC,
prod.keys를 하나씩)를 고르고 This Mac 또는 iPhone / iPad를 선택한 뒤 빌드를 누릅니다. 페이지에 실제 단계와 남은 시간이 나오고, 멈춘 빌드는 멈춘 곳에서 이어집니다. iPhone / iPad 대상은 기기에 모든 게임이 들어가는 앱 하나입니다. 런처가 Xcode로 서명해 설치하고 게임을 복사해 넣습니다. 맥과 페어링한 기기가 필요합니다.
터미널에서 손으로 빌드하는 방법은 BUILDING.md에 있습니다.
이미 빌드한 맥 게임 업데이트하기. 라이브러리에서 게임을 고르고 Rebuild를 누릅니다. 업데이트 NSP라면 기본 게임을 고른 채로 Updates & add-on content에서 새 NSP를 고르세요. 같은 출력 폴더에 This Mac 대상으로 빌드합니다. 업데이트는 게임 코드와 데이터를 모두 바꿀 수 있어서, 런처는 새 버전을 빌드하되 가능한 곳은 캐시된 작업을 다시 씁니다. 저장 데이터는 .app 밖의 기존 폴더에 게임의 타이틀 ID로 남아 있고, 같은 라이브러리에서 다시 빌드하면 진행 상황이 유지됩니다.
아이폰·아이패드 앱
iPhone / iPad 대상은 맥 런처처럼 모든 게임을 담는 셸 앱 하나를 만듭니다. 라이브러리에 게임마다 대표 이미지가 보입니다. 세로 화면에서는 고른 게임이 맨 위에 오는 한 칸 목록이고, 가로로 눕히면 Cover Flow가 됩니다. 아이패드는 격자로 보여 줍니다.


- 맥에서 게임 추가. 게임을 iPhone / iPad 대상으로 빌드하면 런처가 앱 안으로 복사해 넣습니다. 앱을 다시 서명해 다시 설치해도 게임 데이터와 저장 데이터가 유지됩니다.
- 플레이. 게임을 골라 Play를 누릅니다. 데이터가 없거나 더 새로운 앱이 필요한 게임은 카드에 그렇게 표시하고 해결 방법을 알려 줍니다.
- 게임별 설정. 설정 단추(컨트롤러에서는 X)가 그 게임의 실행 옵션을 엽니다. Reset은 모든 선택을 기본값으로 되돌립니다.
- 컨트롤러나 키보드. 앱 전체를 컨트롤러로 다룰 수 있습니다. 십자키와 스틱으로 이동하고, A로 고르고, B로 돌아가고, X로 설정을 열고, Y로 컨트롤러 목록을 봅니다. 하드웨어 키보드도 같은 방식으로 됩니다.
- 게임 데이터 폴더. 게임마다 파일 앱에서 고른 폴더(예: 외장 드라이브)나 앱 자체 폴더에서 데이터를 읽을 수 있습니다.
- 클라우드 저장. 게임의 저장 데이터를 맥과 맞추려면 iCloud Drive 폴더를 고릅니다.
- 언어. 앱은 시스템 언어를 따르며, 영어나 중국어 간체입니다.
앱은 iOS 또는 iPadOS 26 이상이 필요합니다. 표지는 맥 런처가 내 게임용으로 캐시해 둔 eShop 배너입니다.
플레이 방법
맥에서는 완성된 게임이 대표 이미지와 함께 라이브러리에 나타납니다. Play를 누르면 시작합니다. Launch options(게임별, 다시 빌드해도 유지)에서 프레임 레이트, 콘솔 모드(독 또는 휴대), 렌더 배율과 업스케일링, 게임 언어, 컨트롤 등을 정합니다. 각 항목의 뜻은 docs/settings.md에 있습니다. 컨트롤러로 게임뿐 아니라 런처도 조작할 수 있습니다.
아이폰에서는 게임이 시작되기 전에 앱이 같은 설정을 보여 줍니다. Play를 누르세요. 터치 컨트롤은 2D와 3D 배치가 있고(위쪽 가운데 단추를 누름), 연결한 컨트롤러(Xbox, PlayStation, Switch Pro, MFi)가 있으면 터치 컨트롤을 대신합니다. 터치, 진동, 모션은 docs/playing.md에 있습니다. 장면이 처음 나올 때 잠깐 끊기는 것은 정상입니다. 앱이 그 장면용 그래픽을 한 번 컴파일해서 기억해 두기 때문입니다. 게임 데이터(romfs.img)는 파일 앱으로 고른 외장 드라이브에 둘 수 있습니다.
게임 언어. 맥에서는 내 맥의 언어가 있는 게임이 그 언어로 시작합니다. Launch options의 Game language 행이 다른 언어를 고를 때까지 그 언어를 미리 선택해 두고, Reset to tested defaults를 누르면 그 값으로 돌아갑니다. 내 맥의 언어가 없는 게임, 다른 언어로 빌드한 게임(LANGUAGE), 그리고 모든 아이폰 빌드는 빌드 언어(기본은 영어)로 시작합니다. 설정 화면에 없는 것은 KEY=VALUE 줄로 된 env.txt(예: DM_LANG=zh-Hans)를 두 곳 중 하나에 씁니다. ~/Library/Application Support/nxnative/<title ID>/env.txt가 우선이고 다시 빌드해도 남습니다. <App>.app/Contents/Resources/dm/env.txt는 앱 자체의 것입니다. 언어 행이 생기기 전에 빌드한 맥 앱은 한 번 다시 빌드해야 그 행이 생깁니다. 아이폰에서는 같은 줄을 Documents/env.txt에 씁니다(DM_FPS_TARGET=30은 배터리를 아끼려고 프레임 레이트를 제한하고, DM_OPMODE=0은 휴대 모드를 고릅니다). 이 파일은 공유 앱 안의 모든 게임에 적용됩니다. 한 게임에만 해당하는 줄(예: 모드의 DM_ROMFS_OVERLAY)은 Documents/games/<title ID>/env.txt에 씁니다. 두 파일이 같은 키를 정하면 게임의 파일이 이깁니다. 모드는 더 쉽습니다. 모드 폴더를 Documents/games/<title ID>/mods/<mod name>/에 넣으세요(RomFS 파일은 그 안의 romfs/ 폴더나 폴더 자체에). 그러면 셸이 그 게임에만 DM_ROMFS_OVERLAY를 설정합니다. 모드가 여럿이면 같은 파일을 바꾸는 곳에서는 이름순으로 먼저 나오는 것이 이깁니다. 같은 키가 두 번 정해지면 순서는 셸 자체 설정, 게임의 env.txt, 게임의 mods/ 폴더, 공유 Documents/env.txt 순입니다.
저장 데이터와 로그. 라이브러리 폴더 안의 맥 게임은 저장 데이터와 로그를 앱 옆(log/<title ID>.log)에 둡니다. 그렇지 않으면 ~/Library/Application Support/nxnative/<title ID>/와 ~/Library/Logs/nxnative/<title ID>.log에 있습니다. 아이폰에서는 파일 앱의 앱 이름 아래 save/와 log.txt(직전 실행은 log.prev.txt)에 있습니다.
버그 신고. 런처나 빌드 문제는 이슈 양식(빌드 문제, 런처 문제)으로 보냅니다. 양식마다 버전과 컴퓨터, Settings > Copy diagnostics, 빌드라면 빌드 로그를 요청합니다. 이유는 CONTRIBUTING.md에 있습니다. 게임이 죽거나, 멈추거나, 느리거나, 이상하게 보이면 seedds/nxnative로 보내세요. 키, 게임 파일, 게임에서 뽑은 어떤 것도 첨부하지 마세요.
게임
147개 게임에 프로필이 있습니다. 상당수는 업스트림에서 아이폰에서 플레이할 수 있다고 보고됐고, 대부분은 아직 폰에서 시험하지 않은 프로필입니다. 몇 개를 소개합니다.
| 게임 | 실행되는 곳 | 상태 | |
|---|---|---|---|
![]() | The Legend of Zelda: Tears of the Kingdom | 맥과 아이폰 | 여기서 확인함: 파일 304,243개, 바이트 단위 검증, 약 17GB |
![]() | Hades II | 맥과 아이폰 | 여기서 확인함 |
![]() | Animal Crossing: New Horizons | 아이폰 | 여기서 확인함: 부드럽게 돌아감 |
![]() | Super Mario Odyssey | 아이폰 | 업스트림에서 플레이 가능으로 보고됨 |
![]() | The Legend of Zelda: Breath of the Wild | 아이폰 | 업스트림에서 플레이 가능으로 보고됨. 1.9.0에서 60fps |
![]() | Mario Kart 8 Deluxe | 아이폰 | 업스트림에서 플레이 가능으로 보고됨 |
**GAMES.md**에는 게임별 설치 크기가 있는 스크린샷 갤러리와, 게임마다 필요한 업데이트 버전이 있는 전체 표가 있습니다. 업데이트 NSP의 표시 버전이 프로필의 버전과 맞아야 하며, 맞지 않으면 빌드가 알려 줍니다.
Switch 2 게임은 엔진에 새로 들어왔습니다. 열한 개에 프로필이 있고, 모두 업스트림이 맥에서 플레이할 수 있다고 표시한 것입니다. 동키콩 바난자, Splatoon Raiders, 파이어 엠블렘 Fortune's Weave, 포켓몬 Pokopia, 하이랄 무쌍: 봉인전기, 마리오 카트 월드, 마리오 테니스 피버, 스타폭스, 요시와 신비한 책, 젤다의 전설 시간의 오카리나, 커비 에어 라이더스입니다. 게임의 파일 폴더(base/, updates/, dlc/)나 .nup 파일을 Builds 페이지에서 고르세요. 이 게임들은 prod.keys가 필요 없습니다. 라이브러리에는 Switch 2로 표시됩니다. 이 포크에서 시험한 것은 동키콩 바난자뿐입니다. 소유자가 맥, 아이폰, 아이패드에서 런처로 직접 빌드해 플레이했고, 맥과 아이폰에서는 문제가 없었으며 아이패드에서는 거의 없었습니다. 나머지 Switch 2 게임은 여기서 시험하지 않았습니다. 자세한 내용은 GAMES.md에 있습니다.
한계
- 프로필이 있는 게임만. 목록에 없는 타이틀은 따로 작업이 필요합니다. 시작점은 다른 Switch 타이틀을 위한 업스트림 안내서인 docs/agents입니다.
- 아이폰에서 큰 게임은 메모리 한도에 걸립니다. Increased Memory Limit 권한이 없으면 iOS가 앱에 약 3.4GB를 주는데, 왕국의 눈물에는 모자랍니다. 앱이 그 권한을 요청하며, AltStore Classic 2.2 이상, Impactor, 개인 팀으로 쓰는 Xcode는 권한이 유지됩니다. 무료 애플 ID로 쓰는 SideStore는 한 번 App ID를 고쳐야 하고, Sideloadly는 권한을 떨어뜨립니다(방법). 전체 측정값은 GAMES.md에 있습니다.
- 서명 없는 런처. 런처는 서명해 주지 않으므로 직접 사이드로딩합니다. 아이폰 앱은 런처가 설치할 때 Xcode가 내 팀으로 서명합니다.
- 내 파일만. 게임 데이터, 펌웨어, 키는 포함되지도 내려받아지지도 않습니다.
- 예전 샤드 아카이브는 더 읽지 않습니다. 처음 나온 아이폰 빌드는 왕국의 눈물을 RomFS 샤드 아카이브(
romfs.idx)로 묶었지만, 지금 빌드는romfs.img하나를 씁니다. 옛 아카이브가 남은 아이폰은 런처로 게임 데이터를romfs.img로 한 번 다시 보내야 합니다.
개발자에게
- 소스에서 빌드: BUILDING.md. 문제를 보고하거나 고치기: CONTRIBUTING.md.
- 도움이 필요한 곳: 마일스톤이 계획이고, 마일스톤에서 이슈를 맡는 방법은 CONTRIBUTING.md에 있습니다.
- 개발자 한두 명을 더 찾고 있습니다. 할 일이 많습니다. 함께하고 싶다면 마일스톤에서 열린 이슈 하나를 맡아 잘 만든 풀 리퀘스트를 보내 주세요. 좋은 작업을 거듭 내놓는 사람에게는 리뷰와 분류를 도와 달라고 요청합니다.
- 이 포크가 업스트림에서 바꾼 것: 엔진(
dm/,scripts/,docs/,ref/)은 여기에 커밋되어 있지 않습니다. 고정한 커밋(.upstream-ref)의 nxnative에 패치 대기열을 더한 것이고, 패치마다 포크가 왜 지니는지 적혀 있습니다.python3 tools/engine.py sync가 이를engine/로 빌드합니다. patches/README.md가 설명하고,python3 tools/engine.py status가 지니고 있는 패치를 보여 줍니다. 매일 도는 작업이 고정점을 옮기고 풀 리퀘스트를 열거나, 더는 맞지 않는 패치를 지목하는 이슈를 엽니다. 이 README의 엔진 문서 링크는 고정한 커밋의 nxnative를 가리킵니다. - 다른 Switch 게임: docs/agents(추출, 바이너리 조사, 띄우기).
- 릴리스 기록: CHANGELOG.md.
감사의 말
커뮤니티 기여자 — 이 프로젝트의 코드는 메인테이너 한 사람의 것이 아닙니다.
- v0lumehi — 맥 프런트엔드의 런처(PR #27, 파일 40개): 대표 이미지가 있는 게임 라이브러리, 게임별 실행 옵션, 실제 진행 스트림, 빌드의 프로세스 그룹 전체를 끝내는 Stop. 맥 앱이 「빌드 양식」에서 Switch처럼 열리는 런처의 첫 버전이 되었습니다.
- m1guelpf(Miguel Piedrafita) — HLE 수정 둘(PR #24, #26): 빠져 있던
EnableAlbumImageTakenNotification과CreateWithAdjustableSystemClock항목, 그리고 그 스냅샷 타입 바이트. 이를 부르는 게임에서는 둘 다 null을 읽게 됐을 것이고, 수정마다 테스트가 딸려 왔습니다.
이 목록에 이름을 올리고 싶다면 기여 안내를 보세요. 전체 로그가 있는 보고와 테스트가 있는 수정이 가장 빠르게 처리됩니다.
커뮤니티 프로젝트 — 이 저장소 밖에서 작성자들이 관리합니다.
- widmonstertony/nxnative(
ios16-pokemon-za-port브랜치) — iOS/iPadOS 16.1~17과 tvOS 호환. 옛 Metal 렌더러 경로를 두었고 A10X 아이패드와 M2 아이패드에서 시험했습니다. 이 포크의 릴리스가 지원하지 않는 기기를 위한 것입니다.
엔진 작업은 전부 다른 사람들의 것입니다. 이 저장소는 그 위에 런처와 패치 대기열을 더합니다.
- nxnative(MIT) — 이 저장소가 바탕으로 삼은 네이티브 실행 도구 모음: NSO 다시 쓰기, Horizon 호스트 계층, Metal 위의 NVN, 게임별 프로필, iOS 셸.
- d2r-mobile(MIT) — nxnative가 자라난 원래의 네이티브 실행 방식.
- Ryujinx(MIT) — Maxwell 셰이더를 SPIR-V로 바꾸는 셰이더 변환기.
- Atmosphère — Horizon 동기화 동작의 기준.
- LibHac —
nx_extract에서 NSP를 읽고 업데이트를 겹칩니다. - SPIRV-Cross — SPIR-V를 Metal 셰이딩 언어로.
- yuzu, deko3d, libvpx, stb_vorbis, libdeflate — 각각이 무엇을 보태는지는 업스트림의 감사 목록을 보세요.
dm/third_party에는 각자의 라이선스와 함께 다른 프로젝트들이 들어 있습니다(목록).
법적 안내
이 프로젝트가 무엇인가. 내가 이미 가진 게임을 위한 빌드 도구입니다. 내가 직접 만든 카트리지와 구매 내역의 덤프를 내 컴퓨터에서 읽어 내 기기용 패키지를 만듭니다. 이 저장소, 앱, 어떤 릴리스에도 닌텐도의 코드, 그림, 글, 데이터, 셰이더, 펌웨어, 키, 그 밖의 저작물은 들어 있지도 배포되지도 않습니다.
할 수 없는 것. 이 파이프라인에는 게임이나 키를 얻을 곳이 없습니다. 사용자의 prod.keys와 사용자의 NSP/XCI 덤프가 필요하며 어떤 서버와도 통신하지 않습니다. 어떤 보호도 우회하거나, 벗기거나, 재배포하지 않습니다. LibHac이 사용자의 덤프를 사용자의 키로 여는 것은 콘솔이 카트리지에 하는 것과 같은 동작입니다.
상표. 닌텐도와 제휴, 후원, 승인 관계가 없습니다. 「Nintendo Switch」와 게임 이름은 Nintendo Co., Ltd.의 상표이고, 다른 모든 상표는 각 소유자의 것입니다.
사용자의 책임. 개인 백업 복사본에 관한 법은 나라마다 다르며, 아예 허용하지 않는 곳도 있습니다. 사는 곳의 법을 알고 따를 책임, 그리고 게임 파일, 키, 그것으로 만든 패키지를 절대 배포하지 않을 책임은 사용자에게 있습니다. 이 프로젝트의 결과물은 내 하드웨어에서 개인적으로만 쓰도록 만든 것입니다. 게임이 마음에 들면 사세요.
삭제 요청. 이 저장소의 무엇이든 권리를 침해한다고 생각하면 이슈를 열거나 메인테이너에게 직접 연락하세요. 타당한 요청은 내용 삭제나 저장소 삭제까지 즉시 처리됩니다.
보증 없음. 소프트웨어는 LICENSE의 라이선스에 따라 「있는 그대로」 제공되며(이 포크가 업스트림 것에 더한 부분은 감사의 말을 보세요), 명시적이든 묵시적이든 어떤 종류의 보증도 없습니다. 사용에 따른 위험은 사용자가 집니다.
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0





