Русский

Что такое Switch2Bridge и что он делает на Mac?

Загрузить InputConfig в Mac App StoreЭто приложение полностью бесплатное. Создавать учётную запись не нужно. Нет подписок, нет сложных загрузок, и ничего не заблокировано. Оптимизировано для Apple Silicon.

Switch2Bridge, опубликованный на GitHub как switch2bridge-macos, это бесплатное приложение для строки меню, написанное на Python под лицензией MIT, которое подключается к Switch 2 Pro Controller по Bluetooth Low Energy и превращает его кнопки и стики в нажатия клавиш. Оно написано для эмулятора Ryujinx, а ещё запускает сервер DSU, который даёт Dolphin и Cemu настоящие аналоговые стики. В его собственном readme прямо сказано, что это не драйвер: macOS по-прежнему не показывает контроллер, а игры, которые читают контроллеры, его не видят.

Я делаю InputConfig, бесплатное приложение для Mac, которое само читает Pro Controller 2 по кабелю USB-C и, как экспериментальную настройку, по Bluetooth и превращает его в клавиши, мышь и макросы в любом приложении. Switch2Bridge не проверялся, поэтому всё сказанное о нём ниже взято из его readme, просмотренного 27 октября 2026 года.

Шаги

  1. Убедитесь, что найденный проект это mlstr0m/switch2bridge-macos, так как другие проекты используют то же имя.
  2. Скачайте образ диска со страницы Releases, переместите приложение в «Программы» и один раз разрешите его в Системных настройках, Конфиденциальность и безопасность, потому что оно не заверено нотариально.
  3. Разрешите Универсальный доступ при запуске и Bluetooth при первом нажатии Connect Controller.
  4. В Ryujinx задайте Input Device в значение Keyboard и подгоните его клавиши либо направьте Dolphin или Cemu на его сервер DSU.
  5. Для других приложений или при подключении по кабелю закройте его и используйте InputConfig.

Проверьте, какой именно Switch2Bridge вы нашли

Несколько несвязанных проектов носят это имя, и только один из них это то Python-приложение для строки меню, которое обычно имеют в виду. Вот те, что нашлись на GitHub 27 октября 2026 года:

РепозиторийЧто этоГде работает
mlstr0m/switch2bridge-macosPython-приложение для строки меню, о котором эта страница: Bluetooth Low Energy, нажатия клавиш и сервер DSU. Лицензия MIT. Его последний релиз, 1.4.0, вышел 28 сентября 2026 года.macOS 13 Ventura или новее
SwonDev/Switch2BridgeФоновое приложение на Swift, которое передаёт Pro Controller 2 в игры Windows, запущенные под Wine, например через CrossOver. В его readme на испанском сказано, что нативные игры для Mac не поддерживаются.macOS 15 Sequoia или новее
gessecarneiro/Switch2BridgeПрограмма для Windows для Pro Controller 2 по USB.Windows, не Mac

Старые ссылки на aureliendesert/switch2bridge-macos ведут в тот же репозиторий, что и mlstr0m/switch2bridge-macos, где и находятся его загрузки. Проверьте репозиторий, откуда пришла загрузка, потому что одно имя не говорит, какая это программа.

Узнайте, что он читает и что отправляет

Switch2Bridge подключается к контроллеру напрямую по Bluetooth Low Energy, не сопрягая его в Системных настройках, и при подключении читает заводскую калибровку стиков контроллера. В его readme перечислено:

  • Каждая кнопка. Лицевые кнопки, крестовина, 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, крестовина на клавишах со стрелками, а кнопка C остаётся свободной.
  • Повторное подключение. Если контроллер засыпает или отключается, приложение пытается подключиться 60 секунд.
  • Несколько контроллеров. Одна копия приложения на контроллер, каждая запускается со своим файлом назначений.

Чтобы изменить клавишу, отредактируйте файл JSON и выберите Reload mappings в значке строки меню:

Finder, Go to Folder: где Switch2Bridge хранит назначение клавиш.

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

Что происходит: Finder открывает файл, который приложение записало при первом запуске. Каждая кнопка или направление стика получает одну клавишу.

Четыре строки в редакторе InputConfig, которые посылают A, D, W и S с направлений левого стика влево, вправо, вверх и вниз, затем строки правого стика, двигающие мышь.
Figure 1. Та же идея левого стика на W, A, S и D, как у Switch2Bridge по умолчанию, но построенная строками в InputConfig, где каждая строка может посылать любую клавишу, клик или макрос.

Узнайте, чего он просит у вашего Mac

  • macOS 13 Ventura или новее. Python 3.10 или новее нужен, только если запускать из исходного кода.
  • Приложение, о котором macOS предупреждает. Релиз не заверен нотариально, поэтому Gatekeeper блокирует первый запуск. В macOS 15 и новее его разрешают в Системных настройках, Конфиденциальность и безопасность, через Open Anyway. В macOS 13 и 14 нужно щёлкнуть приложение правой кнопкой и выбрать Open.
  • Универсальный доступ. Запрашивается при запуске, потому что приложение нажимает клавиши за вас.
  • Bluetooth. Запрашивается при первом нажатии Connect Controller. При запуске из исходного кода разрешение Bluetooth принадлежит Terminal или вашему Python, а не приложению.

Универсальный доступ позволяет приложению нажимать клавиши в любом другом приложении, поэтому давать его стоит только тем, которым доверяешь. Это приложение с открытым кодом, так что можно прочитать, что именно оно с ним делает. Оно не отключает ни одну из защит безопасности Mac, и это больше, чем могут сказать о себе некоторые проекты для Switch 2.

Получите аналоговые стики в Dolphin и Cemu через DSU

Нажатия клавиш бывают только есть или нет, поэтому у стика, отправленного как клавиши, всего восемь направлений. Для эмуляторов, которые принимают 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 пока не декодирует движение, поэтому посылает нули. Кнопки и стики в Ryujinx по-прежнему идут через клавиши.

На стороне DSU кнопки назначаются по положению, A на Circle, B на Cross и так далее, а GL, GR и C назначать не на что. Аналоговые стики в Dolphin и Cemu это та задача, которую InputConfig не решает, потому что он посылает клавиши и движение мыши, а не поток DSU. Контроллеры, которые Dolphin читает напрямую, описаны в статье настройка контроллера Dolphin на Mac.

Узнайте его ограничения

  • Только Pro Controller 2. В readme не назван ни один другой контроллер, поэтому это не тот инструмент для Joy-Con 2 или контроллера GameCube для Switch 2.
  • Только Bluetooth. По USB контроллер молчит, пока не получит стартовую последовательность, а в readme сказано, что в Switch2Bridge это пока не встроено.
  • Не игровой контроллер Mac. Системные настройки, Контроллеры его не показывают, а игры, которые читают контроллеры через macOS, в том числе Steam, его не видят.
  • Клавиши, а не геймпад. Игра, которая принимает только контроллер, его игнорирует, а стик, отправленный как клавиши, теряет половинные отклонения.

Сравните другие инструменты Switch 2 для Mac

Контроллеры Switch 2 попадают на Mac только через программы, которые сами говорят на их протоколе. Вот проекты, на которые стоит посмотреть, по тому, что сказано на страницах каждого из них на 27 октября 2026 года. Ни один из них не проверялся.

ИнструментКонтроллерыПодключениеЧто видят другие приложенияЧто требуется
switch2bridge-macosPro Controller 2BluetoothНажатия клавиш, а также поток DSU для эмуляторовУниверсальный доступ, Bluetooth, приложение без нотариального заверения
Peterksharma/switch2mac, приложение под названием Finally the Controller WorksPro Controller 2, Joy-Con 2 по одному или парой, контроллер GameCubeBluetooth, до четырёх одновременноВ его readme сказано, что это стандартный игровой контроллер, который читают все приложения, без вибрации и движенияmacOS 15 или новее на Apple silicon, Bluetooth. Помечено как бета, подписано и заверено нотариально
AlexmChadwick/Switch-2-Controller-HelperPro Controller 2BluetoothВиртуальный геймпад только при платном праве разработчика Apple или выключенном SIP, иначе нажатия клавишСобирается в Xcode. Автор называет проект незавершённым
procon2-macPro Controller 2USB, для беспроводного нужно большеПо кабелю его могут читать Steam и другие приложенияДля беспроводного нужно расширение DriverKit, которое вы собираете и подписываете платным аккаунтом разработчика
InputConfigPro Controller 2, каждый Joy-Con 2 отдельно, контроллер GameCubeUSB-C, а Bluetooth с настройкойКлавиши, мышь, макросы и системные функцииУниверсальный доступ, а для беспроводной настройки Bluetooth. Экспериментально, а часть Bluetooth пока не проверена на контроллере

Если вам нужно, чтобы игры видели контроллер именно как контроллер, в readme switch2mac сказано, что это его прямая задача, а Switch2Bridge прямо говорит, что это не так. Подробнее о каждом на странице Switch 2 Pro Controller на Mac, а два проекта JoyCon2Mac описаны в статье Joy-Con 2 на Mac.

Прочитайте Switch 2 Pro Controller с помощью InputConfig

InputConfig сам общается с контроллером, поэтому ему не нужны ни драйвер, ни расширение, и он ничего не меняет в безопасности вашего Mac. Всё это помечено в приложении как экспериментальное, потому что оно построено на опубликованной сообществом стартовой последовательности и раскладке отчётов без контроллера в руках.

Шаг 1: Подключите его

  • Вы: Сначала закройте Switch2Bridge, чтобы с контроллером общалось только одно приложение. Затем подключите контроллер к Mac кабелем USB-C, передающим данные, и откройте InputConfig. Для Bluetooth вместо этого откройте Settings, 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: Читает каждую лицевую кнопку, оба стика, крестовину, L, R, ZL и ZR, Minus, Plus, Home, Capture, C, GL и GR, а с версии 1.8 ещё датчики движения и калибровку стиков, хранящуюся в контроллере.
  • Проверка: Нажмите каждый элемент при открытом Live Visualizer, прежде чем полагаться на раскладку.
Live Visualizer InputConfig показывает стандартный геймпад в виде простой карты курков, бамперов, лицевых кнопок, крестовины и стиков, каждый подписан тем, что делает.
Figure 2. Геймпад без собственного рисунка показывается как простая карта вроде этой. Рисунок Pro Controller 2 экспериментальный и скрыт, поэтому так он и выглядит.

Настройка Bluetooth помечена в приложении как экспериментальная: на контроллере пока не проверена, так что кабель остаётся более надёжным путём. Для Ryujinx InputConfig может посылать его клавиши клавиатуры, если задать Input Device в значение Keyboard, а в статье настройка контроллера Ryujinx на Mac перечислены клавиши по умолчанию, которые нужно назначить, и способ проверить, что они доходят.

Чего InputConfig здесь не умеет

  • Сделать его игровым контроллером Mac. macOS по-прежнему не читает Pro Controller 2, поэтому игры, которые читают контроллеры через macOS, не видят его и с InputConfig.
  • Отправлять поток DSU. Для аналоговых стиков внутри Dolphin или Cemu это задача Switch2Bridge.
  • Читать ZL и ZR как аналоговые. Они читаются как включено или выключено.
  • Вибрация и NFC. InputConfig не использует ни то, ни другое.
Меню Devices в InputConfig со списком клавиатуры и мыши Mac, USB-геймпада и аркадного стика с галочками и геймпада Xbox 360 с пометкой, что macOS не может его прочитать.
Figure 3. InputConfig, Devices в строке меню показывает то, что видит Mac, с галочкой на том, что читает приложение. Загляните сюда первым делом, когда контроллер не появляется.

Коротко

  • Switch2Bridge. Бесплатное Python-приложение для строки меню для Pro Controller 2 по Bluetooth, которое посылает нажатия клавиш и создано для Ryujinx.
  • Его главный приём. Сервер DSU с настоящими аналоговыми стиками для Dolphin и Cemu.
  • Его ограничения. Одна модель контроллера, только Bluetooth, без нотариального заверения и не игровой контроллер для macOS.
  • InputConfig. Pro Controller 2 по кабелю или по Bluetooth, как экспериментальная функция, с назначением на клавиши, мышь и макросы в любом приложении.

Выбирайте Switch2Bridge для аналоговых стиков в Dolphin или Cemu, а InputConfig для всего, что принимает клавиатуру и мышь, и запускайте что-то одно.

Вопросы

Безопасно ли запускать Switch2Bridge?

Он с открытым кодом под лицензией MIT, поэтому его код можно прочитать, и он не отключает защиты безопасности Mac. Он не заверен нотариально, поэтому macOS предупреждает при первом запуске, и он просит Универсальный доступ, чтобы нажимать клавиши. Он не проверялся и не проходил аудит.

Работает ли Switch2Bridge с Joy-Con 2?

В его readme назван только Switch 2 Pro Controller. Для Joy-Con 2 они перечислены в readme switch2mac, а InputConfig читает каждый по отдельности как экспериментальную функцию.

Нужно ли Switch2Bridge разрешение Универсального доступа?

Да. Он просит Универсальный доступ при запуске, потому что нажимает клавиши за вас, и Bluetooth при первом нажатии Connect Controller.

Читает ли InputConfig Switch 2 Pro Controller?

Да, как экспериментальную функцию: по кабелю USB-C с версии 1.6, с движением с версии 1.8 и по Bluetooth с версии 1.8 при включённом Connect Switch 2 Pro, GameCube and Joy-Con 2 controllers over Bluetooth в Settings, Devices. Часть Bluetooth помечена как пока не проверенная на контроллере.

Почему Mac не видит Switch 2 Pro Controller?

macOS поддерживает оригинальный Switch Pro Controller, но не версию для Switch 2. По USB он ждёт стартовых команд, которых ничто на Mac не посылает, а по Bluetooth использует собственный протокол Low Energy от Nintendo, поэтому прочитать его могут только приложения, которые на нём говорят.

Ещё на русском

Подробные руководства на английском

Кто это пишет. Ryleigh Newman разрабатывает InputConfig и каждый день управляет своим Mac с помощью геймпада, потому что руки плохо слушаются. Эта страница переведена с английского. Если на Mac выбран русский язык, основные кнопки и меню приложения показываются по-русски; на этой странице они названы так же, с английским названием в скобках. Остальная часть приложения и сайта на английском языке.

Эта страница на других языках: English, Deutsch, Español, Français, Italiano, 日本語, 한국어, Polski, Português, ไทย, 繁體中文, 简体中文

Загрузить InputConfig в Mac App StoreБесплатно. macOS 14 или новее. Без учётной записи, ничего не покидает ваш Mac. Исходный код на GitHub.