🎵 鼠标轻触边缘，音乐面板优雅滑出
Hover the screen edge — your music panel glides out.
🇨🇳 中文
你是否有过这样的烦恼：QQ 音乐 / Spotify 挂在任务栏占地方，最小化到托盘又不方便切歌、收藏？
MusicEdgeX 把音乐控制栏"藏"在屏幕右边缘。平时完全隐形，鼠标轻轻靠近屏幕右侧，面板就会丝滑滑出——切歌、暂停、收藏、调音量一气呵成。鼠标离开后自动收回，不占任何屏幕空间。
主力适配 QQ 音乐，核心操控兼容 Spotify · 网易云音乐 · Apple Music 等所有接入 Windows SMTC 的播放器。
| 功能 | QQ 音乐 | Spotify | 网易云 | Apple Music |
|---|---|---|---|---|
| 歌名 / 歌手 / 封面 / 进度 | ✅ | ✅ | ✅ | ✅ |
| 播放 / 暂停 / 上首 / 下首 | ✅ | ✅ | ✅ | ✅ |
| 随机播放 / 音量 | ✅ | ✅ | ✅ | ✅ |
| 收藏 ❤️ / 打开播放器 🎧 | ✅ | ❌ | ❌ | ❌ |
（请替换为你的 GIF 截图）
鼠标靠近右边缘 → 48px 预览条滑出 → 悬停 0.3s → 360px 完整面板展开
播放 / 暂停 · 上一首 / 下一首 · 随机播放 · 收藏 · 音量调节
- 边缘触发 — 鼠标接近屏幕右边缘自动浮现，离开自动隐藏
- 全屏检测 — 全屏看视频 / 打游戏时自动禁用，不打扰
- 托盘图标 — 右键菜单：显示面板 / 隐藏面板 / 设置 / 退出
- 实时同步 — 通过 Windows SMTC 读取当前歌曲、艺术家、专辑封面、播放进度
- 媒体键控制 — 模拟媒体键控制播放器（播放 / 暂停 / 上一首 / 下一首）
- 收藏歌曲 — 模拟 QQ 音乐 Ctrl+Alt+F 快捷键一键收藏
- 面板固定 — 点击 📌 固定面板，方便频繁操作
- 自定义设置 — 悬停延迟、隐藏延迟、开机自启
环境要求： Windows 10 1809+ 或 Windows 11
下载： 前往 Releases 下载 MusicEdgeX_v1.0.0.zip，解压即用，无需安装任何运行时。
从源码构建：
git clone https://github.com/leavestring/MusicEdgeX.git
cd MusicEdgeX
dotnet build -c ReleaseQ: 面板不出来？ — 确保鼠标移到屏幕最右侧边缘。全屏应用会自动禁用。也可右键托盘 → "显示面板"。
Q: 收藏无效？ — 收藏模拟的是 QQ 音乐 Ctrl+Alt+F 快捷键，确保 QQ 音乐正在运行。
Q: 专辑封面不显示？ — 确保播放器正在播放，且 SMTC 能读取封面（QQ 音乐 / Spotify / 网易云均可）。
🚧 v1 是起点，不是终点。 后续版本将持续演进，欢迎 Star & Watch 关注更新。
| 版本 | 计划内容 | 状态 |
|---|---|---|
| v1.0 | 右边缘吸附 · SMTC 同步 · 媒体键控制 · 托盘图标 | ✅ 已发布 |
| v1.1 | 左边缘吸附 · 自定义热键 · 迷你模式 | 🚧 开发中 |
| v1.2 | 桌面歌词 · 频谱可视化 · 多播放器切换 | 📋 计划中 |
| v2.0 | 插件系统 · 皮肤主题 · macOS 支持 | 💡 探索中 |
🇺🇸 English
Taskbar too cluttered, but minimizing to tray means you can't skip tracks — every music lover knows this trade-off.
MusicEdgeX hides a sleek control panel at your screen's right edge. Hover your mouse near the edge and it glides out smoothly. Skip, pause, favorite, adjust volume — all in one fluid motion. Pull away and it vanishes, leaving your desktop perfectly clean.
Built for QQ Music with full feature parity; core controls work across Spotify, NetEase Music, Apple Music and any SMTC-compatible player.
| Feature | QQ Music | Spotify | NetEase | Apple Music |
|---|---|---|---|---|
| Track info / album art / progress | ✅ | ✅ | ✅ | ✅ |
| Play / pause / next / previous | ✅ | ✅ | ✅ | ✅ |
| Shuffle / volume | ✅ | ✅ | ✅ | ✅ |
| Favorite ❤️ / Open player 🎧 | ✅ | ❌ | ❌ | ❌ |
(Replace with your GIF)
Mouse near right edge → 48px preview slides out → hover 0.3s → full 360px panel
Play / Pause · Previous / Next · Shuffle · Favorite · Volume
- Edge Trigger — panel glides out when mouse approaches the right screen edge; auto-hides when you leave
- Fullscreen Detection — automatically disabled during games / fullscreen video
- System Tray — right-click menu: Show / Hide / Settings / Exit
- Real-time Sync — reads track, artist, album art, and progress via Windows SMTC
- Media Keys — simulates media keys to control any player
- Favorite — toggles QQ Music like via
Ctrl+Alt+F - Pin Panel — click 📌 to keep the panel open
- Settings — customizable hover delay, hide delay, auto-start
Requirements: Windows 10 1809+ or Windows 11
Download: Grab MusicEdgeX_v1.0.0.zip from Releases, unzip and double-click MusicEdgeX.exe — no runtime installation needed.
Build from source:
git clone https://github.com/leavestring/MusicEdgeX.git
cd MusicEdgeX
dotnet build -c ReleaseQ: Panel won't show? — Move mouse to the far right edge of the screen. Fullscreen apps auto-disable the panel. Or right-click tray → "Show Panel".
Q: Favorite doesn't work? — It sends QQ Music's Ctrl+Alt+F shortcut. Make sure QQ Music is running with default hotkeys.
Q: No album art? — Ensure a track is playing and SMTC can read its thumbnail (works with QQ Music, Spotify, NetEase).
🚧 v1 is just the beginning. More features are on the way — Star & Watch to stay tuned.
| Version | Planned Features | Status |
|---|---|---|
| v1.0 | Right-edge trigger · SMTC sync · Media keys · Tray icon | ✅ Released |
| v1.1 | Left-edge support · Custom hotkeys · Mini mode | 🚧 In progress |
| v1.2 | Desktop lyrics · Spectrum visualizer · Multi-player | 📋 Planned |
| v2.0 | Plugin system · Theme engine · macOS support | 💡 Exploring |
| Layer | Tech |
|---|---|
| UI | WPF (.NET 10) |
| Window management | Win32 P/Invoke |
| Animation | CompositionTarget.Rendering (native refresh rate, 120Hz/144Hz) |
| Track data | Windows SMTC |
| Media control | keybd_event API |
| Edge detection | GetCursorPos polling |
MusicEdgeX/
├── App.xaml.cs # Entry point + tray icon
├── MainWindow.xaml / .cs # Panel UI + animation engine
├── SettingsWindow.xaml / .cs
├── Services/
│ ├── EdgeDetector.cs # Mouse edge detection
│ ├── SMTCMusicService.cs # SMTC track info
│ ├── MediaKeyService.cs # Media key simulation
│ └── QQMusicHotkeyService.cs
├── Helpers/
│ └── Win32Interop.cs # P/Invoke declarations
└── Models/
└── TrackInfo.cs
MIT © 2025