kinesis README

The project's README from github.com/callbacked/kinesis. As one markdown file: README.md.

kinesis

kinesis

use your meta neural band to control your mac

https://github.com/user-attachments/assets/43ed6094-5c66-4992-aacd-e010dae3f4fa

swipe between desktops, open mission control, control your music, and pinch + turn for volume or brightness. pick your own mappings, practice in setup, then keep it in the menu bar.

built on some tinkering i did with astra in neural-band-poc (feel free to go through that repo to do your own thing), so naturally i wanted to harness it to make it do something useful

some things may act quirky or not work at all, if that is the case i would love to know why, but this is all highly experimental

run it

factory reset your band before you get started (hold its button for about 16 seconds), so it starts fresh

if this mac was paired with the band before, forget it under system settings › bluetooth too. an old entry there can cause pairing issues

download kinesis, open the dmg, and drag it into applications. needs macos 14+ and a neural band. works on apple silicon and intel.

set your band in pairing mode, hit pair band, and sign in with meta once. allow bluetooth + accessibility when prompted, and accept the bluetooth pairing request from macos. enable controls and you're in.

why the meta sign-in

the band only works with an owner that meta has enrolled. the meta ai app does that enrollment when you set up a band, and kinesis does the same enrollment for your mac. it opens meta's own sign-in page once and keeps the session token in your keychain. it only gets that token, not your password. once the band is enrolled, connecting doesn't need meta. forget this band clears the key and the sign-in.

build it

xcode with swift 6.

git clone https://github.com/callbacked/kinesis.git
cd kinesis
./scripts/build.sh
open dist/Kinesis.app

quit kinesis before rebuilding. ./scripts/build.sh --dev builds the same app with experiments and developer tools in it.

license

mit.

kinesis (callbacked/kinesis)

Searching Database…

Что это?Kinesis — нативное macOS-приложение, позволяющее управлять Mac жестами с Meta Neural Band (EMG-браслета): свайпы между рабочими столами, открытие Mission Control, управление музыкой, а щипок с поворотом — для громкости или яркости.
Это приложение в строке меню или что-то невидимое, работающее в фоне?Это приложение в строке меню: вы один раз настраиваете привязки жестов и тренируете их, а дальше оно живёт в строке меню.
Как его запустить?Скачайте dmg, перетащите в Applications, переведите браслет в режим сопряжения, нажмите 'pair band', один раз войдите через Meta, разрешите Bluetooth и Accessibility, затем включите управление.
Какое железо нужно, кроме Mac?Нужен Meta Neural Band и macOS 14 или новее; работает и на Apple Silicon, и на Intel Mac.
Всё ли работает надёжно?Нет, автор называет его «в высшей степени экспериментальным» и отмечает, что некоторые жесты или функции могут капризничать или не работать вовсе.
Нужен ли Apple Silicon или он работает и на Intel Mac?Работает и на Apple Silicon, и на Intel Mac, если стоит macOS 14 или новее.
Зачем нужен вход через Meta и к чему он получает доступ?Meta привязывает браслет к владельцу, поэтому Kinesis выполняет ту же привязку для вашего Mac, один раз открывая страницу входа Meta и сохраняя токен сессии в вашей связке ключей; он получает только этот токен, но не пароль, а «forget this band» его стирает.
Нужно ли заново авторизоваться в Meta при каждом подключении браслета?Нет, после первичной привязки последующее подключение не требует повторного входа в Meta; он нужен только при самой первой привязке.
Откуда взялся этот проект?Он вырос из ранних экспериментов автора в репозитории 'neural-band-poc' с 'astra', которые затем превратились в это более полезное приложение для управления Mac.
Что сделать перед первым сопряжением браслета?Сбросьте браслет до заводских настроек, удерживая его кнопку около 16 секунд, а если Mac уже сопрягался раньше, забудьте его в System Settings › Bluetooth, чтобы избежать проблем с сопряжением.
Creator
callbacked
Size
1.8 MB
Stars
122
Age
1mo
Commits · 90 Days