swiftbar-plugins

Personal SwiftBar plugins for macOS.

Dependencies

• SwiftBar — brew install swiftbar
• media-control — brew tap ungive/media-control && brew install media-control
• SF Symbols — brew install --cask sf-symbols (optional, for browsing icon names)

Setup

Set SwiftBar's plugin folder to this repo, or clone it there directly:

git clone https://github.com/laoist/swiftbar-plugins ~/Library/Application\ Support/SwiftBar/Plugins

Or, if the repo is elsewhere, symlink individual plugins into your SwiftBar plugin folder:

ln -s ~/git/swiftbar-plugins/media/nowplaying.5s.py ~/Library/Application\ Support/SwiftBar/Plugins/nowplaying.5s.py

Or use GNU Stow to manage symlinks for the whole repo:

stow --dir ~/git/swiftbar-plugins --target ~/Library/Application\ Support/SwiftBar/Plugins media
stow --dir ~/git/swiftbar-plugins --target ~/Library/Application\ Support/SwiftBar/Plugins peripherals

Plugins

media/nowplaying.5s.py

Displays the currently playing Tidal track in the menu bar. Shows album art, artist, title, album, and a live progress bar in a popover on click.

Note

Only shows output when Tidal is the active source. To add other sources (e.g. Spotify, Apple Music), add their bundle identifiers to ALLOWED_SOURCES in the script. To find a source's bundle identifier, play something and run:

media-control get | jq '.bundleIdentifier'

peripherals/mouse_battery.5m.py

Displays the MX Master 3 battery percentage in the menu bar. Hidden when the mouse is not connected.

Note

To monitor a different device, update DEVICE_NAME at the top of the script to match the name shown by pmset -g accps.