系统
Macro Deck 自带在面板上控制电脑:应用、音量、命令、通知、睡眠和关机。
系统集成页面,开关已打开,没有配置选项
- 启动、聚焦或关闭应用程序、文件、文件夹和网站
- 默认音频设备或任意音频设备的音量和静音
- 运行命令并将其输出保存到变量中
- 锁定、睡眠、休眠、重新启动或关机
- 以变量提供 CPU、内存、GPU、磁盘、时间和前台应用
系统集成用于控制运行 Macro Deck 的电脑。它随 Macro Deck 一同提供,一开始就处于启用状态,在 Windows、macOS 和 Linux 上都无需任何设置。
可以做什么
- 应用、文件和网站: 启动应用程序 启动一个应用,其 模式 还可以将正在运行的应用切换到前台(启动或聚焦),或在第二次按下时将其关闭(启动 / 停止切换)。打开文件、打开文件夹 和 打开网站 会用默认应用打开相应内容。结束应用程序 按名称结束进程。
- 音频: 增大音量、减小音量、设置音量 和 静音 / 取消静音 可作用于默认输出设备、默认输入设备或某个特定设备。使用 静音 / 取消静音 的按键会显示设备是否已静音。
- 命令: 运行命令 在默认 Shell、PowerShell 或 Bash 中运行命令行,并可将其输出保存到变量中。
- 通知: 发送通知 显示操作系统的通知。显示 Macro Deck 通知 在所有已连接的屏幕上于 Macro Deck 中显示一条消息。
- 电源: 锁定电脑、睡眠、休眠、重新启动 和 关机。
变量
该集成以变量的形式报告电脑的状态:CPU、内存和 GPU 使用率,每个磁盘的容量、可用空间和活动,每个扬声器和麦克风的音量与静音状态,日期和时间,电脑名称和操作系统,屏幕是否已锁定,以及前台应用程序。可以在标签中显示它们,用 历史图表 或 仪表 组件绘制图表,或在自动化中对其做出响应。
示例设置
- 一个对耳机麦克风使用 静音 / 取消静音 的麦克风按键,显示其是否已静音。
- 一个绑定到
system_volume_percent的滑块,用于设置扬声器音量。 - 一个包含
system_cpu_usage_percent、system_ram_usage_percent和system_gpu_0_usage_percent的 仪表 组件。 - 一个对音乐播放器使用 启动应用程序 和 启动或聚焦 的按键。
- 一个“晚安”按键,运行 锁定电脑,或在 等待 后运行 关机。
- 一个流程,使用 运行命令 运行脚本,并将结果写入显示在按键上的变量。
新的音频设备和磁盘在插入后几秒内就会有对应的变量。
准备工作
- Windows、macOS 或 Linux 上的 Macro Deck 3
- 在 Linux 上:音量需要 pactl 或 amixer,通知需要 notify-send,电源动作需要 systemd
- 在 Linux 上,GPU 使用率需要 amdgpu 驱动或 nvidia-smi
- 在 macOS 上,重新启动和关机需要允许 Macro Deck 控制 System Events
设置步骤
第 1 步: 确认集成已启用
在 Macro Deck 中,点击侧边栏中的 集成,然后点击 系统。右上角的开关默认处于打开状态;如果已关闭,请将其打开。无需任何设置:概览 选项卡会显示 此集成没有可用的配置选项。 如果电脑上缺少某些组件(例如 Linux 上的音量后端),页面会将其列为问题。
第 2 步: 为按键添加系统动作
在 面板 页面上点击一个按键。面板必须处于解锁状态:右上角显示 锁定 按钮时,面板即为解锁状态。编辑器打开时已选中 短按。点击 + 添加动作,在 添加动作 对话框左侧选择 系统,然后选择一个动作,例如 静音 / 取消静音 或 启动应用程序。
第 3 步: 填写动作
每个动作只要求填写其所需的内容:
- 启动应用程序:应用程序、可选的 参数 和 工作目录,以及 模式。
- 音量动作:音频设备,以及 幅度 (%) 或 音量 (%)。
- 运行命令:Shell 和 命令,可选 将输出保存到变量。
第 4 步: 在按键上显示值
如需显示某个值,请在按键标签中输入变量,例如
CPU {{ vars.system_cpu_usage_percent }} %。系统页面的 变量 选项卡会列出每个系统变量及其当前值。第 5 步: 按下按键
保存后按下该按键,或者在编辑器中点击 运行 立即试用这些动作。
动作17
可以放在按键上,也可以在流程中运行。
- 启动应用程序
- 启动一个应用程序,或切换/聚焦一个正在运行的实例。
- 打开网站
- 在默认浏览器中打开网站。
- 打开文件
- 用默认应用程序打开文件。
- 打开文件夹
- 在系统自带的文件管理器中打开文件夹。
- 结束应用程序
- 按名称结束正在运行的进程,可选择先请求其关闭窗口。
- 增大音量
- 提高所选音频设备的音量。
- 减小音量
- 降低所选音频设备的音量。
- 静音 / 取消静音
- 切换所选音频设备的静音状态,并在按键上显示。
- 设置音量
- 将所选音频设备的音量设为特定值。
- 发送通知
- 显示操作系统的原生通知。
- 显示 Macro Deck 通知
- 在已连接的设备和应用上于 Macro Deck 中显示一条消息,形式为短消息或对话框。
- 运行命令
- 在所选 Shell 中运行命令行,并可将其输出保存到变量中。
- 锁定电脑
- 锁定屏幕,需要输入密码或 PIN 才能重新进入。
- 睡眠
- 让电脑进入睡眠状态。
- 休眠
- 将会话保存到磁盘并完全断电(Windows 和 Linux)。
- 重新启动
- 重新启动电脑,开启 强制 可忽略会阻止重启的应用。
- 关机
- 关闭电脑,开启 强制 可忽略会阻止关机的应用。
变量12
在按键和组件上显示这些值,或在条件中使用它们。
system_volume_percent,system_muted- 默认输出设备的音量百分比和静音状态。
system_input_volume_percent,system_input_muted- 默认输入设备的音量百分比和静音状态。
system_audio_output_<device>_*,system_audio_input_<device>_*- 每个扬声器和麦克风的音量百分比(
_volume_percent)和静音状态(_muted),例如system_audio_input_usb_mic_muted。 system_cpu_usage_percent,system_cpu_name- 处理器负载百分比和处理器型号。
system_ram_usage_percent,system_ram_used_gb,system_ram_total_gb- 内存使用率百分比,以及以 GB 为单位的已用内存和内存总量。
system_gpu_<n>_usage_percent,system_gpu_<n>_name- 每块显卡的负载百分比和名称,从
0开始编号,最多八块显卡。 system_disk_<n>_*- 每个磁盘的名称、挂载点、文件系统、容量、已用和可用空间、使用率、读写速度和活动,从
0开始编号,最多八个磁盘。 system_date,system_time,system_datetime- 以文本表示的当前日期、时间以及日期和时间。
system_timestamp_unix,system_day_of_week,system_hour,system_minute- 当前时间的各个部分:Unix 时间戳、星期、小时和分钟。
system_pc_name,system_os- 电脑名称和操作系统。
system_locked- 电脑是否已锁定(Windows 和 macOS)。
system_focused_app,system_focused_app_path,system_focused_app_bundle_id- 前台应用程序及其路径和包 ID。
常见问题解答
可以控制某个特定设备的音量吗?
可以。每个音量动作都有一个 音频设备 字段,其中包含默认输出设备、默认输入设备以及 Macro Deck 检测到的每台设备。拔出的设备仍会保留在列表中,其变量在设备重新接入之前显示为不可用。
可以用滑块设置音量吗?
可以。将滑块绑定到 system_volume_percent 等音量变量即可。也可以用 设置变量 设置音量和静音变量。如需用一个按键开关静音,请使用 静音 / 取消静音。
为什么在 macOS 上“重新启动”或“关机”会失败?
macOS 会先请求权限。请在 系统设置 > 隐私与安全性 > 自动化 > System Events 中允许 Macro Deck。强制 在 macOS 上无效,macOS 也没有 休眠。
为什么在 Linux 上缺少音量、通知或电源动作?
它们需要一些发行版不会默认安装的工具:音量需要 pactl(PulseAudio 或 PipeWire)或 amixer,通知需要 notify-send,电源动作需要 systemctl 或 loginctl。集成 下的 系统 页面会列出缺少的内容。
“运行命令”会等待多久?
最多等待 超时(秒),默认为 30 秒,0 表示一直等到命令退出。超时后仍在运行的命令会继续运行,除非将其输出保存到变量中。
Macro Deck 2 中的 Windows Utils 按键会被迁移过来吗?
大部分会。从 Macro Deck 2 迁移时,启动应用程序、打开文件或文件夹、命令行和音量等动作会变成系统动作,热键和输入的文本会变成 键盘 动作。
“你的电脑”分类中的更多集成
键盘
Macro Deck 自带通过按键在电脑上按下快捷键、输入文本和运行按键序列。
鼠标
Macro Deck 自带通过按键在电脑上点击、移动指针、拖动和滚动。
ADB / Android Debug Bridge
Macro Deck 自带通过 USB 或 Wi-Fi 控制 Android 手机或平板:唤醒设备、启动应用、点击、输入文本和截图。
Steam
Macro Deck 自带启动和关闭 Steam 游戏,并在面板上显示正在玩的游戏、好友和游戏库。