maotoumao/musicfreedesktop

★ 8,334TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((MusicFreeDesktop))
    What it does
      Plugin-based playback
      Ad-free listening
      Local data storage
    Tech Stack
      Electron
      React
      TypeScript
    Use Cases
      Stream any audio source
      Custom themes
      Playlist management
    Platforms
      Windows
      macOS
      Linux

mindmap root((MusicFreeDesktop)) What it does Plugin-based playback Ad-free listening Local data storage Tech Stack Electron React TypeScript Use Cases Stream any audio source Custom themes Playlist management Platforms Windows macOS Linux

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Install plugins to stream music from any internet audio source without ads or a built-in music catalog.

USE CASE 2

Apply custom CSS theme packs to completely change the player's colors, backgrounds, and animations.

USE CASE 3

Manage playlists and play music locally without uploading any personal data to a server.

Tech stack

TypeScriptElectronReactCSS

Getting it running

Difficulty · easy Time to first run · 30min

No built-in music catalog, requires installing separate community plugins before any audio source works.

Free to use and modify, but any redistribution must remain open source and cannot be used for commercial purposes, per AGPL 3.0.

In plain English

MusicFreeDesktop is a free, ad-free music player for Windows, macOS, and Linux. It is built using Electron, which is a framework for creating desktop applications from web technologies, paired with React and TypeScript. The README is written in Chinese. The main design idea is that the player itself does not bundle any music service. Instead, all music searching, streaming, and playlist importing happens through plugins that you install separately. The README says that any audio source accessible on the internet can work with the app as long as someone has written a compatible plugin for it. Plugins can handle searching for tracks, albums, artists, and playlists, playing audio, browsing artist profiles, importing individual songs or playlists, and fetching lyrics. Appearance is configurable through theme packs. A theme pack is a folder containing two files: a CSS file that overrides any colors and styles in the interface, and a config.json file that sets a name, description, preview color, and optional background content for different regions of the window such as the header, sidebar, main area, and music bar at the bottom. The README shows several community-created themes including a dark mode, a night sky background, a falling cherry blossom animation, and a rainy season animation. All data is stored locally on your machine. The README states the software does not upload personal information. The project is licensed under AGPL 3.0, which requires that any redistribution or modified version also remain open source. The project asks that redistributors keep a link back to the original repository and that the code not be used for commercial purposes.

Copy-paste prompts

Prompt 1

Write a MusicFreeDesktop plugin in TypeScript that searches and streams tracks from a custom JSON audio API endpoint.

Prompt 2

Create a CSS theme pack for MusicFreeDesktop with a dark OLED background and custom accent colors for the sidebar, header, and bottom music bar.

Prompt 3

Generate the config.json file for a MusicFreeDesktop theme pack with a name, description, preview color, and animated falling-leaf background for the main area.

Prompt 4

How do I install a community plugin in MusicFreeDesktop and configure it to import a playlist from an external source?

Open on GitHub → Explain another repo

← maotoumao on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.