MMusic is a lightweight, cross-platform desktop music player with a built-in ad blocker, track downloads, synced lyrics, audio visualizer, and a flexible plugin system.

Stars

9

7-day growth

No data

Forks

7

Open issues

0

License

MIT

Last updated

2026-07-18

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It offers a rare combination of built-in ad blocking, track downloading, and extensive plugin support in a single open-source music player, with Discord Rich Presence and global media controls for a polished user experience.

Who it is for

  • Music enthusiasts who want an ad-free listening experience
  • Developers seeking a customizable music player with plugin API
  • Power users who need advanced audio features like compressor and equalizer
  • Discord users who want to show their currently playing music

Use cases

  • Playing local music files with synced lyrics and visualizer
  • Downloading tracks from streaming sources as MP3 or M4A
  • Customizing the player appearance with themes and plugins
  • Using global shortcuts and system media controls for seamless control

Strengths

  • Lightweight and cross-platform (macOS, Windows, Linux)
  • Powerful plugin system allowing extensive customization
  • Built-in ad blocking and track downloading capabilities
  • Ready-to-use features like audio compressor, equalizer, and Discord integration

Considerations

  • macOS build only supports Apple Silicon (arm64), not Intel
  • Plugin development requires TypeScript knowledge and project setup
  • No streaming service integration mentioned; likely relies on user-provided audio sources

README quick start

MMusic

A lightweight desktop music player with a powerful plugin system.

MMusic is a desktop music app for macOS, Windows, and Linux. It ships with a flexible plugin system so you can tailor the experience to your taste.

Features

  • 🚫 Built-in ad-blocking
  • ⬇️ Download tracks as audio files (mp3 / m4a)
  • 🎵 Synced lyrics with romanization
  • 🎨 Audio visualizer
  • 🎚️ Precise volume, crossfade, audio compressor & equalizer
  • 💬 Discord Rich Presence
  • ⌨️ Global media shortcuts & system media controls
  • 🌗 Themes and visual tweaks
  • …and many more plugins

Download

Grab the latest build from the Releases page.

macOS

The macOS build is signed and notarized, so it opens without extra steps. Requires Apple Silicon (arm64).

Development

pnpm install --frozen-lockfile
pnpm dev

Build

pnpm dist:mac:arm64   # macOS (Apple Silicon)
pnpm dist:win         # Windows
pnpm dist:linux       # Linux

Writing plugins

Create a folder in src/plugins/YOUR-PLUGIN-NAME with an index.ts:

import { createPlugin } from '@/utils';

export default createPlugin({
  name: () => 'My Plugin',
  restartNeeded: true,
  config: { enabled: false },
  renderer() {
    console.log('hello from the renderer');
  },
});

License

MIT — see the license file.

Description

MMusic — A lightweight desktop music player with plugins: ad-block, downloader, visualizer, synced lyrics

Related repositories

Similar projects matched by category, topics, and programming language.

TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
vercel-labs
Featured
vercel-labs GitHub avatar

scriptc

scriptc compiles ordinary TypeScript into small, fast native executables without needing Node.js, V8, or any JavaScript runtime in the binary.

Developer ToolsCode Quality & Build
1,985
Jakubantalik
Featured
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI & Machine LearningAI Agents
1,191