# music-geshizhuanhuan

> Self-hosted tool decrypting NCM, QMC, KGM, KWM files from major Chinese music platforms into standard audio formats via local web UI and CLI.

- **Category:** Audio Processing
- **Licence:** MIT
- **Latest version:** v0.1.0
- **Open source:** oss
- **Languages:** Python, HTML
- **Platforms:** Windows, macOS
- **Tags:** CLI, Audio, Music, Metadata, Converter, Batch Processing, Python, Flask, Self Hosted, Web App, Format Conversion, Decrypt, Ncm, Qmc, Kgm, Kwm, Kugou, Kuwo, Netease, Qqmusic

## Description

music-geshizhuanhuan is a cross-platform tool for decrypting encrypted music files from four major Chinese music platforms: NetEase Cloud Music (.ncm), QQ Music (.mflac, .mgg, .qmcflac, .qmcogg, etc.), Kugou Music (.kgm, .kgma, .vpr), and Kuwo Music (.kwm). It provides both a web interface (Flask-based, runs on localhost:8686) with drag-and-drop batch processing, real-time progress, cover art preview, and ZIP download, and a command-line interface for scripting and automation. The decryption engines are implemented from scratch in pure Python with only three third-party dependencies (pycryptodome, mutagen, flask). It preserves metadata and cover art, supports unified transcoding via ffmpeg, and runs on macOS, Linux, and Windows. Known limitations: Kugou v5 (.kgg) and new Kuwo formats are not yet supported; new QQ Music files without embedded keys require an Android key database.

## Links

- [Homepage](https://github.com/hruiccc/music-geshizhuanhuan)
- [GitHub Repository](https://github.com/HRuiCcc/music-geshizhuanhuan)
- [Demo Video (MP4)](https://github.com/HRuiCcc/music-geshizhuanhuan/releases/download/v0.1.0/ceshi-demo.mp4)

---
Source: https://selfhost.directory/project/music-geshizhuanhuan