StemRoller

StemRoller 是首款免费应用，只需点击一下即可从任何歌曲中分离人声和伴奏音轨！StemRoller 使用 Facebook 最先进的 Demucs 歌曲分离算法，并集成了 YouTube 的搜索结果。

只需在搜索栏中输入任意歌曲的名称或歌手，然后点击搜索结果中出现的 Split 按钮即可！分离过程需要等待几分钟。当音轨提取完成后，你会在歌曲旁边看到一个 Open 按钮——点击它即可访问你的音轨！

我们还有一个 Discord 服务器，用于发布更新公告和提供支持。

快速入门

使用 StemRoller 非常简单——只需前往 StemRoller 官网 或 发布页面，下载最新版本即可！该安装包包含了分离音轨所需的一切。不过，如果你想参与 StemRoller 的开发，请继续阅读……

安装依赖

git clone https://github.com/stemrollerapp/stemroller.git
cd stemroller
npm i -D

Windows/macOS

npm run download-third-party-apps

Linux（未正式支持）

请使用你喜欢的包管理器全局安装 ffmpeg，并使用 pip 全局安装 demucs 和 yt-dlp。如果遇到“找不到合适的后端”错误，可以尝试安装 libsox-dev。

开发模式运行

npm run dev

生产模式运行

npm run build:svelte && npm run start

生产构建

Windows

npm run build:win

macOS

npm run build:mac

许可证

您可以选择公共领域（Unlicense）或 MIT 无署名许可——更多信息请参阅 LICENSE 文件。

StemRoller 快速上手指南

StemRoller 是一款免费开源工具，基于 Facebook 的 Demucs 算法，支持一键分离歌曲的人声与伴奏，并集成 YouTube 搜索功能。

环境准备

系统要求：

• Windows / macOS：官方支持，可自动下载所需第三方应用。
• Linux：非官方支持，需手动配置依赖。

前置依赖：

• Node.js (推荐最新 LTS 版本)
• npm
• Linux 用户额外需要：
  • ffmpeg (通过包管理器全局安装)
  • demucs 和 yt-dlp (通过 pip 全局安装)
  • 若遇到 "Couldn't find appropriate backend" 错误，请安装 libsox-dev

国内加速建议：安装依赖时建议使用国内镜像源以提升速度。

• npm: npm config set registry https://registry.npmmirror.com
• pip: pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装步骤

1. 克隆项目代码

   git clone https://github.com/stemrollerapp/stemroller.git
   cd stemroller
   

2. 安装开发依赖

   npm i -D
   

3. 下载第三方应用（根据系统选择）

   Windows / macOS:

   npm run download-third-party-apps
   

   Linux: 请确保已按“环境准备”章节手动全局安装了 ffmpeg, demucs, yt-dlp 及 libsox-dev。

基本使用

方式一：直接使用成品（推荐普通用户）

访问 StemRoller 官网 或 Releases 页面 下载最新安装包。

1. 打开软件，在搜索栏输入歌曲名或艺术家。
2. 点击搜索结果中的 Split 按钮。
3. 等待几分钟处理完成后，点击 Open 按钮即可获取分离后的音轨文件。

方式二：开发者模式运行

如果你希望参与开发或从源码运行：

启动开发服务器：

npm run dev

构建并运行生产版本：

npm run build:svelte && npm run start

打包为桌面应用（可选）：

• Windows: npm run build:win
• macOS: npm run build:mac