deej 开源项目安装与使用指南

deej 开源项目安装与使用指南

deej Set app volumes with real sliders! deej is an Arduino & Go project to let you build your own hardware mixer for Windows and Linux 项目地址: https://gitcode.com/gh_mirrors/de/deej

1. 项目目录结构及介绍

deej 是一个结合 Arduino 和 Go 语言的开源项目，允许用户构建自己的硬件混音器，适用于 Windows 和 Linux 系统。以下是该项目的基本目录结构概览及其重要组件介绍：

• ./ 根目录下：
  • arduino: 包含用于Arduino的C代码，用于处理硬件滑块的输入。
  • assets: 可能存储项目相关的一些资源文件。
  • docs: 文档资料，可能包括用户手册或者开发指南。
  • pkg/deej: Go语言编写的轻量级桌面客户端代码。
  • .gitignore: Git忽略文件，定义了哪些文件不应被版本控制系统跟踪。
  • LICENSE: 许可证文件，该项目遵循MIT许可证。
  • README.md: 项目的主要说明文件，包含简介和快速入门信息。
  • config.yaml: 配置文件示例，用于设定应用与滑块的映射关系。

2. 项目的启动文件介绍

在deej项目中，并没有传统意义上的“启动文件”作为单独实体存在。不过，从其架构来看，启动过程涉及两部分：Arduino端的固件和Go语言编写的PC客户端。

• Arduino端：你需要将位于arduino/目录下的固件上传到Arduino板上，这可以视为硬件启动的一部分。
• Go客户端：软件端的启动通常指运行deej这个可执行程序。该程序应该是通过Go编译得到的结果，位于项目构建后的输出目录中。执行它便启动了deej的控制台或后台服务，监听来自Arduino的信号并调整系统或应用程序的音量。

3. 项目的配置文件介绍

配置文件名：config.yaml

• 作用：配置文件用于定义滑块与具体应用程序、设备或系统声音的映射关系，以及连接设置，如COM端口、波特率等。
• 结构：

  slider_mapping:
    0: master  # 控制主音量
    1: chrome.exe
    2: spotify.exe
    ...
    invert_sliders: false  # 是否反转滑块控制（顶部为0%，底部为100%）
    com_port: COM4  # Arduino与电脑连接的串口
    baud_rate: 9600  # 串口通信速率
    noise_reduction: default  # 噪声减少级别
  

每个条目指定一个滑块编号及其对应的应用程序或特定的系统设置。例如，滑块0通常绑定为主音量控制，而其他滑块可以绑定到不同的应用程序（如Chrome或Spotify）或特殊选项（如系统声音）。此文件支持热加载，即修改后无需重启deej即可生效。

为了成功使用deej，确保正确配置config.yaml以匹配您的硬件设置和所需应用控制需求。项目文档还建议加入其Discord服务器以获取即时帮助和社区支持。

deej Set app volumes with real sliders! deej is an Arduino & Go project to let you build your own hardware mixer for Windows and Linux 项目地址: https://gitcode.com/gh_mirrors/de/deej