← Все проекты
Проект / TypeScript

wong2/vibe-ring: Vibe Ring — преврати Ring-Con в макросы для macOS

Используй кольцо от Nintendo Ring Fit как физическую кнопку Fn и Enter на Mac.

Это TypeScript-утилита, которая превращает игровой аксессуар Ring-Con в контроллер клавиатуры для Mac. Она парсит HID-данные с джойстика, определяет степень сжатия/растяжения кольца и отправляет соответствующие кейкоды через macOS CGEvent API.

★ 20 TypeScript Форки 1 Issue 0 Оценка 6/10 Карточка проверена

Для кого это

Для гиков, стримеров и любителей нестандартных контроллеров, которые хотят добавить физическое взаимодействие в рабочий процесс на macOS.

Проблема / задача

Стандартные клавиатуры не дают тактильного удовольствия и уникального способа запускать действия — например, делать скриншоты сжатием кольца или подтверждать команды его растяжением.

Как это работает

Программа подключается к Joy-Con (R) с Ring-Con по Bluetooth, считывает данные с датчика изгиба кольца и через Swift-хелпер эмулирует нажатия клавиш Fn (удержание при сжатии) и Enter (короткое нажатие при растяжении). Всё работает в терминале, требует разрешения на доступность в настройках macOS.

Что видно по README

Это TypeScript-утилита, которая превращает игровой аксессуар Ring-Con в контроллер клавиатуры для Mac. Она парсит HID-данные с джойстика, определяет степень сжатия/растяжения кольца и отправляет соответствующие кейкоды через macOS CGEvent API.

Ключевые возможности

Сжатие кольца удерживает FnКороткое растяжение имитирует EnterАвтоподключение при потере связиНастраиваемые пороги срабатывания датчика

Технологии

TypeScriptSwift (CGEvent API)node-hidBluetooth HIDNode.jsGo

Интересный факт

Проект использует тот же слот данных, что и акселерометр Joy-Con — датчик изгиба кольца подменяет показания оси Y в третьем кадре IMU.

С чего начать

  • Установи Node.js 18+ и pnpm
  • Дай терминалу доступ в Настройки → Безопасность → Универсальный доступ
  • Запусти pnpm start и сжимай кольцо

Оценка GitRadar

Удобство
6/10
Свежесть
8/10
Перспектива
5/10
Монетизация
3/10
Общая оценка
6/10

Вердикт GitRadar

Стоит попробовать, если у вас валяется Ring-Con и Mac — это забавный эксперимент, но для повседневного использования потребуется тонкая настройка и привыкание.

Наблюдения по обновлениям

Проект свежий (20 звёзд, 1 форк), но активность низкая — последние коммиты могли быть давно. README подробный, но issue нет.

Что мы проверили

Карточка собрана по данным GitHub, README и структуре репозитория. Это не официальная документация проекта.

Исходный репозиторий
https://github.com/wong2/vibe-ring
Создан на GitHub
12 апреля 2026 г.
Последнее обновление репо
12 апреля 2026 г.
Последняя проверка GitRadar
12 апреля 2026 г.
Изученные файлы
README.md, src/main.ts, package.json, src/crc8.ts, src/keyboard-helper.swift, src/keyboard.ts

FAQ

Что это такое?

Утилита, превращающая кольцо от Nintendo Ring Fit в две клавиши для Mac.

Для кого подходит?

Для любителей нестандартных контроллеров, стримеров и гиков, ищущих новый способ взаимодействия с компьютером.

Источники

  • GitHub исходный код и активность
  • README описание, ссылки, стартовые материалы

Нужна помощь с wong2/vibe-ring?

Если проект подходит под ваш сценарий, можем помочь с установкой, интеграцией, доработкой или аккуратным форком под вашу инфраструктуру.