한국어
Switch2Bridge는 무엇이고 Mac에서 무엇을 하나요?
이 앱은 완전히 무료입니다. 계정을 만들 필요가 없습니다. 구독도, 번거로운 다운로드도 없고, 잠긴 기능도 없습니다. Apple 실리콘에 최적화되어 있습니다.
GitHub에 switch2bridge-macos로 올라 있는 Switch2Bridge는 MIT 라이선스로 Python으로 쓴 무료 메뉴 막대 앱이며, Bluetooth Low Energy로 Switch 2 Pro Controller에 연결해 버튼과 스틱을 키 입력으로 바꿉니다. Ryujinx 에뮬레이터용으로 만들어졌고, Dolphin과 Cemu에 진짜 아날로그 스틱을 주는 DSU 서버도 실행합니다. 공식 readme는 이것이 드라이버가 아니라고 분명히 말합니다. macOS는 여전히 컨트롤러를 나열하지 않고, 컨트롤러를 읽는 게임은 이것을 보지 못합니다.
저는 Pro Controller 2를 스스로 읽는 무료 Mac 앱 InputConfig를 만듭니다. USB-C 케이블로, 그리고 실험적 설정으로 Bluetooth로 읽어 모든 앱에서 키, 마우스, 매크로로 바꿉니다. Switch2Bridge를 시험해 보지 않았으므로, 아래의 그것에 대한 모든 내용은 2026년 10월 27일에 읽은 readme에서 왔습니다.
단계
- 찾은 프로젝트가 mlstr0m/switch2bridge-macos인지 확인합니다. 같은 이름을 쓰는 다른 프로젝트가 있습니다.
- Releases 페이지에서 디스크 이미지를 받아 앱을 응용 프로그램으로 옮기고, 공증되지 않았으므로 시스템 설정, 개인정보 보호 및 보안에서 한 번 허용합니다.
- 시작할 때 손쉬운 사용을 허용하고, Connect Controller를 처음 클릭할 때 Bluetooth를 허용합니다.
- Ryujinx에서는 Input Device를 Keyboard로 설정하고 키를 맞추거나, Dolphin이나 Cemu를 DSU 서버로 향하게 합니다.
- 다른 앱이나 케이블로 쓸 때는 종료하고 대신 InputConfig를 사용합니다.
찾은 Switch2Bridge가 어느 것인지 확인하기
이름을 공유하는 서로 무관한 프로젝트가 여럿 있고, 그중 하나만이 사람들이 보통 뜻하는 Python 메뉴 막대 앱입니다. 2026년 10월 27일에 GitHub에서 찾은 것들은 이렇습니다.
| 저장소 | 무엇인가 | 실행 환경 |
|---|---|---|
| mlstr0m/switch2bridge-macos | 이 페이지의 Python 메뉴 막대 앱: Bluetooth Low Energy, 키 입력, DSU 서버. MIT 라이선스. 최신 릴리스 1.4.0은 2026년 9월 28일에 나왔습니다. | macOS 13 Ventura 이상 |
| SwonDev/Switch2Bridge | CrossOver 같은 Wine에서 실행되는 Windows 게임에 Pro Controller 2를 공급하는 Swift 백그라운드 앱. 스페인어 readme는 네이티브 Mac 게임은 지원되지 않는다고 말합니다. | macOS 15 Sequoia 이상 |
| gessecarneiro/Switch2Bridge | USB로 Pro Controller 2를 위한 Windows 프로그램. | Windows, Mac이 아님 |
aureliendesert/switch2bridge-macos로 가는 오래된 링크는 다운로드가 있는 mlstr0m/switch2bridge-macos와 같은 저장소로 이어집니다. 다운로드가 나온 저장소를 확인하세요. 이름만으로는 어느 프로그램인지 알 수 없습니다.
읽는 것과 보내는 것 알기
Switch2Bridge는 시스템 설정에서 페어링하지 않고 Bluetooth Low Energy로 컨트롤러에 직접 연결하며, 연결할 때 컨트롤러의 공장 스틱 보정을 읽습니다. readme에 나열된 것은 이렇습니다.
- 모든 버튼. 페이스 버튼, D-pad, L, R, ZL, ZR, 스틱 클릭, Plus, Minus, Home, Capture, 새 C 버튼, 뒤쪽의 GL과 GR 그립 버튼입니다.
- 두 스틱을 키로. 왼쪽 스틱은 W, A, S, D이고 오른쪽 스틱은 I, J, K, L이며, 각 스틱은 여덟 방향으로 줄어듭니다.
- 버튼을 키로. 기본적으로 A는 Z, B는 X, X는 C, Y는 V를 보내고, D-pad는 방향키에, C 버튼은 비어 있습니다.
- 재연결. 컨트롤러가 잠들거나 끊기면 앱이 60초 동안 계속 시도합니다.
- 컨트롤러 여러 개. 컨트롤러마다 앱 사본 하나이며, 각각 자체 매핑 파일로 시작합니다.
키를 바꾸려면 JSON 파일을 편집하고 메뉴 막대 아이콘에서 Reload mappings를 선택합니다.
Finder, 폴더로 이동: Switch2Bridge가 키 매핑을 보관하는 곳.
~/Library/Application Support/Switch2Bridge/mappings.json결과: Finder가 앱이 처음 실행할 때 쓴 파일을 엽니다. 각 버튼이나 스틱 방향은 키 하나를 받습니다.
Mac에 요구하는 것 알기
- macOS 13 Ventura 이상. Python 3.10 이상은 소스 코드에서 실행할 때만 필요합니다.
- macOS가 경고하는 앱. 릴리스는 공증되지 않아서 Gatekeeper가 첫 실행을 막습니다. macOS 15 이상에서는 시스템 설정, 개인정보 보호 및 보안에서 Open Anyway로 허용합니다. macOS 13과 14에서는 앱을 우클릭하고 열기를 선택합니다.
- 손쉬운 사용. 앱이 대신 키를 누르기 때문에 실행할 때 요청합니다.
- Bluetooth. Connect Controller를 처음 클릭할 때 요청합니다. 소스 코드에서 실행하면 Bluetooth 권한은 앱이 아니라 Terminal이나 Python의 것입니다.
손쉬운 사용은 앱이 다른 모든 앱에서 키를 누르게 하므로, 저는 신뢰하는 앱에만 줍니다. 이것은 오픈 소스여서 그것으로 정확히 무엇을 하는지 읽을 수 있습니다. Mac의 보안 보호를 하나도 끄지 않으며, 일부 Switch 2 프로젝트는 그렇다고 말할 수 없습니다.
DSU로 Dolphin과 Cemu에서 아날로그 스틱 쓰기
키 입력은 전부 아니면 전무이므로, 키로 보낸 스틱에는 여덟 방향만 있습니다. DSU, 즉 cemuhook 프로토콜을 받는 에뮬레이터를 위해 Switch2Bridge는 진짜 아날로그 스틱이 있는 컨트롤러를 넘겨주는 작은 서버도 실행합니다. 기본적으로 이 주소에서 듣습니다.
Dolphin이나 Cemu: 추가할 DSU 서버 주소.
127.0.0.1:26760결과: 컨트롤러가 스틱을 포함한 입력 장치로 에뮬레이터에 나타납니다.
- Dolphin. Options, Controller Settings, Alternate Input Sources에서 DSU Client를 켜고 주소를 추가합니다.
- Cemu. 입력 설정에서 같은 주소로 DSUController를 추가합니다.
- Ryujinx. DSU는 모션에만 쓰는데 readme는 Switch2Bridge가 아직 모션을 해독하지 않으므로 0을 보낸다고 합니다. Ryujinx의 버튼과 스틱은 여전히 키를 통합니다.
DSU 쪽에서는 버튼이 위치로 매핑되어 A는 Circle, B는 Cross 등이고, GL, GR, C는 매핑할 곳이 없습니다. Dolphin과 Cemu의 아날로그 스틱은 InputConfig가 하지 않는 일입니다. 키와 마우스 이동을 보내지 DSU 피드를 보내지 않기 때문입니다. Dolphin이 직접 읽는 컨트롤러는 Mac의 Dolphin 컨트롤러 설정에서 다룹니다.
한계 알기
- Pro Controller 2만. readme는 다른 컨트롤러를 꼽지 않으므로, Joy-Con 2나 Switch 2용 GameCube 컨트롤러를 위한 도구가 아닙니다.
- Bluetooth만. USB로는 컨트롤러가 시작 시퀀스를 받을 때까지 조용하며, readme는 그것이 아직 Switch2Bridge에 들어 있지 않다고 합니다.
- Mac 게임 컨트롤러가 아님. 시스템 설정, 게임 컨트롤러에 나열되지 않으며, Steam을 포함해 macOS를 통해 컨트롤러를 읽는 게임은 이것을 보지 못합니다.
- 패드가 아니라 키. 컨트롤러만 받는 게임은 무시하고, 키로 보낸 스틱은 절반 밀기를 잃습니다.
Mac용 다른 Switch 2 도구와 비교하기
Switch 2 컨트롤러는 자체 프로토콜을 쓰는 소프트웨어를 통해서만 Mac에 닿습니다. 다음은 제가 살펴볼 프로젝트들이며, 2026년 10월 27일에 각 프로젝트의 자체 페이지가 말하는 것입니다. 어느 것도 시험하지 않았습니다.
| 도구 | 컨트롤러 | 연결 | 다른 앱이 보는 것 | 요구하는 것 |
|---|---|---|---|---|
| switch2bridge-macos | Pro Controller 2 | Bluetooth | 키 입력, 그리고 에뮬레이터용 DSU 피드 | 손쉬운 사용, Bluetooth, 공증되지 않은 앱 |
| Peterksharma/switch2mac, Finally the Controller Works라는 앱 | Pro Controller 2, 단독이거나 쌍인 Joy-Con 2, GameCube 컨트롤러 | Bluetooth, 한 번에 최대 네 개 | readme에 따르면 진동이나 모션 없이 모든 앱이 읽는 표준 게임 컨트롤러 | Apple 실리콘의 macOS 15 이상, Bluetooth. 베타로 표시, 서명 및 공증됨 |
| AlexmChadwick/Switch-2-Controller-Helper | Pro Controller 2 | Bluetooth | 유료 Apple 개발자 자격이나 SIP를 끈 경우에만 가상 게임패드, 아니면 키 입력 | Xcode에서 빌드합니다. 제작자는 진행 중인 작업이라고 부릅니다 |
| procon2-mac | Pro Controller 2 | USB, 무선은 더 필요 | 케이블로는 Steam과 다른 앱이 읽을 수 있음 | 무선에는 유료 개발자 계정으로 빌드하고 서명하는 DriverKit 확장이 필요 |
| InputConfig | Pro Controller 2, 단독의 각 Joy-Con 2, GameCube 컨트롤러 | USB-C, 그리고 설정으로 Bluetooth | 키, 마우스, 매크로, 시스템 기능 | 손쉬운 사용, 무선 설정에는 Bluetooth. 실험적이고 Bluetooth 부분은 아직 컨트롤러로 확인하지 못함 |
게임이 컨트롤러를 컨트롤러로 보게 하는 것이 필요하다면, switch2mac의 readme는 그것이 정확히 자기 일이라고 하고 Switch2Bridge는 아니라고 분명히 말합니다. 각각에 대한 더 많은 내용은 Mac의 Switch 2 Pro Controller 페이지에, 두 JoyCon2Mac 프로젝트는 Mac의 Joy-Con 2에 있습니다.
InputConfig로 Switch 2 Pro Controller 읽기
InputConfig는 컨트롤러와 직접 통신하므로 드라이버나 확장이 필요 없고 Mac의 보안에 대해 아무것도 바꾸지 않습니다. 전부 앱에서 실험적으로 표시되어 있는데, 컨트롤러를 손에 쥐지 않고 커뮤니티가 공개한 시작 시퀀스와 리포트 레이아웃으로 만들었기 때문입니다.
1단계: 연결하기
- 사용자: 먼저 Switch2Bridge를 종료해서 앱 하나만 컨트롤러와 통신하게 합니다. 그런 다음 컨트롤러를 데이터를 전달하는 USB-C 케이블로 Mac에 꽂고 InputConfig를 엽니다. 대신 Bluetooth로 하려면 설정, Devices를 열고 Connect Switch 2 Pro, GameCube and Joy-Con 2 controllers over Bluetooth를 켠 다음, 불빛이 쓸고 지나갈 때까지 컨트롤러의 싱크 버튼을 누릅니다. 처음에는 macOS가 InputConfig가 Bluetooth를 쓸 수 있는지 물으니 허용하세요.
- InputConfig: 컨트롤러가 기다리는 시작 명령을 보내거나, 앱이 실행되는 동안 Bluetooth로 찾아서 다른 패드처럼 읽습니다.
- 확인: 플레이어 불빛 1이 켜지고, 컨트롤러가 사이드바 맨 위에 Switch 2 Pro Controller (Experimental)로 나타납니다.
2단계: 각 컨트롤에 역할 주기
- 사용자: 프리셋을 열고, 행을 추가하고, 스캔(Scan)을 누르고, 버튼을 누른 다음 키, 클릭, 매크로를 고릅니다.
- InputConfig: 모든 페이스 버튼, 두 스틱, D-pad, L, R, ZL, ZR, Minus, Plus, Home, Capture, C, GL, GR을 읽고, 1.8부터는 모션 센서와 컨트롤러에 저장된 스틱 보정도 읽습니다.
- 확인: 레이아웃에 의지하기 전에 Live Visualizer를 연 채로 각 컨트롤을 누르세요.
앱은 Bluetooth 설정을 Experimental: not yet checked on a controller로 표시하므로, 케이블이 여전히 더 확실한 길입니다. Ryujinx에는 InputConfig가 Input Device를 Keyboard로 두고 키보드 키를 대신 보낼 수 있으며, Mac의 Ryujinx 컨트롤러 설정이 바인딩할 기본 키와 도착하는지 확인하는 방법을 나열합니다.
여기서 InputConfig가 할 수 없는 것
- Mac 게임 컨트롤러로 만들기. macOS는 여전히 Pro Controller 2를 읽지 않으므로, macOS를 통해 컨트롤러를 읽는 게임은 InputConfig로도 이것을 보지 못합니다.
- DSU 피드 보내기. Dolphin이나 Cemu 안의 아날로그 스틱은 Switch2Bridge의 일입니다.
- ZL과 ZR을 아날로그로 읽기. 켜짐이나 꺼짐으로 읽힙니다.
- 진동과 NFC. InputConfig는 둘 다 사용하지 않습니다.
짧은 요약
- Switch2Bridge. Bluetooth로 Pro Controller 2를 위해 키 입력을 보내는 무료 Python 메뉴 막대 앱으로, Ryujinx용으로 만들어졌습니다.
- 가장 좋은 재주. Dolphin과 Cemu를 위한 진짜 아날로그 스틱의 DSU 서버.
- 한계. 컨트롤러 모델 하나, Bluetooth만, 공증되지 않음, macOS에는 게임 컨트롤러가 아님.
- InputConfig. 케이블이나 실험적 기능으로 Bluetooth를 통한 Pro Controller 2를 모든 앱의 키, 마우스, 매크로에 매핑.
Dolphin이나 Cemu의 아날로그 스틱에는 Switch2Bridge를, 키보드와 마우스를 받는 모든 것에는 InputConfig를 고르고, 한 번에 하나만 실행하세요.
자주 묻는 질문
Switch2Bridge를 실행해도 안전한가요?
MIT 라이선스의 오픈 소스여서 코드를 읽을 수 있고 Mac의 보안 보호를 끄지 않습니다. 공증되지 않아서 첫 실행에 macOS가 경고하고, 키를 누르기 위해 손쉬운 사용을 요청합니다. 시험하거나 감사하지는 않았습니다.
Switch2Bridge가 Joy-Con 2에서 작동하나요?
readme는 Switch 2 Pro Controller만 꼽습니다. Joy-Con 2는 switch2mac의 readme가 나열하고, InputConfig는 실험적 기능으로 각각을 단독으로 읽습니다.
Switch2Bridge에 손쉬운 사용 권한이 필요한가요?
네. 대신 키를 누르기 때문에 실행할 때 손쉬운 사용을 요청하고, Connect Controller를 처음 클릭할 때 Bluetooth를 요청합니다.
InputConfig가 Switch 2 Pro Controller를 읽나요?
네, 실험적 기능으로 1.6부터 USB-C 케이블로, 1.8부터 모션과 함께, 그리고 설정, Devices에서 Connect Switch 2 Pro, GameCube and Joy-Con 2 controllers over Bluetooth를 켜면 1.8부터 Bluetooth로 읽습니다. Bluetooth 부분은 아직 컨트롤러로 확인하지 못했다고 표시되어 있습니다.
Mac이 Switch 2 Pro Controller를 보지 못하는 이유는 무엇인가요?
macOS는 원래의 Switch Pro Controller는 지원하지만 Switch 2 버전은 지원하지 않습니다. USB로는 Mac의 어떤 것도 보내지 않는 시작 명령을 기다리고, Bluetooth로는 Nintendo 자체의 Low Energy 프로토콜을 쓰므로 그것을 쓰는 앱만 읽을 수 있습니다.
한국어 페이지 더 보기
자세한 안내(영어)
글쓴이 소개. Ryleigh Newman은 InputConfig를 개발하고 있습니다. 손을 쓰기가 어려워서 매일 컨트롤러로 Mac을 조작합니다. 이 페이지는 영어에서 번역했습니다. Mac 언어가 한국어로 설정되어 있으면 앱의 주요 버튼과 메뉴가 한국어로 표시되며, 이 페이지는 그 이름에 영어 이름을 괄호로 함께 적었습니다. 앱의 나머지 부분과 사이트의 다른 페이지는 영어입니다.
이 페이지의 다른 언어: English, Deutsch, Español, Français, Italiano, 日本語, Polski, Português, Русский, ไทย, 繁體中文, 简体中文
무료. macOS 14 이상. 계정이 필요 없고, 데이터는 Mac 밖으로 나가지 않습니다. 소스 코드는 GitHub에 있습니다.