【亲测免费】 使用指南：BetterTouchTool JavaScript 管理工具（btt）

使用指南：BetterTouchTool JavaScript 管理工具（btt）

项目介绍

btt 是一个基于JavaScript的低级别 macOS 管理库，通过利用 BetterTouchTool 的内置Web服务器API，它为开发者提供了强大的自动化能力。这个开源项目由@Worie维护，允许用户以JavaScript脚本的形式控制和交互 macOS 操作系统，无需离开浏览器或在Node.js环境中运行。它支持从简单的事件监听到复杂的系统控制，例如切换勿扰模式、显示通知、控制夜灯模式、睡眠电脑等，并且可以自定义触控栏小部件和响应特定手势。

项目快速启动

安装

首先，确保你的机器上安装了至少v2.0.0版本的BetterTouchTool，并在偏好设置中启用并配置好Web服务器。然后，你可以通过npm轻松地安装btt包：

npm install btt

示例使用

创建一个新的JavaScript文件，并导入btt模块来开始操作：

// 导入btt模块
import { Btt } from 'btt';

// 创建一个代表btt web服务的实例
const btt = new Btt({
    domain: '127.0.0.1',
    port: 8000,
    protocol: 'http',
    version: '2.525'
});

// 异步执行一系列动作，如触发快捷键、输入文本和切换夜间模式
(async () => {
    await btt.triggerShortcut('cmd+space').invoke();
    await btt.sendText(['Hello world']).invoke();
    await btt.toggleNightShift().invoke();
})();

应用案例与最佳实践

自动化日常任务

可以利用btt脚本自动执行每日工作流程，比如定时提醒休息、自动调整屏幕亮度适应环境变化，或者一键完成复杂的多步骤操作。

// 假设你要在每天的工作开始时准备环境
async function startWorkday() {
    await btt.showHUD({ title: 'Workday Started', details: 'Focus Mode On' }).invoke();
    await btt.setDoNotDisturb(true).invoke(); // 开启勿扰模式
    await btt.setBrightness(70).invoke(); // 调整屏幕亮度至70%
}

startWorkday();

事件监听示例

注册一个系统范围内的事件监听器，当执行特定手势（如一指重按）时触发动作：

btt.addTriggerAction('oneFingerForceClick', (event) => {
    const actions = [
        btt.showHUD({ title: 'Force Click Detected', details: 'Action Performed' })
    ];
    event.actions.push(actions);
});

典型生态项目

虽然此项目本身是围绕BetterTouchTool构建的，但可以与其他JavaScript生态系统中的工具结合使用，比如前端框架或Node.js服务端开发，以实现更广泛的应用集成。对于希望进一步扩展功能，特别是实现高级事件监听的开发者，可探索btt-node-server，它提供了一个简易的Express服务器，使得在Node.js环境下处理事件成为可能，增强了安全性和灵活性。

btt项目不仅简化了macOS管理的复杂性，也为寻求高效系统级控制的开发者打开了新的大门。通过上述教程，开发者能够快速上手，探索出适合自己工作流的最佳实践。