Skip to content

Repository files navigation

Taskbar Lyrics

TaskbarLyrics

release license

独立 Windows 任务栏歌词应用,支持卡拉OK效果、卡片封面、播放控制和歌词翻译。


功能特性

  • 多音源适配器架构 — WebSocket KRC(逐字高亮)和 SMTC(Spotify / QQ 音乐 / 网易云等)双音源,自动切换
  • 卡拉 OK 效果 — Direct2D + DirectWrite 渲染,逐字高亮渐变色
  • 卡片样式显示 — 双行歌词 + 专辑封面图标,独立字号和颜色配置
  • 歌词翻译 — 自动解析 KRC [language:...] 翻译标签,支持原文 / 译文 / 双语三种模式
  • 悬停控制按钮 — 鼠标悬停歌词时显示 ⏮ ⏸/▶ ⏭
  • 跑马灯滚动 — 长歌词自动滚动(bounce / loop / off 三种模式)
  • 音频频谱可视化 — WASAPI loopback 实时频谱采集
  • 拖动定位 — 可在任务栏范围内自由拖动调整位置
  • 锁定模式 — 托盘菜单切换位置锁定 / 完全锁定
  • 多方向任务栏 — 支持底部 / 顶部 / 左侧 / 右侧任务栏
  • 高 DPI 适配 — Per-Monitor V2 DPI Awareness
  • D2D 原生设置界面 — 纯 Direct2D + DirectWrite 自绘,实时预览,零外部依赖
  • 自定义字体 — 可使用本地已安装的字体
  • 单实例保护 — 防重复启动,协作式线程退出

本项目可能与腾讯桌面整理等任务栏美化工具不兼容。但与 TranslucentTB、Wallpaper Engine 无兼容问题,可放心使用。

安装与使用

环境要求

  • Windows 10 / 11(64 位)
  • VC++ Redist 运行时(msvcp140 / vcruntime140 / vcruntime140_1)

运行

Releases 下载 TaskbarLyrics.zip,解压后双击 TaskbarLyrics.exe 即可。

右键系统托盘图标:

  • 设置 — 打开 D2D 原生设置界面,调整歌词样式、颜色、字体
  • 调试日志 — 查看连接状态、歌词获取详情
  • 开机自启 — 勾选后随系统启动
  • 退出 — 关闭应用

WebSocket KRC 音源(可选)

如需接入提供 WebSocket KRC 推送的外部播放器(如 MoeKoeMusic),需自行配置该播放器的 API 模式以推送歌词数据到 ws://127.0.0.1:6520。应用本身无需额外配置。

SMTC 音源

直接启动应用即可。系统媒体控制(SMTC)覆盖大多数主流播放器(Spotify / QQ 音乐 / 网易云 / 系统媒体播放器等),自动同步播放状态并联网获取歌词。


构建

环境要求

工具 版本
Windows SDK 10.0.26100+
Visual Studio 2022 (v143)
MSVC 工具集 14.44+
CMake 3.20+
vcpkg latest

步骤

# 安装依赖
vcpkg install ixwebsocket:x64-windows-142 nlohmann-json:x64-windows-142 kissfft:x64-windows-142

# 构建
cmake --preset x64-Release
cmake --build --preset x64-Release

# 构建产物位于 dist/ 目录

基于TaskbarLyrics已做出的改进

  • 重构:从 MoeKoeMusic 插件形态升级为独立 Windows 应用
  • 新增:统一音源适配器架构(ISourceAdapter + SourceManager)
  • 新增:SMTC 音源支持(Spotify / QQ音乐 / 网易云等)
  • 新增:LyricsFetcher 在线歌词获取(网易云主 + QQ 音乐备)
  • 去除:去除自动开启 MoeKoeMusic 的 API 模式
  • 去除:去除专属 MoeKoeMusic 的插件元素


许可证

GPL-3.0

About

一款任务栏歌词应用

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages