explaingit

foamzou/melody

Analysis updated 2026-07-03

3,743JavaScriptAudience · generalComplexity · 2/5Setup · easy

TLDR

A self-hosted web tool that searches Chinese music platforms for songs and uploads them to your NetEase Cloud Music account, including unlocking greyed-out restricted tracks in playlists.

Mindmap

mindmap
  root((Melody))
    What it does
      Music uploader
      Playlist unlock
      Cloud disk sync
    Sources
      NetEase Music
      QQ Music
      bilibili audio
    Features
      Keyword search
      URL extraction
      One-click upload
    Deployment
      Docker
      PWA support
      Mobile browser
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search for a song on QQ Music or bilibili and upload it to your NetEase Cloud Music cloud disk for personal listening across devices.

USE CASE 2

Scan a NetEase playlist to automatically replace greyed-out restricted tracks with matching uploads from public sources.

USE CASE 3

Run Melody on your own server using Docker and access it from a mobile browser or install it as a PWA.

What is it built with?

JavaScriptDocker

How does it compare?

foamzou/melodyexternalizable/bongo.catschemastore/schemastore
Stars3,7433,7403,746
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires a NetEase Cloud Music account, PWA features need HTTPS, so a reverse proxy with a certificate is needed for mobile install.

Intended for personal use only with no commercial use permitted, no explicit open-source license is stated.

In plain English

Melody is a personal music management tool for Chinese music streaming platforms. Its main purpose is to help users move songs from various online sources into the cloud storage of their NetEase Cloud Music account, making those tracks available for personal listening across devices. The tool can search for music across several Chinese platforms and video sites, including NetEase Cloud Music, QQ Music, Kugou, bilibili, and Douyin. Once a matching track is found, users can preview it and upload it to their cloud disk with one click. Searching works by keyword or by pasting a URL from a video site like bilibili, which extracts the audio automatically. One of the more distinctive features is a playlist "unlock" function for NetEase Cloud Music. When songs in a playlist are greyed out and unplayable due to licensing restrictions, Melody can scan the playlist, find the same track through publicly available sources, upload the best match to the cloud disk, and link it to the original track's metadata so that lyrics and comments still appear. The README describes this as an experimental feature. The project supports Docker deployment for straightforward self-hosting and has a web interface that works on mobile browsers. Progressive Web App installation is supported as well, though HTTPS is required for PWA features to work. The tool is intended strictly for personal use and not for commercial purposes. No online demo is offered to avoid potential licensing complications. The README is written in Chinese. The project is built with JavaScript and relies on the author's separate media-get library for audio retrieval across different sites.

Copy-paste prompts

Prompt 1
I have Melody running with Docker. How do I search for a bilibili video URL and extract and upload its audio to NetEase Cloud Music?
Prompt 2
Walk me through using Melody's playlist unlock feature to replace greyed-out tracks in a NetEase Cloud Music playlist.
Prompt 3
How do I enable HTTPS for my self-hosted Melody instance so I can install it as a PWA on my phone?
Prompt 4
Help me troubleshoot why a keyword search in Melody returns results but the upload to NetEase Cloud Music is failing.

Frequently asked questions

What is melody?

A self-hosted web tool that searches Chinese music platforms for songs and uploads them to your NetEase Cloud Music account, including unlocking greyed-out restricted tracks in playlists.

What language is melody written in?

Mainly JavaScript. The stack also includes JavaScript, Docker.

What license does melody use?

Intended for personal use only with no commercial use permitted, no explicit open-source license is stated.

How hard is melody to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is melody for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub foamzou on gitmyhub

Verify against the repo before relying on details.