#5610 [WARNING] [SpeedRate] Rubberband 不可用，将使用pydub+ffmpeg处理音频加速。

这是 Rubberband 音频加速算法未安装或未正确配置导致的警告。软件已自动回退到 FFmpeg atempo 方案，功能仍可正常使用，但加速质量会略低（可能产生轻微音质损失）。

若希望启用更平滑的 Rubberband 加速，请按以下步骤操作：

Windows 用户

1. 下载 rubberband-4.0.0-gpl-executable-windows.zip
2. 解压后将 rubberband.exe 放入软件根目录下的 ffmpeg/ 文件夹中（与 ffmpeg.exe 同目录），重启软件即可。

macOS 用户

brew install rubberband
uv add pyrubberband

Linux 用户

sudo apt install rubberband-cli libsndfile1-dev
uv add pyrubberband

若不想安装，可忽略此警告，软件会继续使用 FFmpeg atempo 正常处理。

windows 代码部署安装到哪里

Windows 源码部署流程如下：

1. 安装依赖

   • Python 3.10（建议使用）
   • uv 包管理器（pip install uv）
   • FFmpeg：将 ffmpeg.exe / ffprobe.exe 放入系统 PATH 或项目根目录下的 ffmpeg/ 文件夹
   • libsndfile：Windows 下可通过 uv add pysoundfile 自动处理

2. 克隆仓库并安装
   在命令行执行：

   git clone https://github.com/jianchang512/pyvideotrans
   cd pyvideotrans
   uv sync

   如需安装可选本地渠道（如 Qwen-ASR、F5-TTS 等），可追加 --all-extras 或单独的 --extra qwentts 等。

3. 启动

   uv run sp.py

注意：

• 项目目录所在路径 不要包含中文、空格或特殊符号（推荐 D:\pyvideotrans）。
• 首次运行会下载模型（约2~5分钟），请保持网络通畅。
• 如使用 NVIDIA 显卡并希望 GPU 加速，需额外安装 CUDA 12.8+ 和 cuDNN 9.11+。