文档中心
更新于 2026/10/16

安装与首次使用

安装

使用发布的 Windows x64 安装包。

两个版本共用设置,可以互相升级。OBS 原生歌词源使用单独的插件安装包,浏览器源无需安装插件。

启动与授权

  1. 启动 GrassLiveTools,按提示打开授权页。
  2. 登录 GrassAuth,完成设备码授权。
  3. 返回程序,确认“设置与授权”中的授权状态正常。

会话保存在当前 Windows 用户下。以后启动时程序会尝试自动续期,需要重新授权时按窗口提示操作。

连接播放器

网易云音乐启动后,播放一首有歌词的歌。在 GrassLiveTools 的“概览”查看歌名、歌词和进度。

概览向下滚动进入第二屏,在“歌词来源”中选择网易云音乐或 LX Music。自动模式会采用正在播放的来源。

使用 LX Music 时,先在播放器中开启 Open API,再到“设置与授权”填写地址并保存。默认地址为 http://127.0.0.1:23330。

添加 OBS 浏览器源

  1. 在 OBS 当前场景添加“浏览器”来源。
  2. URL 填写 http://localhost:25000/double。
  3. 设置来源宽高,将歌词放到需要的位置。
  4. 播放歌曲,检查两排歌词是否交替更新。

单行歌词使用 http://localhost:25000/main。页面背景透明,可直接叠放在场景中。其他输出地址见OBS 接入。

如需自动创建来源,在 GrassLiveTools 的“OBS 控制”中连接 OBS WebSocket,选好场景后点击“一键创建歌词源”。创建后在 OBS 调整位置,隐藏不需要的来源。

调整样式

在“样式设计”选择编辑对象,修改字体、字号、颜色和位置,点击“保存并应用”。“应用预览”会更新当前输出,但不会保存到下次启动。

双排上方的罗马音需要选择“双排罗马音”,打开“启用双排罗马音”。日文分析器状态在“设置与授权”中查看,详细说明见日语歌词与罗马音。

检查同步

播放、暂停、切歌和拖动进度,确认概览与 OBS 跟随播放器更新。检查长句、翻译和罗马音是否显示完整。

某首歌固定提前或延后时,可以使用歌词延迟修正插件。使用期间保持 GrassLiveTools 运行。

返回首页

发生了一个未处理的错误。 刷新 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.