midi-app-controller

midi-app-controller是一个应用程序，允许用户使用USB MIDI控制器通过'pyapp-kit/app-model'控制所有应用程序。

文档

文档位于https://midi-app-controller.readthedocs.io/en/latest/。

用法（napari）

MIDI应用程序控制器是一个用于将MIDI控制器与使用app-model的Python Qt应用程序集成的软件包。目前，它最常与napari一起使用，napari是一个多维度图像查看器。我们将展示如何使用MIDI应用程序控制器与napari，但与其他应用程序的入门过程应该非常相似。

安装

要在已安装Python和napari的环境中安装MIDI应用程序控制器，请使用以下命令

pip install midi-app-controller

napari 会自动检测软件包并在下次启动时安装插件。

要安装最新开发版本，请克隆 GitHub 仓库并将其作为本地包安装（请参阅安装说明）。

设置

从 插件 菜单启动插件。

将打开一个侧面板。

控制器

如果您的 MIDI 控制器是直接支持的，您可以简单地选择适当的型号。如果不支持，您需要通过创建一个 控制器架构 来告诉 MIDI App Controller 如何与这种型号的控制器交互。

一旦选择了控制器架构，您就可以选择绑定架构。

MIDI 端口

如果它们没有自动选择，请选择与您的物理控制器对应的 MIDI 输入和输出端口。

开始处理

在选择控制器和绑定后，您可以点击“开始处理”。这将启动一个线程，监听控制器上的所有输入并调用相应的命令。您可以通过设置关闭面板，线程将在您点击“停止处理”之前在后台运行。

编辑绑定

点击“编辑绑定”以打开对话框，您可以在其中通过选择控制器上的哪些物理按钮和旋钮对应于应用程序中的哪些命令来配置绑定。这就像配置快捷键一样。

所有配置都是简单的 YAML 文件，您可以复制、分享或手动编辑。您可以通过点击“在资源管理器中显示”来查看当前选择配置文件的精确位置。您不应编辑存储在包目录中的内置预设；当您在图形用户界面中编辑内置预设时，会自动创建一个副本。

保存更改后，如果您已经开始了处理，您需要点击“重启处理”以启动一个新的服务器并应用更改。

无 GUI 的使用

该库也可以通过 StateManager 类的 singleton 控制。

from midi_app_controller.state.state_manager import get_state_manager

state = get_state_manager()
# Now the library can be controlled using `state`.

开发

安装

python3 -m pip install -e .

测试

python3 -m pip install -e .[testing]
python3 -m pytest --cov .

测试文档

mkdocs serve -a localhost:8080

使用 pre-commit

python3 -m pip install -e .[dev]
pre-commit install