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 应用,让你用来自 Meta Neural Band(一条肌电手环)的手势控制 Mac:在桌面之间滑动、打开调度中心、控制音乐,捏合并旋转可以调节音量或亮度。
这是菜单栏应用,还是在后台隐身运行的东西?它是一个菜单栏应用:你设置好手势映射并练习一次之后,它就常驻菜单栏。
怎么让它跑起来?下载 dmg,拖进 Applications,让手环进入配对模式,点击 「pair band」,用 Meta 登录一次,允许蓝牙和辅助功能权限,然后启用控制。
除了 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 之前配对过,在 系统设置 › 蓝牙 里忘记该设备,以避免配对问题。
Creator
callbacked
Size
1.8 MB
Stars
124
Age
1mo
Commits · 90 Days