Audioleaf

Nanoleaf Canvas的音乐可视化器。在Linux上与MPD（音乐播放器守护进程）配合使用效果最佳。

安装

使用cargo install audioleaf从 cargo 安装。请确保将 cargo 二进制文件的目录（默认为$HOME\.cargo\bin）添加到您的$PATH中。

对于基于Arch的发行版的用户，audioleaf也作为AUR中的软件包提供。您可以使用您选择的AUR助手安装它，例如使用yay： yay -S audioleaf。

配置

所有 audioleaf 的配置都通过位于 $HOME/.config/audioleaf 的 audioleaf.toml 文件进行。选项及其数据类型在此处描述

• fifo_path：.fifo 文件的路径，该文件将是可视化器的 PCM 数据源。
• sample_rate：音频文件的重采样率。
• n_samples：可视化器在一个批次中要取多少样本。
• max_volume_level：可视化器可以表示的最高音量级别。大于或等于 max_volume_level 的每个音量级别都将映射到给定面板的最亮颜色。
  • 上述的“音量级别”是指在一定时间间隔内包含的频率幅度的平均值。它并不直接对应于dB等物理单位。一般来说，这个数值不会超过15。同时请注意，它不依赖于您输出设备的音量（您所听到的音量）。
• brightness_range：一个介于0到100之间的实数值，用于指定音量级别变化时颜色亮度将如何变化。为了达到更“生动”的效果，应将其设置得较高。
• nl_config.ip：您的Nanoleaf设备的本地IP地址。
• port：UDP套接字将绑定的端口（在您的主机上）。
• token_file_path：audioleaf将查找Nanoleaf授权令牌的路径。
• primary_axis：面板将按此主要坐标排序。可能的值有x（左→右）和y（下→上）。
• sort_primary：面板在主要轴上的排序方向。可能的值有asc（升序）和desc（降序）。
• sort_secondary：同样，在次要轴上。
• active_panels：在可视化期间应该点亮的面板的编号列表。这些数字与前面提到的排序方法相关。例如，如果您首先按Y升序排序面板，然后按X降序排序，则第一个面板将位于您的设置的低右角，最后一个面板将位于高左角。
• trans_time：一个整数值，指定从一种颜色过渡到另一种颜色所需的时间（以100毫秒的倍数计算）。请注意，将此值设置得太高可能会导致过渡被其他过渡中断。一般来说，应将其保持在1或2。
• freq_ranges：一个对表(cutoff, color)，用于指定如何分割频率范围以及如何着色。这最好用一个例子来解释

[[freq_ranges]]
cutoff = 10000
color = "#ff0000"

[[freq_ranges]]
cutoff = 20000
color = "#0000ff"

在这个配置中，0到10000 Hz的频率将以一种红色的色调进行可视化，而10000到20000 Hz的频率将以一种蓝色的色调进行可视化。请注意，截止频率以Hz为单位指定，颜色以#rrggbb十六进制代码给出。

最后一个频率截止值必须至少等于sample_rate的一半。

频率范围的数目必须小于或等于active_panels的数目。

用法

重要：首次运行audioleaf时，请执行以下操作

• 按下并保持您的Nanoleaf控制面板的电源按钮大约5秒钟，直到图标开始依次闪烁。
• 当图标闪烁时，运行audioleaf <您的Nanoleaf设备的本地IP地址>（例如audioleaf 192.168.0.101）。您可以通过登录到WiFi路由器的管理面板并导航到“DHCP客户端”列表来找到该IP地址。您的Nanoleaf将有一个以00:55:DA:5开头的MAC地址。只需从那里复制其分配的IP地址即可。
• 如果一切顺利，audioleaf 将会通知你并退出。请检查你的 ~/.config 目录 - 将会存在一个包含两个文件（audioleaf.toml - 配置文件和 nltoken - 包含 Nanoleaf 认证令牌）的目录 audioleaf。

audio_output {
    type                    "fifo"
    name                    "my_fifo"
    path                    "/tmp/mpd.fifo"
    format                  "44100:16:2"
}