VibeBar

VibeBar is a lightweight macOS menu bar application that brings your Apple Music activity to your Discord Rich Presence.

No extra setup. No terminal scripts. Just launch, and your current track will appear in Discord.

---

Features

• Live Apple Music playback status in Discord
• Clean and native macOS menu bar interface
• Dynamic album covers (optional, powered by loon)
• Customizable buttons (e.g. link to your track or profile)
• Flexible behavior for paused/stopped states
• Quick restart button for reloading settings

---

Preview

Here's how your presence will appear in Discord:

---

Requirements

• macOS 11.0+
• Apple Music app installed
• Local Discord running (web version not supported)

💡 Full feature support (including all settings fields) requires macOS 13 or later. On macOS 12, only basic functionality and client ID editing are fully supported.

---

Installation

1. Download the latest .dmg file from Releases.
2. Move VibeBar.app to your Applications folder.
3. Launch it — and grant automation permissions when prompted.
4. That’s it. Your vibes are now live.

---

Permissions

macOS will prompt you to grant automation access so VibeBar can read playback info from Apple Music. This is required for real-time updates.

---

Dynamic Covers

If you enable dynamic album covers, VibeBar will check for the loon proxy.

• loon is an optional external dependency and is not bundled with VibeBar.
• VibeBar only provides a helper script to build loon directly from its official repository by ungive.
• Installation may require Homebrew or a direct Go-based build.

---

Custom Presence

VibeBar allows you to configure your own Discord Rich Presence details (images, hover texts, and buttons).

• Large Image Key → The main image shown (usually album art or custom asset).
• Large Image Text (Hover) → Text shown when hovering over the large image. (Note: not visible in all presence types)
• Small Image Key → A smaller image displayed on top of the large image.
• Small Image Text (Hover) → Text shown when hovering over the small image.
• Buttons → Add up to two buttons (e.g. "View Track" / "My Profile").

Important:

• Some fields (like Large Image Hover Text) do not appear in certain presence types such as Playing or Watching.
• Configured buttons are only visible to other people, not to yourself in your own Discord client.

---

Third-Party Components

VibeBar uses third-party software:

• mediaremote-adapter by ungive
  Licensed under the BSD 3-Clause License

• loon by ungive
  Used for optional dynamic album cover proxying

---

License Notice

This product includes software developed by ungive, licensed under the BSD 3-Clause License.
All rights and notices of the original authors are retained.

---

Credits

Built using SwiftUI and AppKit.
Special thanks to ungive for loon and related tooling.