智能吉他音箱

基于 JUCE 构建的吉他插件，利用神经网络模型来模拟真实硬件的声音。

观看 YouTube 上的视频演示

该插件使用 WaveNet 模型来重现真实硬件的声音。当前版本模拟了一款小型电子管放大器在干净和过载两种音色下的表现。此外，还增加了增益和均衡旋钮，以调节模拟声音的特性。

您可以通过少量代码修改，创建自己的模型并将其加载到 SmartGuitarAmp 中。要训练自己的模型，请使用 PedalNetRT。

模型训练是在预先录制好的 .wav 样本上使用 PyTorch 完成的。更多信息请参阅上述仓库。如果您希望分享自己优秀的模型，请将 JSON 文件发送至 smartguitarml@gmail.com，这些模型可能会被纳入最新版本，并以可下载的压缩包形式提供。

另请参阅配套插件 SmartGuitarPedal
注意：自 SmartAmp 1.3 版本起，为简化插件功能，已移除自定义模型加载功能。如需加载用户训练的模型，请使用 SmartGuitarPedal，它支持所有通过 PedalNetRT 训练的模型。

插件安装步骤

1. 从 Releases 页面下载适用于您的操作系统的插件安装程序（Windows、Mac、Linux）。
2. 运行安装程序并按照提示操作。可能需要重启计算机，以便您的 DAW 能识别新插件。

构建说明

使用 CMake 构建

# 克隆仓库
$ git clone https://github.com/GuitarML/SmartGuitarAmp.git
$ cd SmartGuitarAmp

# 初始化并设置子模块
$ git submodule update --init --recursive

# 使用 CMake 构建
$ cmake -Bbuild
$ cmake --build build --config Release

生成的二进制文件将位于 SmartAmp/build/SmartAmp_artefacts/ 目录下。

许可证

本项目采用 Apache License, Version 2.0 许可证授权——详情请参阅 LICENSE 文件。

本项目基于 WaveNetVA 的工作成果。

本插件中使用的均衡器代码参考了 Michael Gruhn 在 4BandEQ 算法中的研究成果。

SmartGuitarAmp 快速上手指南

SmartGuitarAmp 是一款基于 JUCE 框架开发的吉他效果器插件，利用 WaveNet 神经网络模型模拟真实电子管音箱的音色（包含清音和过载模式），并提供增益（Gain）和均衡（EQ）调节功能。

环境准备

系统要求

• 操作系统：Windows, macOS, 或 Linux
• 宿主软件 (DAW)：支持 VST3、AU 或 LV2 格式的音频工作站（如 Reaper, Cubase, Logic Pro 等）
• 硬件：建议具备独立显卡以加速模型训练（仅针对开发者），推理阶段对 CPU 有一定要求。

前置依赖（仅限源码编译）

若需从源码构建，请确保安装以下工具：

• Git
• CMake (版本 3.15+)
• C++ 编译器 (GCC, Clang, 或 MSVC)
• JUCE 框架（项目通过 submodule 自动管理，无需单独安装）

安装步骤

方式一：直接安装（推荐普通用户）

1. 访问 Releases 页面。
2. 下载对应操作系统的安装包（Windows .exe / .zip, Mac .dmg / .pkg, Linux .deb / .tar.gz）。 注：国内用户若下载缓慢，可尝试使用镜像加速工具或代理。
3. 运行安装程序并按提示完成安装。
4. 重要：安装完成后可能需要重启电脑或重启 DAW，以便宿主软件识别新插件。

方式二：源码编译（适合开发者）

如需自定义功能或调试，可使用 CMake 进行构建：

# 克隆仓库
$ git clone https://github.com/GuitarML/SmartGuitarAmp.git
$ cd SmartGuitarAmp

# 初始化并更新子模块 (包括 JUCE 等依赖)
$ git submodule update --init --recursive

# 配置 CMake 构建目录
$ cmake -Bbuild

# 执行编译 (Release 模式)
$ cmake --build build --config Release

编译完成后，插件二进制文件位于： SmartAmp/build/SmartAmp_artefacts/ 将生成的插件文件复制到系统的 VST/AU/LV2 插件目录即可。

基本使用

1. 加载插件：打开你的 DAW，在效果器列表中找到 SmartGuitarAmp 并将其加载到吉他音轨上。
2. 选择音色：插件内置了模拟小型电子管音箱的模型。通过界面切换 Clean（清音）或 Overdriven（过载）模式。
3. 调节参数：
   • Gain：调节输入增益，控制失真程度。
   • EQ：调节高、中、低频均衡，塑造音色风格。
4. 关于自定义模型：
   • 自 v1.3 版本起，SmartGuitarAmp 移除了直接加载用户自定义模型的功能以简化架构。
   • 如需使用通过 PedalNetRT 训练的个人模型，请使用配套插件 SmartGuitarPedal。

提示：如果你有优秀的训练模型（JSON 文件），可发送至 smartguitarml@gmail.com，作者可能会将其收录进后续发布的官方模型包中。