SoundRecord

English README · Roadmap · Manual test plan

SoundRecord 是一个轻量的 Windows 系统声音录制工具。它通过 WASAPI Loopback 录制默认播放设备的混音，并导出可用于 Soundpad 等工具的 WAV 或 MP3 文件。

功能

• 录制 Windows 默认扬声器或耳机正在播放的系统声音；
• 开始、暂停、继续、停止并保存、取消；
• WAV（48 kHz / 16-bit / 双声道）或 192 kbps MP3；
• 可选峰值标准化（约 -1 dBFS）；
• 自定义保存位置与文件名前缀，设置会在下次启动恢复；
• 默认设备变化时安全结束并尽量保留已录片段；
• 不需要管理员权限、驱动、虚拟声卡或网络连接。

请仅录制你有权使用的内容，并遵守所在地区法律及平台规则。程序不尝试规避 DRM 或内容保护。

使用

下载发布包并解压，保留 SoundRecord.exe 和同级 _internal 文件夹，然后运行 SoundRecord.exe。无需安装 Python。

1. 选择保存位置，可设置文件名前缀；
2. 选择 WAV 或 MP3，按需启用峰值标准化；
3. 播放需要录制的音频后点击“开始录制”；
4. 点击“停止并保存”，随后可点击“打开保存位置”。

开发

需要 Windows 10/11 与 Python 3.12 或 3.13。

py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"
ruff format --check .
ruff check .
pytest --basetemp .test-tmp --cache-clear

构建 Windows x64 发布版：

python -m PyInstaller --noconfirm --clean --windowed --onedir --collect-data imageio_ffmpeg --collect-binaries imageio_ffmpeg --exclude-module PySide6.QtQml --exclude-module PySide6.QtQuick --exclude-module PySide6.QtPdf --exclude-module PySide6.QtOpenGL --name SoundRecord src/soundrecord/__main__.py

产物在 dist/SoundRecord/。提交前请运行上述检查，并在真机执行手工测试计划。

状态与后续计划

当前版本为 1.0.0。已完成与待做功能见 Roadmap。

开源许可

本项目使用 MIT License。你可以使用、复制、修改、分发和商业使用代码，但必须保留版权与许可证文本；软件按“现状”提供，不附带担保。详见 LICENSE。