Русский
Почему контроллер Anki не виден или не работает на Mac
Это приложение полностью бесплатное. Создавать учётную запись не нужно. Нет подписок, нет сложных загрузок, и ничего не заблокировано. Оптимизировано для Apple Silicon.
Почти всегда пульт находится не в том режиме или ничто на Mac не превращает его кнопки в клавиши Anki. Anki на Mac сам не читает контроллер. Ему нужно дополнение Contanki или системный маппер вроде InputConfig, бесплатного приложения, которое я делаю и которое посылает Anki обычные нажатия клавиш. Переведите пульт в режим контроллера, сопрягите его заново и используйте что-то одно из двух, но не оба сразу.
Эта страница это список исправлений по симптомам. Саму раскладку объясняет руководство по контроллеру для Anki по каждой кнопке, а первое сопряжение описано в статье настройка пульта Anki на Mac.
Шаги
- Выключите пульт и переведите его в режим контроллера: D на 8BitDo Micro или удержание A и Start вместе на Zero 2.
- Удалите старую запись в Системных настройках, Bluetooth, и сопрягите пульт заново.
- Откройте Live Visualizer в InputConfig и нажмите каждую кнопку, чтобы увидеть, что доходит до Mac.
- Активируйте встроенный пресет Anki и включите Switch presets when the front app changes.
- Если установлен Contanki, выключите его, пока работает InputConfig, или наоборот.
Найдите свой симптом и его исправление
| Что вы видите | Обычная причина | Исправление |
|---|---|---|
| Contanki пишет Controller not detected | Пульт в режиме клавиатуры или дополнение не видит геймпад | Режим контроллера или системный маппер |
| Пульт печатает буквы или прокручивает карточку | Режим клавиатуры, K на Micro | Переключите на D и сопрягите заново |
| Bluetooth пишет «подключено», а Anki игнорирует | Ничто его не назначает | Contanki или пресет Anki в InputConfig |
| Каждое нажатие считается дважды | Два маппера одновременно | Выключите один |
| Одна кнопка вообще ничего не делает | Геймпад оставляет её себе, как Star на Micro в режиме D | Используйте другую кнопку |
| Работает на iPad, но не на Mac | В AnkiMobile своя поддержка контроллеров | Маппер на Mac |
| Перестал работать после обновления macOS | Сообщалось о Contanki, подтверждённого исправления нет | Проверьте в Live Visualizer, затем попробуйте системный маппер |
Сначала найдите свою строку, потому что режим, сопряжение и маппер это три разные проблемы.
Переведите пульт в режим контроллера
Большинство пультов Anki это маленький геймпад 8BitDo, и в каждом режиме это другое устройство:
- 8BitDo Micro. У переключателя на нижней грани положения S, D и K. D это обычный геймпад, который читает InputConfig, S делает его контроллером Switch, а K делает его клавиатурой Bluetooth, печатающей фиксированные буквы.
- 8BitDo Zero 2. Переключателя нет. Включите его удержанием A и Start вместе для режима macOS, он сопрягается как Wireless Controller. R и Start включает его как клавиатуру.
- Другие геймпады 8BitDo. D на Pro 2. SN30 Pro или SN30 Pro+ включаются удержанием B и Start вместе.
Режим клавиатуры для Anki не ошибочен, это другой путь: буквы, которые он печатает, выбраны 8BitDo, и они редко совпадают с Space и 1-4 в Anki. Для собственной раскладки используйте режим контроллера и задайте его до сопряжения.
Удалите пульт и сопрягите заново
Пульт, сопряжённый в одном режиме, в другом виден как новое устройство, и старая запись мешает.
- Вы: Откройте Системные настройки, Bluetooth, удалите пульт, включите его в выбранном режиме и переведите в режим сопряжения. На Micro удерживайте Pair три секунды, на Zero 2 удерживайте Select три секунды.
- macOS: Показывает пульт с кнопкой Connect.
- Проверка: Он показан как подключённый, и индикатор на пульте перестаёт мигать.
Если он всё равно не сопрягается, зарядите его, держите рядом с Mac и убедитесь, что он не остался сопряжённым со Switch или телефоном поблизости. Более старому геймпаду может понадобиться обновление прошивки через Upgrade Tool от 8BitDo. USB-порт Zero 2 только заряжает его и обновляет прошивку, поэтому он подключается только по Bluetooth. Удаляйте старую запись каждый раз, когда меняете режим.
Когда Contanki пишет, что контроллер не обнаружен
Contanki это бесплатное дополнение, которое читает контроллер изнутри Anki, и когда оно его не находит, оно пишет Controller not detected. На форуме Anki есть несколько сообщений об этом на Mac. Одно из них, тема о Zero 2 от 8 сентября 2025 года, касалось пульта, сопряжённого в режиме клавиатуры. Другое, от 28 сентября 2025 года, касалось Zero 2 на MacBook после сброса дополнения и покупки нового пульта. Третье, от 29 сентября 2025 года, касалось контроллера PS5, который перестал определяться после обновления macOS. На момент чтения 27 октября 2026 года подтверждённого исправления не было ни в одном, кроме руководств по настройке и совета обратиться к автору дополнения.
Выхода два:
- Дайте Contanki контроллер. Пульт в режиме клавиатуры это клавиатура, поэтому дополнению нечего обнаруживать. Переключитесь в режим контроллера и сопрягите заново.
- Обойдите определение внутри Anki. Системный маппер читает контроллер и посылает Anki обычные нажатия клавиш, так что Anki видит только клавиатуру. Так работает InputConfig, и тот же геймпад затем управляет списком колод, браузером и остальным Mac.
Если вы пробуете InputConfig, выключите Contanki на время сеанса. Два маппера одновременно отвечают на каждое нажатие дважды, что выглядит как сломанный пульт.
Посмотрите, что слышит Mac, в Live Visualizer
Прежде чем менять что-то ещё, выясните, доходят ли нажатия пульта до Mac вообще.
- Вы: Откройте пресет Anki в InputConfig и нажмите каждую кнопку на пульте при открытом Live Visualizer.
- InputConfig: Подсвечивает каждый пришедший элемент на рисунке геймпада.
- Проверка: Элемент, который никогда не загорается, не доходит до Mac, поэтому проверьте подключение и переключатель режима. Если пульта вообще нет на боковой панели, отметьте его в InputConfig, Devices в строке меню.
Micro в режиме D оставляет кнопку Star себе, как собственную турбо-клавишу, поэтому Star никогда не загорается и её нельзя назначить. Это особенность геймпада, а не неисправность. Всё, что загорается, можно назначить, а всё, что нет, это проблема подключения или режима.
Включите пресет Anki и оставьте его включённым
В InputConfig есть встроенный пресет Anki, в разделе Built-in Presets, Desktop & Productivity. A / Cross посылает Space, что показывает ответ, а затем ставит оценку Good. X / Square посылает 1 для Again, B / Circle посылает 2 для Hard, Y / Triangle посылает 4 для Easy, левый бампер отменяет, а правый повторяет звук.
Если пульт горит, а Anki не реагирует, поднимайтесь по этой лестнице, начиная с самого простого шага:
- Выведите Anki на передний план. Клавиши идут приложению на переднем плане, поэтому окно повторения за другим приложением ничего не получает.
- Проверьте, что пресет работает. Кнопка на странице пресета пока он работает называется Deactivate. Включите Switch presets when the front app changes в Settings, Advanced, и Anki, уже стоящий в списке пресета, включит его сам.
- Проверьте разрешение. InputConfig нужен Универсальный доступ в Системных настройках, Конфиденциальность и безопасность. Оранжевый значок в строке меню означает, что пресет его ждёт.
- Проверьте собственные клавиши Anki. Если вы меняли сочетания ответов Anki, снова нажмите Scan в этих строках и нажмите новые клавиши.
Чтобы большая кнопка означала Hard или Again вместо Good, бесплатное дополнение Anki Spacebar Binder меняет то, что делает Space на стороне ответа.
Если Mac перезагружается или пульт всё время отключается
Пульт, который отваливается, обычно страдает от батареи, другого устройства, с которым он ещё сопряжён, или от того, что геймпад сам выключается через какое-то время без ввода, что выглядит как отключение, когда вы задумались над трудной карточкой. Зарядите его, отвяжите от всего остального поблизости и сопрягите заново.
Перезагрузка Mac это другое. В одной теме на форуме от августа 2025 года описан MacBook Air M3 на macOS 15.6.1, который перезагружался всякий раз, когда 8BitDo Micro подключали по Bluetooth в режиме D, а журналы сбоев указывали на процесс Apple, который обрабатывает устройства ввода. Обновление прошивки это не остановило, и подтверждённого исправления в теме на момент моего чтения не было. Маппер этого не вылечит, потому что это происходит ниже любого приложения. Попробуйте подключить геймпад кабелем, если он так подключается, попробуйте другой контроллер и сообщите о сбое в Apple вместе с журналами. Контроллер PS5, PS4, Xbox или Switch Pro либо один Joy-Con запускает тот же пресет Anki, пока вы разбираетесь.
Чего InputConfig не умеет
- Остановить буквы пульта в режиме клавиатуры. Он слушает клавиатуру и не блокирует и не переназначает клавишу, поэтому в режиме клавиатуры каждая буква всё равно доходит до Anki. С InputConfig используйте режим контроллера.
- Прочитать кнопку, которую геймпад оставляет себе. Star на Micro в режиме D Mac никогда не сообщается.
- Работать на iPad. InputConfig это приложение для Mac. На iPad у AnkiMobile своя поддержка контроллеров.
- Исправить сбой Bluetooth. Перезагрузка, вызванная ниже уровня приложений, это дело Apple и производителя геймпада.
Коротко
- Режим. D на Micro, A и Start на Zero 2, затем удалите запись и сопрягите заново.
- Проверка. Нажмите каждую кнопку в Live Visualizer. Элемент, который никогда не загорается, не доходит до Mac.
- Назначение. Активируйте встроенный пресет Anki и включите автоматическое переключение.
- Один маппер. Contanki или InputConfig, но не оба.
Начните с переключателя режима, потому что он объясняет большинство пультов Anki, которые кажутся мёртвыми.
Вопросы
Почему Anki пишет, что контроллер не обнаружен?
Это сообщение выдаёт дополнение Contanki. Обычная причина в том, что пульт сопряжён в режиме клавиатуры, то есть для Mac это клавиатура, и обнаруживать контроллер нечего. Переключите его в режим контроллера и сопрягите заново либо используйте системный маппер вроде InputConfig, который посылает Anki обычные нажатия клавиш.
Почему мой пульт печатает буквы вместо оценки карточек?
Он в режиме клавиатуры, K на 8BitDo Micro, и печатает буквы 8BitDo. Переключите его на D, сопрягите заново и активируйте пресет Anki в InputConfig, который посылает Space и 1-4.
Нужен ли Karabiner-Elements?
Только если вы держите пульт в режиме клавиатуры и хотите менять печатаемые им буквы. В режиме контроллера назначением занимается InputConfig или Contanki, а Karabiner-Elements не участвует.
Работает ли пульт Anki на iPad с InputConfig?
Нет. InputConfig это приложение для Mac. У AnkiMobile на iPad своя поддержка контроллеров, поэтому пульт может работать там и не работать на Mac.
Нужно ли дополнение?
Нет. InputConfig посылает обычные нажатия клавиш, а Anki больше ничего не нужно. Contanki это путь через дополнение, и работает любой из двух, но не оба сразу.
Ещё на русском
Подробные руководства на английском
Кто это пишет. Ryleigh Newman разрабатывает InputConfig и каждый день управляет своим Mac с помощью геймпада, потому что руки плохо слушаются. Эта страница переведена с английского. Если на Mac выбран русский язык, основные кнопки и меню приложения показываются по-русски; на этой странице они названы так же, с английским названием в скобках. Остальная часть приложения и сайта на английском языке.
Эта страница на других языках: English, Deutsch, Español, Français, Italiano, 日本語, 한국어, Polski, Português, ไทย, 繁體中文, 简体中文
Бесплатно. macOS 14 или новее. Без учётной записи, ничего не покидает ваш Mac. Исходный код на GitHub.