Polski

Czym jest Switch2Bridge i co robi na Macu?

Pobierz InputConfig z Mac App StoreTa aplikacja jest całkowicie darmowa. Nie trzeba zakładać konta. Nie ma subskrypcji ani skomplikowanych pobrań, a nic nie jest zablokowane. Zoptymalizowana pod Apple Silicon.

Switch2Bridge, publikowany na GitHubie jako switch2bridge-macos, to darmowa aplikacja na pasku menu, napisana w Pythonie na licencji MIT, która łączy się ze Switch 2 Pro Controller przez Bluetooth Low Energy i zamienia jego przyciski i gałki w naciśnięcia klawiszy. Powstała dla emulatora Ryujinx, a uruchamia też serwer DSU, który daje Dolphin i Cemu prawdziwe analogowe gałki. Jej własny readme jasno mówi, że nie jest sterownikiem: macOS nadal nie wymienia kontrolera, a gry czytające kontrolery go nie widzą.

Tworzę InputConfig, darmową aplikację na Maca, która sama czyta Pro Controller 2, przez kabel USB-C i, jako ustawienie eksperymentalne, przez Bluetooth, i zamienia go w klawisze, mysz i makra w każdej aplikacji. Switch2Bridge nie był testowany, więc wszystko poniżej o nim pochodzi z jego readme, czytanego 27 października 2026.

Kroki

  1. Sprawdź, że znaleziony projekt to mlstr0m/switch2bridge-macos, bo inne projekty używają tej samej nazwy.
  2. Pobierz obraz dysku ze strony Releases, przenieś aplikację do Programów i raz zezwól na nią w Ustawieniach systemowych, Prywatność i ochrona, bo nie jest notaryzowana.
  3. Zezwól na Dostępność przy starcie, a na Bluetooth przy pierwszym kliknięciu Connect Controller.
  4. W Ryujinx ustaw Input Device na Keyboard i dopasuj jego klawisze albo wskaż Dolphin lub Cemu jego serwer DSU.
  5. Dla innych aplikacji albo na kablu zamknij go i użyj zamiast tego InputConfig.

Sprawdź, który Switch2Bridge znalazłeś

Kilka niepowiązanych projektów dzieli tę nazwę i tylko jeden z nich to aplikacja na pasku menu w Pythonie, którą ludzie zwykle mają na myśli. Oto te, które znaleziono na GitHubie 27 października 2026:

RepozytoriumCzym jestDziała na
mlstr0m/switch2bridge-macosAplikacja na pasku menu w Pythonie z tej strony: Bluetooth Low Energy, naciśnięcia klawiszy i serwer DSU. Licencja MIT. Jej najnowsze wydanie, 1.4.0, wyszło 28 września 2026.macOS 13 Ventura lub nowszy
SwonDev/Switch2BridgeAplikacja w Swift działająca w tle, która podaje Pro Controller 2 grom Windows uruchamianym pod Wine, na przykład przez CrossOver. Jej readme, po hiszpańsku, mówi, że natywne gry na Maca nie są obsługiwane.macOS 15 Sequoia lub nowszy
gessecarneiro/Switch2BridgeProgram na Windows dla Pro Controller 2 przez USB.Windows, nie Mac

Starsze linki do aureliendesert/switch2bridge-macos prowadzą do tego samego repozytorium co mlstr0m/switch2bridge-macos, gdzie są jego pobrania. Sprawdź repozytorium, z którego pochodzi pobranie, bo sama nazwa nie mówi, który to program.

Wiedz, co czyta i co wysyła

Switch2Bridge łączy się z kontrolerem bezpośrednio przez Bluetooth Low Energy, bez parowania go w Ustawieniach systemowych, i przy połączeniu czyta fabryczną kalibrację gałek kontrolera. Jego readme wymienia:

  • Każdy przycisk. Przyciski czołowe, D-pad, L, R, ZL i ZR, kliknięcia gałek, Plus, Minus, Home i Capture, nowy przycisk C oraz przyciski chwytu GL i GR z tyłu.
  • Obie gałki jako klawisze. W, A, S i D dla lewej gałki i I, J, K i L dla prawej, z każdą gałką ściętą do ośmiu kierunków.
  • Przyciski jako klawisze. Domyślnie A wysyła Z, B wysyła X, X wysyła C, a Y wysyła V, z D-padem na klawiszach strzałek i przyciskiem C wolnym.
  • Ponowne łączenie. Jeśli kontroler zasypia albo odpada, aplikacja próbuje przez 60 sekund.
  • Więcej niż jeden kontroler. Jedna kopia aplikacji na kontroler, każda uruchamiana z własnym plikiem mapowania.

Aby zmienić klawisz, edytuje się plik JSON i wybiera Reload mappings z ikony na pasku menu:

Finder, Idź do folderu: gdzie Switch2Bridge trzyma mapowanie klawiszy.

~/Library/Application Support/Switch2Bridge/mappings.json

Co się dzieje: Finder otwiera plik, który aplikacja zapisała przy pierwszym uruchomieniu. Każdy przycisk albo kierunek gałki bierze jeden klawisz.

Cztery wiersze w edytorze InputConfig wysyłające A, D, W i S z kierunków lewej gałki w lewo, prawo, górę i dół, a po nich wiersze prawej gałki ruszające myszą.
Figure 1. Ten sam pomysł lewej gałki na W, A, S i D co domyślny Switch2Bridge, zbudowany jako wiersze w InputConfig, gdzie każdy wiersz może wysłać dowolny klawisz, klik albo makro.

Wiedz, czego chce od Twojego Maca

  • macOS 13 Ventura lub nowszy. Python 3.10 lub nowszy tylko jeśli uruchamiasz go z kodu źródłowego.
  • Aplikacja, przed którą macOS ostrzega. Wydanie nie jest notaryzowane, więc Gatekeeper blokuje pierwsze uruchomienie. W macOS 15 i nowszym zezwalasz na nie w Ustawieniach systemowych, Prywatność i ochrona, przez Open Anyway. W macOS 13 i 14 klikasz aplikację prawym i wybierasz Open.
  • Dostępność. Pytana przy starcie, bo aplikacja naciska za Ciebie klawisze.
  • Bluetooth. Pytany przy pierwszym kliknięciu Connect Controller. Uruchamiane z kodu źródłowego uprawnienie Bluetooth należy do Terminala albo Twojego Pythona, a nie do aplikacji.

Dostępność pozwala aplikacji naciskać klawisze w każdej innej aplikacji, więc nadaję ją tylko aplikacjom, którym ufam. Ta jest open source, więc możesz przeczytać dokładnie, co z nią robi. Nie wyłącza żadnych zabezpieczeń Maca, co jest więcej, niż można powiedzieć o niektórych projektach Switch 2.

Uzyskaj analogowe gałki w Dolphin i Cemu przez DSU

Naciśnięcia klawiszy są wszystko albo nic, dlatego gałka wysłana jako klawisze ma tylko osiem kierunków. Dla emulatorów przyjmujących DSU, protokół cemuhook, Switch2Bridge uruchamia też mały serwer, który podaje im kontroler z prawdziwymi analogowymi gałkami. Domyślnie nasłuchuje pod tym adresem:

Dolphin lub Cemu: adres serwera DSU do dodania.

127.0.0.1:26760

Co się dzieje: Kontroler pojawia się w emulatorze jako urządzenie wejściowe, z gałkami.

  • Dolphin. Options, Controller Settings, Alternate Input Sources, włącz DSU Client i dodaj adres.
  • Cemu. W jego ustawieniach wejścia dodaj DSUController z tym samym adresem.
  • Ryujinx. Używa DSU tylko do ruchu, a readme mówi, że Switch2Bridge jeszcze nie dekoduje ruchu, więc wysyła zera. Przyciski i gałki w Ryujinx nadal idą przez klawisze.

Po stronie DSU przyciski mapują się według położenia, A na Circle, B na Cross i tak dalej, a GL, GR i C nie mają dokąd się mapować. Analogowe gałki w Dolphin i Cemu to zadanie, którego InputConfig tu nie robi, bo wysyła klawisze i ruch myszy, a nie strumień DSU. Konfiguracja kontrolera Dolphin na Macu opisuje kontrolery, które Dolphin czyta bezpośrednio.

Poznaj jego ograniczenia

  • Tylko Pro Controller 2. Readme nie wymienia żadnego innego kontrolera, więc to nie jest narzędzie dla Joy-Con 2 ani kontrolera GameCube dla Switch 2.
  • Tylko Bluetooth. Przez USB kontroler milczy, dopóki nie dostanie sekwencji startowej, a readme mówi, że nie jest jeszcze wbudowana w Switch2Bridge.
  • Nie kontroler do gier na Macu. Ustawienia systemowe, Kontrolery do gier go nie wymieniają, a gry czytające kontrolery przez macOS, w tym Steam, go nie widzą.
  • Klawisze, nie pad. Gra, która przyjmuje tylko kontroler, go ignoruje, a gałka wysłana jako klawisze traci połowiczne popchnięcia.

Porównaj inne narzędzia Switch 2 na Maca

Kontrolery Switch 2 docierają do Maca tylko przez oprogramowanie, które samo zna ich protokół. To projekty, którym warto się przyjrzeć, według tego, co mówi strona każdego z nich 27 października 2026. Żadnego nie testowano.

NarzędzieKontroleryPołączenieCo widzą inne aplikacjeCzego chce
switch2bridge-macosPro Controller 2BluetoothNaciśnięcia klawiszy, plus strumień DSU dla emulatorówDostępność, Bluetooth, aplikacja niezanotaryzowana
Peterksharma/switch2mac, aplikacja o nazwie Finally the Controller WorksPro Controller 2, Joy-Con 2 osobno albo w parze, kontroler GameCubeBluetooth, do czterech narazJej readme mówi, że standardowy kontroler do gier czytany przez każdą aplikację, bez rumble i ruchumacOS 15 lub nowszy na Apple silicon, Bluetooth. Oznaczona jako beta, podpisana i notaryzowana
AlexmChadwick/Switch-2-Controller-HelperPro Controller 2BluetoothWirtualny gamepad tylko z płatnym uprawnieniem dewelopera Apple albo wyłączonym SIP, w przeciwnym razie naciśnięcia klawiszyBudujesz to w Xcode. Jej autor nazywa to pracą w toku
procon2-macPro Controller 2USB, bezprzewodowo wymaga więcejNa kablu Steam i inne aplikacje mogą go czytaćBezprzewodowo wymaga rozszerzenia DriverKit, które budujesz i podpisujesz płatnym kontem dewelopera
InputConfigPro Controller 2, każdy Joy-Con 2 osobno, kontroler GameCubeUSB-C i Bluetooth z ustawieniemKlawisze, mysz, makra i funkcje systemoweDostępność i Bluetooth dla ustawienia bezprzewodowego. Eksperymentalne, a część Bluetooth jeszcze niesprawdzona na kontrolerze

Jeśli potrzebujesz, by gry widziały kontroler jako kontroler, readme switch2mac mówi, że to dokładnie jego zadanie, a Switch2Bridge mówi wprost, że nie. Strona o Switch 2 Pro Controller na Macu ma więcej o każdym, a Joy-Con 2 na Macu opisuje dwa projekty JoyCon2Mac.

Czytaj Switch 2 Pro Controller w InputConfig

InputConfig sam rozmawia z kontrolerem, więc nie potrzebuje sterownika ani rozszerzenia i niczego nie zmienia w zabezpieczeniach Maca. Całość jest oznaczona w aplikacji jako eksperymentalna, bo powstała z opublikowanej przez społeczność sekwencji startowej i układu raportów, bez kontrolera pod ręką.

Krok 1: Połącz go

  • Ty: Najpierw zamknij Switch2Bridge, by tylko jedna aplikacja rozmawiała z kontrolerem. Potem podłącz kontroler do Maca kablem USB-C, który przenosi dane, i otwórz InputConfig. Dla Bluetooth otwórz Ustawienia, Devices, włącz Connect Switch 2 Pro, GameCube and Joy-Con 2 controllers over Bluetooth i przytrzymaj przycisk synchronizacji kontrolera, aż światła przebiegną. Za pierwszym razem macOS pyta, czy InputConfig może użyć Bluetooth, więc zezwól.
  • InputConfig: Wysyła do kontrolera polecenia startowe, na które czeka, albo znajduje go przez Bluetooth, gdy aplikacja działa, i czyta jak każdego innego pada.
  • Sprawdź: Zapala się światło gracza 1, a kontroler pojawia się u góry paska bocznego jako Switch 2 Pro Controller (Experimental).

Krok 2: Daj każdemu elementowi zadanie

  • Ty: Otwórz preset, dodaj wiersz, naciśnij Scan, naciśnij przycisk i wybierz klawisz, klik albo makro.
  • InputConfig: Czyta każdy przycisk czołowy, obie gałki, D-pad, L, R, ZL i ZR, Minus, Plus, Home, Capture, C, GL i GR, a od 1.8 czujniki ruchu i kalibrację gałek zapisaną w kontrolerze.
  • Sprawdź: Naciśnij każdy element z otwartym Live Visualizer, zanim zaufasz układowi.
Live Visualizer InputConfig pokazujący standardowy gamepad jako zwykłą mapę spustów, bumperów, przycisków czołowych, D-pada i gałek, każdy opisany tym, co robi.
Figure 2. Pad bez własnego rysunku pokazuje się jako taka zwykła mapa. Rysunek Pro Controller 2 jest eksperymentalny i ukryty, więc tak się pojawia.

Aplikacja oznacza ustawienie Bluetooth jako Experimental: jeszcze niesprawdzone na kontrolerze, więc kabel nadal jest pewniejszą drogą. Dla Ryujinx InputConfig może zamiast tego wysyłać jego klawisze klawiatury, z Input Device ustawionym na Keyboard, a konfiguracja kontrolera Ryujinx na Macu wymienia domyślne klawisze do przypisania i jak sprawdzić, że jeden dociera.

Czego InputConfig tu nie potrafi

  • Zrobić z niego kontrolera do gier na Macu. macOS nadal nie czyta Pro Controller 2, więc gry czytające kontrolery przez macOS nie widzą go też z InputConfig.
  • Wysłać strumienia DSU. Dla analogowych gałek wewnątrz Dolphin lub Cemu to zadanie Switch2Bridge.
  • Czytać ZL i ZR jako analogowych. Czytają się jako włączone lub wyłączone.
  • Rumble i NFC. InputConfig nie używa żadnego z nich.
Menu Devices w InputConfig wymieniające klawiaturę i mysz Maca, gamepad USB i drążek arcade ze znacznikami oraz pad Xbox 360 z notatką, że macOS nie może go czytać.
Figure 3. InputConfig, Devices na pasku menu wymienia to, co Mac widzi, ze znacznikiem przy tym, co aplikacja czyta. Zajrzyj tu najpierw, gdy kontroler się nie pokazuje.

Krótka wersja

  • Switch2Bridge. Darmowa aplikacja na pasku menu w Pythonie dla Pro Controller 2 przez Bluetooth, która wysyła naciśnięcia klawiszy, zbudowana dla Ryujinx.
  • Jego najlepsza sztuczka. Serwer DSU z prawdziwymi analogowymi gałkami dla Dolphin i Cemu.
  • Jego ograniczenia. Jeden model kontrolera, tylko Bluetooth, niezanotaryzowany i nie kontroler do gier dla macOS.
  • InputConfig. Pro Controller 2 na kablu albo przez Bluetooth, jako funkcja eksperymentalna, przypisany do klawiszy, myszy i makr w każdej aplikacji.

Wybierz Switch2Bridge dla analogowych gałek w Dolphin lub Cemu, a InputConfig do wszystkiego, co bierze klawiaturę i mysz, i uruchamiaj jeden naraz.

Pytania

Czy Switch2Bridge jest bezpieczny do uruchomienia?

Jest open source na licencji MIT, więc jego kod można przeczytać, i nie wyłącza żadnych zabezpieczeń Maca. Nie jest notaryzowany, więc macOS ostrzega przy pierwszym uruchomieniu, i prosi o Dostępność, by naciskać klawisze. Nie testowano go ani nie audytowano.

Czy Switch2Bridge działa z Joy-Con 2?

Jego readme wymienia tylko Switch 2 Pro Controller. Joy-Con 2 wymienia readme switch2mac, a InputConfig czyta każdy z nich osobno jako funkcję eksperymentalną.

Czy Switch2Bridge potrzebuje uprawnienia Dostępność?

Tak. Prosi o Dostępność przy starcie, bo naciska za Ciebie klawisze, a o Bluetooth przy pierwszym kliknięciu Connect Controller.

Czy InputConfig czyta Switch 2 Pro Controller?

Tak, jako funkcję eksperymentalną: na kablu USB-C od 1.6, z ruchem od 1.8 i przez Bluetooth od 1.8 z włączonym Connect Switch 2 Pro, GameCube and Joy-Con 2 controllers over Bluetooth w Ustawieniach, Devices. Część Bluetooth jest oznaczona jako jeszcze niesprawdzona na kontrolerze.

Czemu Mac nie widzi Switch 2 Pro Controller?

macOS obsługuje oryginalny Switch Pro Controller, ale nie wersję Switch 2. Przez USB czeka na polecenia startowe, których nic na Macu nie wysyła, a przez Bluetooth używa własnego protokołu Low Energy Nintendo, więc czytają go tylko aplikacje, które nim mówią.

Więcej po polsku

Pełne poradniki, po angielsku

Kto pisze. Ryleigh Newman tworzy InputConfig i na co dzień steruje własnym Makiem za pomocą kontrolera, bo ręce nie działają najlepiej. Ta strona jest przetłumaczona z angielskiego. Główne przyciski i menu aplikacji są po polsku, gdy Mac jest ustawiony na polski. Reszta aplikacji i witryny jest po angielsku.

Ta strona w innych językach: English, Deutsch, Español, Français, Italiano, 日本語, 한국어, Português, Русский, ไทย, 繁體中文, 简体中文

Pobierz InputConfig z Mac App StoreZa darmo. macOS 14 lub nowszy. Bez konta, nic nie opuszcza Twojego Maca. Open source na GitHubie.