Fable助力打造音乐可视化工具Waveloop：呈现独特音乐结构，代码与视频皆有亮点

Waveloop：Fable的成果展现

2026年6月，在使用Fable 5的两天里，它帮助打造了一个音乐可视化工具Waveloop，实现了长久以来的梦想。可在[Waveloop](https://saltblock.neynt.ca/waveloop.html)查看。

音乐可视化工具的现状与Waveloop的创新

大多数音乐可视化工具只能让用户大致了解音量大小和低音/高音分布，无法直观呈现音乐的和声与旋律结构。而西方自然音阶音乐理论的基础是¹²√2，十二个半音构成一个八度。Waveloop通过半音间隔为30°、每八度旋转一圈的半音圈呈现这种循环结构，音乐瞬间以螺旋堆叠直方图形式呈现，不同层用不同颜色表示不同八度，在Oklch色彩空间描绘出螺旋线。

Waveloop呈现方式的优点

一是可以直接将音程看作角度，如小二度（m2）对应30°，大二度（M2）对应60°等。二是可以从和弦的形状判断其性质，转调使形状旋转，转位不改变形状，常见和弦性质如大和弦（maj）为0 * 4 * 7等。

Waveloop的运行模式与性能表现

Waveloop主要以离线方式运行，为特定曲目预先计算常量Q变换（CQT）。Fable还添加了实时麦克风模式，开启后能快速且可靠地识别弹奏的尤克里里和弦。

回顾Waveloop代码的特点

查看waveloop代码时，发现其十分紧凑。代码注释简洁明了，专业性强，融合了预乘透明度和基频等概念，还喜欢用首字母缩写词。同时颇具文学性，将音乐音级与时钟刻度类比，用“徘徊”“涌出”等词生动表达。其和弦检测函数可靠且代码量少。

Fable制作讲解视频的过程

提了三次需求制作基于Manim的讲解视频。第一次需求后视频效果差，给出反馈改进，包括更换配音、减少噪音、增加生成音效、深入讲解数学细节、让脚本更像日常对话、少用文字多用视觉效果等。之后又提了清理优化请求，如规范数学公式排版、确定统一说话声音、确保图表不重叠等，最终完成视频。虽然视频不算特别出色，但能吸引十分钟注意力。

AI使用声明

用Claude生成了图表的SVG文件，但所有文字内容都是自己写的。