🎧 Auto8D Studio

将普通音乐一键转化为母带级 8D 沉浸式全景环绕声的极客桌面端神器。

Auto8D Studio 结合了 Web 技术的灵活性、Rust 的系统级调度与底层 Python 声学引擎的强大算力。无需任何复杂的环境配置，下载即用，让你的音乐瞬间拥有颅外空间的物理级环绕感。

✨ 核心特性

• 📦 开箱即用：基于 Tauri Sidecar 架构打包。内部已封装高度定制的 Python 引擎与 FFmpeg，用户无需安装 Python 环境即可运行。
• 🎛️ 极客级调音台：开放 9 大核心声学参数控制（包括环绕周期、空间增益补偿、基于频段的 HRTF 滤波、专业级混响系统等）。
• 🚀 智能批量任务：支持多文件一键导入、顺序队列处理，并实时反馈精准的转换进度。
• 🧠 无感底层优化：
  • 智能码率雷达：自动侦测源文件码率并等质输出，拒绝低音质文件无意义的体积膨胀。
  • 文件防锁机制：自动处理输出重名冲突（追加 _1），彻底告别因 Windows 文件占用导致的闪退崩溃。
  • 无损元数据：完美剥离并重新缝合原曲的专辑封面 (ID3) 与歌曲信息。
• 🌐 多语言支持：内置 简体中文与 English，无缝实时切换。

📥 安装与使用

1. 前往右侧的 Releases 页面。
2. 下载最新版本的 .msi 或 .exe 安装包。
3. 双击安装，添加音频文件，带上耳机，享受极致的空间沉浸感。

🏗️ 架构与本地开发

本项目采用了极致轻量的 Tauri + Rust + Python (Sidecar) 混合架构。

开发环境依赖

• Node.js (用于前端 Vite + TS)
• Rust (用于后端调度与系统交互)
• Python 3.12 (用于本地运行声学引擎)
• FFmpeg (用于音频编解码与元数据缝合)

初始化与运行

1. 克隆本仓库：

   git clone https://github.com/AstridStark25963/Auto8D-Studio.git
   cd auto8d-studio
   npm install

2. 安装 Python 引擎依赖：

   cd src-tauri
   pip install numpy soundfile pedalboard

3. 智能环境嗅探开发流：

   本项目在 Rust (main.rs) 中实现了宏条件编译。

   当你在终端运行开发命令时，Rust 会自动调用本地的 auto8d.py 脚本，实现修改 Python 代码即时生效，无需重新编译：

   npm run tauri dev

终极打包构建

准备发布独立安装包前，需要将 Python 引擎编译为独立的二进制文件：

1. 使用 PyInstaller 编译引擎：

   cd src-tauri
   pyinstaller --noconfirm --onefile --console auto8d.py

2. 建立弹药库：

   将编译产出的 dist/auto8d.exe 以及你下载好的 ffmpeg.exe，统一放入新建的 src-tauri/bin/ 文件夹中。

3. 执行终极封包：

   npm run tauri build

   在 Release 模式下，Rust 会自动切换逻辑，将 bin 目录下的引擎静默缝合进最终的安装包中。

📄 开源协议

MIT License