系统音乐通知提示

当系统开始播放音乐时显示 toast 通知

工具

🎵 系统音乐通知弹窗

将你当前正在播放的音乐显示为 Minecraft 的弹窗通知。

功能说明

系统音乐通知弹窗(SMN Toast)是一款适用于 Fabric 和 NeoForge 的客户端模组,可检测系统中正在播放的音乐,并在 Minecraft 中以弹窗通知的形式显示。当有新曲目开始播放时,你会看到显示歌曲名称和艺术家名称的“正在播放”弹窗。

特性

  • 自动通知 — 每当有新曲目开始播放时,都会出现一个弹窗
  • 手动触发 — 可通过按键绑定按需显示当前曲目(默认未绑定)
  • 简洁设计 — 使用原版 Minecraft 弹窗样式
  • 跨平台 — 支持 Windows、Linux 和 macOS
  • 多加载器 — 同时支持 Fabric 和 NeoForge

平台支持

平台 方式 要求
Windows SMTC(系统媒体传输控件) 无(内置)
Linux 通过 D-Bus 使用 MPRIS 无(原生)或 playerctl(非 Flatpak)
Linux(Flatpak) 通过 D-Bus 使用 MPRIS 授予权限(见下文)
macOS AppleScript 授予权限(见下文)

使用方法

  1. 将模组安装到你的 Fabric 或 NeoForge 模组文件夹中
  2. 在任意兼容的播放器中开始播放音乐
  3. 当有新曲目开始播放时,会出现一个弹窗

要手动显示当前曲目,请在 选项 → 控制 → 按键绑定 → System Music Notification Toast 中绑定按键。

兼容的播放器

  • Windows:Spotify、Windows Media Player、浏览器媒体(Edge/Chrome)、foobar2000,以及任何使用 SMTC 的应用
  • Linux:Spotify、VLC、Firefox、Chromium,以及任何兼容 MPRIS 的播放器
  • macOS:Spotify、Music.app(Spotify 优先级更高)

Flatpak 用户(Linux)

如果你使用的是 Flatpak 启动器(如 PrismLauncher),需要授予模组与媒体播放器通信的权限。

运行以下命令:

flatpak override --user org.prismlauncher.PrismLauncher '--talk-name=org.mpris.MediaPlayer2.*'

或使用 Flatseal:

  1. 打开 Flatseal 并选择你的启动器(例如 PrismLauncher)
  2. 前往 Session Bus → Talk
  3. 添加 org.mpris.MediaPlayer2.*

应用权限后请重启启动器。

注意:此权限仅允许与媒体播放器通信 — 它不会授予在你的主机系统上运行命令的权限。

macOS 权限

macOS 会提示你允许 Minecraft(或你的启动器)控制 Spotify 和/或 Music.app。允许后即可启用曲目检测。

如果你之前拒绝了,请前往 系统设置 → 隐私与安全性 → 自动化,并为你的启动器或 Minecraft 启用访问权限。

(感谢 NatsuCamellia 对 macOS 的支持 <3)