Albus Status Bar Music

A vinyl-style music player in the status bar with lyrics display, playlist management, and album art.Add a music player to the status bar of Obsidian.

Albus Status Bar Music

一个为 Obsidian 打造的状态栏音乐播放器插件。在不离开笔记的情况下,直接在 Obsidian 内播放和管理你的本地音乐库。

本项目基于 obsidian-vault-radio(MIT 许可证),由 Laevin 开发。

ObsidianPlugin Version release


功能概览

状态栏控制

  • 实时显示当前播放的歌曲名称与艺术家
  • 播放/暂停、上一首/下一首控制按钮
  • 可视化播放进度条
  • 三段式歌词切换:关闭 → 状态栏歌词 → 悬浮歌词 → 关闭

音乐中心

  • 黑胶唱片播放器,带真实旋转动画
  • 左右两侧唱片快速切歌,支持切歌缩放动画
  • 智能歌单管理——子文件夹自动生成歌单
  • 实时搜索歌曲、艺术家、专辑
  • 专辑封面自动提取与显示
  • 音量滑块控制,音量持久化保存
  • 可拖拽窗口,自由定位

歌词

  • 三行悬浮歌词窗口(上一行、当前行、下一行),支持平滑滚动动画
  • 双语歌词支持(自动识别相同时间戳或 // 分隔)
  • 自定义歌词高亮色和普通色
  • 锁定模式:透明背景、鼠标穿透,完全不影响操作
  • 双击歌词窗口解锁;右键可关闭
  • 歌词与播放进度同步

播放

  • 支持格式:MP3、FLAC、WAV、M4A、OGG
  • 三种播放模式:列表循环、单曲循环、随机播放
  • 红心收藏歌单
  • 进度条拖拽、点击跳转
  • 元数据缓存(封面以 Base64 存储),加载迅速

安装

  1. 前往 GitHub Releases 下载最新版本
  2. main.jsmanifest.jsonstyles.css 放入 Obsidian 插件目录:
    <vault>/.obsidian/plugins/albus-status-bar-music/
  3. 在 Obsidian 设置 → 第三方插件中启用 Albus Status Bar Music

使用

配置音乐库

  1. 打开 Obsidian 设置 → Albus Status Bar Music
  2. 在"音乐库"设置组中填写包含音乐文件的文件夹路径(如 Music
  3. 点击"扫描"按钮,插件会自动扫描并缓存所有音乐文件的元数据

播放控制

  • 状态栏:点击歌曲名称打开音乐中心;使用按钮控制播放
  • 音乐中心:点击黑胶唱片播放/暂停;点击两侧唱片切歌;拖拽顶部手柄移动窗口
  • 歌词:点击状态栏歌词按钮在三种模式间切换(关闭/状态栏/悬浮)

歌词格式

歌词需嵌入在音频文件的元数据中,支持标准 LRC 格式:

[00:12.34]第一句歌词
[00:12.34]First line translation
[00:18.56]第二句歌词 // 翻译文本

同一时间戳的两行会自动识别为双语歌词,也可以使用 // 分隔符。


设置项

设置组设置项说明
音乐库音乐文件夹音乐文件所在的 Vault 内文件夹路径
音乐库已缓存元数据查看/清空元数据缓存
界面显示状态栏控制按钮是否在状态栏显示播放控制按钮
界面点击外部关闭播放器点击音乐中心外部区域是否自动关闭
歌词高亮颜色当前播放歌词的颜色
歌词普通颜色非当前歌词的颜色

技术栈

  • TypeScript + Obsidian Plugin API
  • 构建工具:esbuild
  • 音频元数据解析:music-metadata
  • 最低 Obsidian 版本:1.11.4

常见问题

音乐无法播放
检查文件夹路径是否正确,确认文件格式为受支持的类型。可尝试清空缓存后重新扫描。

封面不显示
确认音频文件的元数据中包含封面图片。插件会自动提取并缓存为 Base64 格式。

歌词不同步
确认 LRC 时间标签格式正确([mm:ss.xx])。可使用 Mp3tag 等工具检查音频文件的歌词标签。

悬浮歌词无法解锁
锁定状态下双击歌词窗口任意位置即可解锁。


贡献

  • 提交 Bug 或功能建议:GitHub Issues
  • 代码贡献:Fork → 修改 → Pull Request

Related

How to Install

  1. Download the template file from GitHub
  2. Move it anywhere in your vault
  3. Open it in Obsidian — done!

Stats

Stars

39

Forks

6

License

AGPL-3.0

Last updated 10d ago

Categories