Cliff-Lee/melodex
Cliff-Lee/melodex has 36 GitHub stars and 3 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-09 07:14 UTC. Last push 2026-10-25.
Open-source, local-first music player with a visual Music Map, Album Wall and listening journeys. macOS, Windows, Linux and Android.
What you can do
- Start with three clear paths. Explore offers Search everything, Album Wall and Music Map rather than an overwhelming panel of settings.
- Turn a map into a listening journey. Pick tracks, preview a route of sonic/factual relationships, then play or queue the route. Its displayed score is a route heuristic, not a quality guarantee.
- See details while music plays. Now Playing combines large artwork, optional MusicBrainz context, lyrics, releases and credits.
- Navigate through visuals. The Constellation view surfaces related music as interactive nodes you can inspect and queue.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
README.md
Original
Explore the music collection you already own.
Download Melodex · Get started · Why Melodex? · FAQ · Docs · Help test the beta
Melodex
Melodex is an open-source, local-first music player for exploring your music collection, not just searching and playing it.
Browse your library as a visual album wall, explore relationships between tracks on a music map, and rediscover what you own through listening journeys and interactive playback visuals.
Melodex works with music files you already have, leaves those files where they are, and does not require an account or an AI setup. Connected sources and optional AI controls are there if you want them, but they are not the centre of the experience.
Project status: public beta. The desktop app is the main supported experience; macOS has had the most hands-on testing so far, with packaged Windows and Linux builds also available. Android includes standalone local playback with optional Provider Bridge connectivity. Feedback from real music libraries is especially useful.
See your collection differently
Real screenshots from the running v0.7.29 desktop app. Explore the full six-screen visual tour.
Plan a route through your music

Choose a starting point and destination, preview a route of musical connections, and play or queue the result. Melodex distinguishes factual links from sonic suggestions; the displayed route score is a heuristic, not a promise of perfect recommendations.
Navigate the Music Map

Pan and zoom through cover-art clusters, search for a track, and explore nearby music. The map is interactive, not just an illustration.
Browse your albums visually

Browse by artwork, arrange by sound, and locate artists or albums without relying entirely on long lists.
Discover music while it plays

Constellation offers another route to related tracks: inspect surrounding nodes and queue music without leaving playback.
A simpler starting point, richer listening detail
Explore keeps search, artwork browsing and the map clearly separated. Now Playing provides cover art, recording context and lyrics, with more detail available when you want it.
What you can actually do
- Start with three clear paths. Explore offers Search everything, Album Wall and Music Map rather than an overwhelming panel of settings.
- Turn a map into a listening journey. Pick tracks, preview a route of sonic/factual relationships, then play or queue the route. Its displayed score is a route heuristic, not a quality guarantee.
- See details while music plays. Now Playing combines large artwork, optional MusicBrainz context, lyrics, releases and credits.
- Navigate through visuals. The Constellation view surfaces related music as interactive nodes you can inspect and queue.
- Keep control accessible. A persistent player provides transport and queue controls across pages.
Walk through the current desktop experience →
Why Melodex is different
- Browse visually. Album Wall turns a large collection into something you can scan and wander through.
- Explore relationships. Music Map reveals connections between tracks and lets you move through the library spatially.
- Follow a path instead of shuffling. Choose Comfort, Explore, or Rediscover, tune how familiar or surprising the session should feel, or build a journey between parts of your collection.
- Make playback part of discovery. Interactive visuals such as Constellation keep nearby music within reach while a track is playing.
- Keep your library yours. Local files stay where they are. No account, subscription catalogue, server, or AI model is required.
For more detail on the listening experience, see Why Melodex?.
Get started
- Download the latest release for your device.
- Open My Music → + Add music and choose a folder that contains your music.
- Go to Home and choose Play something.
You don't need Python, Git, a server, or an AI model to install a release build. Melodex indexes and plays your files where they are; it does not move or copy your music.
| Platform | Install guide |
|---|---|
| macOS | Install on macOS |
| Windows | Install on Windows |
| Linux | Install on Linux |
| Android | Android setup — play local phone music or connect to a Melodex Bridge |
macOS first-launch security notice: Current Mac release builds are not Apple Developer ID signed or notarized. macOS may block the first launch. Read the Mac installation and Privacy & Security instructions before approving an app-specific exception. Do not disable Gatekeeper globally. See the Privacy Policy and Security for details.
Melodex does not include a subscription music catalogue. A local collection is the best way to use its listening and discovery features; supported connected sources are also available. See the FAQ for details.
Try the beta
Melodex is still in public beta, and we're looking for everyday listeners. You don't need a huge collection or special expertise. The macOS build has had the most hands-on testing so far; Windows and Linux users are especially useful testers.
If you try it, tell us what was easy, what confused you, whether anything failed, and most importantly whether Melodex gave you a reason to explore something in your collection that you might otherwise have ignored.
Follow the 10-minute tester guide · Send beta feedback · Report a problem
Help and community
- Start Here — install and play your first music.
- FAQ — accounts, AI, music sources, and privacy.
- Troubleshooting — get help when something goes wrong.
- Discussions — ask a question or share an idea.
- Request a feature.
For developers and contributors
You can use Melodex without building it or knowing how it works internally. If you want to contribute, create an integration, or inspect the technical design, these are the right starting points:
- Developer Gateway — choose an app, provider, plugin, or API path.
- 5-minute developer quickstart — fastest route to a working extension/integration setup.
- Status, stability and trust — current maturity and compatibility expectations.
- Ecosystem architecture — how providers, plugins and external control fit together.
- Build from source — development environment and build instructions.
- First contribution — make a change to the project.
- Provider SDK — create a music-source provider.
- API documentation — REST, OpenAPI, MCP, and AI integrations.
- Full documentation index — user and technical references.
- Source and rights policy — requirements for external sources and extensions.
Melodex is open source under the MIT licence. Music and media accessed through connected sources remain subject to those sources' terms and rights.
Explore related projects
ytdl-org/youtube-dl
Command-line program to download videos from YouTube.com and other video sites
141,500 starsexcalidraw/excalidraw
Virtual whiteboard for sketching hand-drawn like diagrams
135,396 starsgodotengine/godot
Godot Engine – Multi-platform 2D and 3D game engine
119,840 starsmrdoob/three.js
JavaScript 3D Library.
117,983 stars