git404hub

what is qmdec fr?

sophomoresty/qmdec — explained in plain English

Analysis updated 2026-05-18

20PythonAudience · generalComplexity · 2/5Setup · moderate

tl;dr

A Windows command-line tool that decrypts QQ Music's proprietary encrypted song files (.mflac/.mgg) into standard FLAC or OGG audio files you can play anywhere.

vibe map

mindmap
  root((qmdec))
    What it does
      Decrypts QQ Music files
      Converts to FLAC or OGG
      Embeds song metadata
    How it works
      Reads session from memory
      Fetches decryption keys
      RC4-based decryption
    Use Cases
      Personal music library
      Offline playback
      Cross-device transfer
    Tech Stack
      Python
      Windows API
      QQ Music API
    Setup
      Standalone EXE
      pip install option

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 make with this?

VIBE 1

Convert your QQ Music VIP downloads to standard FLAC files so you can play them in any music player.

VIBE 2

Pre-fetch decryption keys for an entire folder of songs to enable offline decryption later.

VIBE 3

Copy cached decryption keys to another computer that does not have QQ Music installed.

what's the stack?

PythonWindows APIRC4 encryptionQQ Music API

how it stacks up fr

sophomoresty/qmdecalex72-py/aria-termuxanime0t4ku/gentleman
Stars202020
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity2/52/52/5
Audiencegeneraldevelopergeneral

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a VIP subscription to QQ Music and a Windows machine with QQ Music running for initial authentication.

No license information was mentioned in the explanation.

in plain english

qmdec is a command-line tool for Windows that converts the encrypted music files downloaded by QQ Music (a Chinese music streaming service) into standard audio files you can play in any music player. When QQ Music's VIP subscribers download songs, the files are saved in proprietary encrypted formats (.mflac and .mgg) that only play inside the QQ Music app itself. This tool decrypts those files and converts them to standard FLAC or OGG audio, and it also fetches and writes the song's title, artist, album, and cover art into the output file automatically. The tool works in three steps. First, you run an authentication command while QQ Music is open and logged in. The tool reads the session credential directly from QQ Music's running process memory using a standard Windows system call, so there is nothing to copy or paste manually. Second, that credential is used to contact QQ Music's API to retrieve the decryption key for each song file. Those keys are saved locally. Third, the files are decrypted using the same RC4-based cipher that QQ Music uses internally. Once the decryption keys are cached locally, you can decrypt files without an internet connection and without QQ Music running. The cached keys do not expire, so they can also be copied to another computer that does not have QQ Music installed. A separate cache-keys command lets you pre-fetch keys for an entire folder at once. Installation is either a standalone Windows executable (no Python required) or a pip package for Python 3.10 and above. The README is bilingual, with the full documentation available in both English and Chinese. A VIP subscription to QQ Music is required to use the tool, because the encrypted files themselves are only available to paying subscribers and the decryption key API checks for VIP status.

prompts (copy fr)

prompt 1
I have .mflac files from QQ Music. Using qmdec, write me the exact commands to authenticate, cache keys for a folder, and then decrypt all files in that folder to FLAC.
prompt 2
How does qmdec read the QQ Music session credential from process memory on Windows? Explain what Windows API call it uses and why this is safer than manual copy-paste.
prompt 3
I want to script qmdec to automatically decrypt all new .mflac files dropped into a folder. Write a Python or batch script that watches the folder and runs qmdec on new files.
prompt 4
How do I install qmdec as a pip package on Python 3.10 and set it up to convert QQ Music downloads to OGG format?

Frequently asked questions

what is qmdec fr?

A Windows command-line tool that decrypts QQ Music's proprietary encrypted song files (.mflac/.mgg) into standard FLAC or OGG audio files you can play anywhere.

What language is qmdec written in?

Mainly Python. The stack also includes Python, Windows API, RC4 encryption.

What license does qmdec use?

No license information was mentioned in the explanation.

How hard is qmdec to set up?

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

Who is qmdec for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.