mio-plugins/d0a12847-494a-4347-ae88-d87969ea41c2
1
Fork 0
mirror of https://github.com/xmqywx/mio-plugin-music.git synced 2026-04-11 17:34:33 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
Mirror of xmqywx/mio-plugin-music for plugin review
2 Commits 1 Branch 0 Tags 104 KiB
Swift 93.4%
Shell 6.6%
master
Go to file
xmqywx 93078fb2d9 docs: add README.md and README.zh-CN.md
2026-04-12 01:09:21 +08:00
build/music-player.bundle/Contents feat: MioIsland music player plugin — reads system NowPlaying 2026-04-11 23:37:11 +08:00
Sources feat: MioIsland music player plugin — reads system NowPlaying 2026-04-11 23:37:11 +08:00
build.sh feat: MioIsland music player plugin — reads system NowPlaying 2026-04-11 23:37:11 +08:00
Info.plist feat: MioIsland music player plugin — reads system NowPlaying 2026-04-11 23:37:11 +08:00
README.md docs: add README.md and README.zh-CN.md 2026-04-12 01:09:21 +08:00
README.zh-CN.md docs: add README.md and README.zh-CN.md 2026-04-12 01:09:21 +08:00

README.md

Music Player Plugin for MioIsland

A native plugin that brings real-time music playback information to your MioIsland Notch bar. See what's currently playing across any music app on your Mac without leaving your workflow.

Features

  • Displays the currently playing track, artist, and album from any macOS music app (Apple Music, Spotify, etc.)
  • Reads system NowPlaying metadata — no need to configure individual apps
  • Lightweight native .bundle plugin with minimal resource usage
  • Smooth animated UI that matches the MioIsland design language
  • Appears as a header icon button in the Notch bar

Screenshots

Coming soon

Installation

From MioIsland Plugin Store

  1. Visit miomio.chat
  2. Find "Music Player" and click Install
  3. MioIsland will automatically download and activate the plugin

Manual Installation

cp -r music-player.bundle ~/.config/codeisland/plugins/

Restart MioIsland to load the plugin.

Building from Source

Requirements:

  • macOS 15.0+
  • Xcode Command Line Tools
  • Swift 5.9+
git clone https://github.com/xmqywx/mio-plugin-music.git
cd mio-plugin-music
bash build.sh

The build script outputs:

  • build/music-player.bundle — the plugin (copy to ~/.config/codeisland/plugins/)
  • build/music-player.zip — compressed bundle for marketplace upload

Plugin Architecture

File Purpose
MioPlugin.swift Plugin protocol definition
MusicPlugin.swift Main plugin entry point — activate, deactivate, makeView
MusicPlayerView.swift SwiftUI view displaying track info
MusicHeaderButton.swift Header icon button for the Notch bar
NowPlayingBridge.swift Bridges macOS NowPlaying system APIs

How It Works

The plugin uses macOS MRMediaRemoteGetNowPlayingInfo API to read the system-wide NowPlaying information. This works with any app that reports playback status to the system, including:

  • Apple Music
  • Spotify
  • YouTube (in browser)
  • VLC
  • Any app using MPNowPlayingInfoCenter

License

MIT

Author

@xmqywx