Skip to content

Latest commit

ย 

History

114 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Mooziac macOS Music Player

Latest Release GitHub Stars macOS 13.0+ Compatibility Universal Binary (Apple Silicon & Intel) Zero Telemetry (100% Local-First) MIT License

Download DMG ย ย  Download ZIP ย ย  Official Website


Mooziac is an ultra-lightweight, 100% native Swift & AppKit music player built specifically for macOS.
The native alternative to YouTube Music Desktop, Spotify, and Electron players โ€” tucked right into your menu bar with an invisible trackpad edge volume slider, real-time synchronized lyrics HUD, and zero battery-draining Chromium bloat.


โœจ See Mooziac in Action

Mooziac macOS Interface & Preferences
Interactive player preferences, themes, live audio waveforms, and native macOS menu bar playback controls.


โšก๏ธ Why Mooziac?

Most desktop music players are heavy Electron wrappers that bundle a full Chromium browser, devouring system resources and draining laptop battery life. Mooziac was built from scratch in pure native Swift and AppKit with zero third-party dependencies.

Feature โšก๏ธ Mooziac ๐ŸŒ Official YTM Web / Desktop ๐Ÿ“ฆ Electron Wrappers
Technology 100% Native Swift & AppKit Chromium / Web App Heavy Chromium + Node.js
Trackpad Edge Volume โœ… Yes (with haptic feedback) โŒ No โŒ No
Synchronized Lyrics HUD โœ… Line-by-line LRC โš ๏ธ Basic / Unsynced โŒ No
Local Offline Audio โœ… FLAC, MP3, WAV, AAC, M4A โŒ Cloud only โŒ No
Background Media Keys โœ… Native macOS integration โš ๏ธ Browser permissions โš ๏ธ Inconsistent
Discord Rich Presence โœ… Native Unix socket (0 deps) โŒ No โš ๏ธ Third-party plugins
Telemetry & Privacy ๐Ÿ”’ 100% Local (Zero tracking) โš ๏ธ Extensive Google telemetry โš ๏ธ Varies

๐ŸŽ›๏ธ Native macOS Features: Trackpad Gestures, Synced Lyrics & Audio Engine

๐ŸŽ›๏ธ Invisible Trackpad Volume Slider

Turn the rightmost 1mm border of your MacBook trackpad into an invisible hardware volume dial.

  • 1mm Border Edge: Slide along the outer bezel for fine-grained system volume adjustment.
  • Tactile Taptic Engine: Real physical haptic ticks as volume levels increment or decrement.
  • Zero Ghost Touches: Palm and Touch ID rejection prevents accidental triggers during typing.

๐ŸŽค Floating Synchronized Lyrics HUD

Sing along with real-time, line-by-line synchronized LRC lyrics right beneath your menu bar.

  • Line-by-Line LRC: Powered by LRCLib and native YouTube Music synced endpoints.
  • Non-Intrusive HUD: Floats discreetly without taking window focus or blocking your workspace.
  • Instant Local Cache: Stored in SQLite for zero-latency retrieval on repeat listens.

โšก๏ธ Dual Audio Engine (Cloud + Local Hi-Res)

Stream your cloud favorites or play lossless offline libraries in one seamless unified queue.

  • YouTube Music Bridge: Direct access to your cloud playlists, liked songs, and history.
  • Lossless Hi-Res: Pure AVFoundation playback supporting FLAC, ALAC, WAV, MP3, AAC, and M4A.
  • Built-in Downloader: Integrated yt-dlp pipeline with automatic tag and artwork embedding.

๐ŸŒŠ Interactive Waveform & Adaptive Glow

Dynamic ambient interface that harmonizes with your music and desktop wallpaper.

  • Live Audio Visualizer: Interactive waveform scrub bar with real-time seeking.
  • Adaptive Palette: Real-time color sampling from active album artwork.
  • Curated Themes: OLED Pitch Black, Crystal Glass, and Liquid Fluid visual styles.

๐ŸŽฎ Native Discord Rich Presence

Broadcast your now-playing status without third-party bloat or background daemons.

  • Native Unix Socket IPC: Direct connection with zero Node.js or Python runtime overhead.
  • Rich Status Card: Displays active song title, artist, album art, and live elapsed timestamps.
  • Auto-Pause Sync: Updates status in real time when playback is paused or resumed.

๐Ÿ”’ 100% Local & Privacy-First

Architected with strict privacy principles โ€” your music and listening data remain strictly on your Mac.

  • Zero Telemetry: No analytics SDKs, trackers, beacons, or crash reporters phoning home.
  • Local SQLite3: History, likes, and cached playlists stay entirely in your local storage.
  • Sandboxed WebKit: Credentials remain safely inside Apple's official WKWebsiteDataStore.

โŒจ๏ธ Gestures & Shortcuts

Trackpad MultiTouch Gestures

Gesture Trackpad Region Action
Edge Slide Far-right 1mm border Smooth volume adjustment with tactile haptics
Double Tap Bottom-right corner Next Track
Triple Tap Bottom-right corner Previous Track
Double Tap Bottom-left corner Play / Pause Toggle
Scroll Over Menu Bar Icon Fast Volume Stepping

Keyboard Shortcuts

Shortcut Action
Space Play / Pause
โŒ˜ + Right Arrow Next Track
โŒ˜ + Left Arrow Previous Track
L Like / Unlike Song
โŒ˜ + R Reload Web Engine
โŒ˜ + Q Quit Mooziac

๐Ÿš€ Installation

Option 1: Homebrew (Recommended)

Install directly via the official Homebrew tap:

brew install shirkeharsh/tap/mooziac

To update in the future:

brew upgrade --cask mooziac

Option 2: Direct Download

  1. Download Mooziac.dmg or Mooziac.zip.
  2. Open Mooziac.dmg and drag Mooziac into your Applications folder.
  3. Launch Mooziac from Spotlight (โŒ˜ + Space) or Launchpad.

Note

macOS Gatekeeper: Because Mooziac is distributed directly outside the Mac App Store:

  • If macOS prompts that the app cannot be verified, go to System Settings > Privacy & Security and click Open Anyway.
  • Or run this one-line command in Terminal:
    xattr -cr /Applications/Mooziac.app

๐Ÿ› ๏ธ Building from Source

Prerequisites

  • macOS 13.0 (Ventura) or later
  • Xcode 15+ or Xcode Command Line Tools (xcode-select --install)
  • Swift 5.9+ toolchain
# Clone repository
git clone https://github.com/shirkeharsh/mooziac.git
cd mooziac

# Run unit tests
swift test --parallel

# Build and launch debug app locally
./build_app.sh

# Build universal release binary & DMG package
./build_app.sh --release-only

๐Ÿ“‚ Architecture and Project Structure

Mooziac is architected cleanly into modular Swift packages with native macOS frameworks:

Mooziac/
โ”œโ”€โ”€ Package.swift                         # SPM Manifest (macOS 13+, Swift 5.9)
โ”œโ”€โ”€ Mooziac.entitlements                  # Hardened Runtime security entitlements
โ”œโ”€โ”€ build_app.sh                          # Universal build & packaging pipeline
โ”œโ”€โ”€ Sources/Mooziac/                      # Main application target
โ”‚   โ”œโ”€โ”€ App/                              # Application lifecycle, AppDelegate, background media
โ”‚   โ”œโ”€โ”€ Audio/                            # CoreAudio volume hooks, AVFoundation audio player
โ”‚   โ”œโ”€โ”€ Core/                             # Central coordinators, NowPlaying, StatusItem
โ”‚   โ”œโ”€โ”€ Input/                            # MultiTouch gesture engine & global shortcuts
โ”‚   โ”œโ”€โ”€ Managers/                         # Local SQLite3, YTMClient, synced lyrics, yt-dlp
โ”‚   โ”œโ”€โ”€ Models/                           # State representations, playlist records, audio configs
โ”‚   โ”œโ”€โ”€ Views/                            # Dynamic Island player UI, waveform, lyrics HUD
โ”‚   โ””โ”€โ”€ Web/                              # Sandboxed WebKit bridge for YouTube Music
โ””โ”€โ”€ Tests/MooziacTests/                   # Parallelized unit test suite

โ“ Frequently Asked Questions (FAQ)

Is Mooziac free and open-source?

Yes. Mooziac is 100% free and open-source software distributed under the permissive MIT License. There are no subscriptions, paywalls, ads, or hidden tracking.

Does Mooziac require a YouTube Music Premium account?

No. Mooziac works seamlessly with both free YouTube Music accounts and YouTube Music Premium accounts. Free users get access to the full standard catalog, while Premium users enjoy higher-bitrate audio streams.

How is Mooziac different from the official YouTube Music web or desktop apps?

Official and third-party desktop wrappers are built on Electron or Chromium, often consuming 500 MB to 1.2 GB of RAM and impacting laptop battery life. Mooziac is engineered in pure native Swift and AppKit with zero third-party dependencies, consuming minimal system resources while running directly in the macOS menu bar.

How does the MacBook trackpad volume gesture work?

Mooziac captures multi-touch events along the rightmost 1mm border of your MacBook trackpad. Gliding your finger along that outer edge smoothly adjusts system volume while triggering physical tactile clicks through the Mac's built-in Taptic Engine. Intelligent palm rejection prevents accidental triggers during typing.

Does Mooziac collect any personal data or listening history?

None. Mooziac features a zero-telemetry architecture: no analytics beacons, no tracking SDKs, and no crash reporters. Your listening history, playlists, and liked songs are saved solely in a local SQLite database on your Mac, and credentials remain sandboxed in Apple's official WKWebsiteDataStore.

How do I install or update Mooziac using Homebrew?

Install via the official tap with one command:

brew install shirkeharsh/tap/mooziac
To upgrade in the future, run:
brew upgrade --cask mooziac

Can I play local audio files (FLAC, MP3, WAV) offline?

Yes. Mooziac features a dual audio engine: alongside YouTube Music streaming, it includes a native AVFoundation offline player supporting FLAC, ALAC, WAV, MP3, AAC, and M4A, complete with album artwork and integrated offline caching.


โญ๏ธ Support & Community

If you find Mooziac useful, please consider starring the repository โ€” it helps more Mac users discover native, lightweight open-source software!

Star History Chart


๐Ÿ“„ License & Disclaimer

  • License: Distributed under the MIT License. Copyright ยฉ 2026 ThreeTen.
  • Disclaimer: YouTube Music is a trademark of Google LLC. Mooziac is an independent open-source project and is not affiliated with, authorized, or endorsed by Google LLC.

About

Native macOS menu bar player for YouTube Music & local audio. Lightweight Dynamic Island UI, synced lyrics, and trackpad gestures for Apple Silicon & Intel.

Topics

Resources

Security policy

Stars

80 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages