MidiBoard

使用任何 MIDI 1.0 兼容设备触发任意命令的 CLI 工具。

• 1. 这是什么？
• 2. 入门
• 3. 安装
  • 3.1. Cargo
  • 3.2. 手册
• 4. 配置
  • 4.1. 创建骨架
  • 4.2. 定义你的设备
  • 4.3. 定义每个命令
• 5. 运行
  • 5.1. 手动
  • 5.2. 作为守护进程运行

1. 这是什么？

该工具允许用户将任何可执行命令与一个或多个 MIDI 设备中的动作关联起来，例如在按下按钮或旋转旋钮时改变音量、调整背光级别、更改曲目、启动/停止服务或启动任何脚本/可执行文件。

2. 入门

要使用此软件，您需要安装它，定义配置，然后可以随意运行或守护进程化该进程。当然，最繁琐的部分是编写配置文件。

有关详细信息，请参阅 文档。

3. 安装

3.1. Cargo

cargo install midiboard

3.2. 手册

1. 克隆

   git clone https://github.com/aordano/midiboard.git
   

2. 构建

   cd midiboard
   cargo build --release
   

3. 复制二进制文件

   sudo cp ./target/release/midiboard /usr/bin/midiboard
   

4. 配置

有关配置文件的详细信息，请参阅 配置文档页面。

有关使用 CLI 的帮助，可以通过 --help 标志获得内置帮助。

4.1. 创建骨架

这将创建在 $HOME/midiboard.json。您可以选择使用 --path 标志更改输出位置

midiboard config --generate

4.2. 定义你的设备

获取你的设备名称并将其放入配置中的 device 字段

midiboard devices --list

4.3. 定义每个命令

监听输入以了解所选旋钮/按钮/键的数字键值

midiboard devices --input [DEVICE_NAME]

使用该值，您可以在配置文件中填写相应的条目。

5. 运行

5.1. 手动

默认情况下，它将在 $HOME/midiboard.json 位置查找配置文件。可选地添加 --path 标志以更改输出位置

midiboard run

5.2. 作为守护进程运行

1. 获取服务文件

   wget -O midiboard.service https://raw.githubusercontent.com/aordano/midiboard/master/schema/midiboard.service
   

2. 修补并移动服务文件

   sed -i "s/@USER@/$(whoami)/g" midiboard.service
   sudo mv midiboard.service /etc/systemd/system/midiboard.service
   

   该文件使用默认的配置文件位置。如果您有配置文件的备用路径（添加 --path 标志）请修改服务文件。

3. 启用服务

   sudo systemctl daemon-reload
   sudo systemctl enable --now midiboard