How do I install the Cd2flac skill?

Run npx skillmds@latest add lord1egypt/cd2flac in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cd2flac safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: FAIL. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cd2flac?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cd2flac free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cd2flac?

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cd2flac by lord1egypt — Agent Skill

Name: Cd2flac
Rating: 4.2 (5 reviews)
Author: Lord1Egypt

Cd2flac

Convert CD audio archives (RAR files containing WAV+CUE pairs) into organized FLAC files. Handles RAR extraction, CUE-based track splitting, GBK encoding fix for Chinese filenames, multi-CD album organization, and auto-fetch synced lyrics from Netease Cloud Music (with Kugou fallback). Use whenever someone needs to extract and convert CD-quality audio archives (WAV+CUE in RAR/7z/ZIP) to per-track FLAC files. Also handles direct WAV+CUE pairs without archives.

Lord1Egypt Updated Sep 8, 2026 2 repo stars

File contents

CD to FLAC Converter

Tool to extract CD audio from RAR archives and convert WAV+CUE pairs into individual FLAC tracks with correct names and synced lyrics.

Requirements

System packages: unrar, cuetools, shntool, flac
Install: sudo apt-get install -y unrar cuetools shntool flac

Python dependencies

mutagen (FLAC tag handling)
pycryptodome (Netease API encryption)
Install: pip3 install mutagen pycryptodome

Usage

python3 skills/cd2flac/scripts/cd2flac.py <directory> [options]

Basic — process RAR archives in a directory

python3 skills/cd2flac/scripts/cd2flac.py "/path/to/albums/"

With synced lyrics (Netease + Kugou)

python3 skills/cd2flac/scripts/cd2flac.py "/path/to/albums/" --lyrics

Inject lyrics into already converted FLACs (no conversion)

python3 skills/cd2flac/scripts/cd2flac.py "/path/to/albums/" --lyrics-only

Standalone lyric injector (for any FLAC directory)

python3 skills/cd2flac/scripts/lyric.py "/path/to/album/"
python3 skills/cd2flac/scripts/lyric.py "/path/to/track.flac"

Dry run — preview without changes

python3 skills/cd2flac/scripts/cd2flac.py "/path/to/albums/" --dry-run

Keep WAV/CUE, delete RAR after extraction

python3 skills/cd2flac/scripts/cd2flac.py "/path/" --keep-wav --delete-rar

Process subdirectories recursively

python3 skills/cd2flac/scripts/cd2flac.py "/path/" --recursive --lyrics

Process already-extracted WAV+CUE pairs (no RAR)

python3 skills/cd2flac/scripts/cd2flac.py "/path/to/album_with_wav/"

What It Does

Extract: Unpacks RAR archives in the target directory
Parse CUE: Reads CUE sheets in GBK/GB18030/UTF-8 encoding, extracts track titles
Split: Uses shnsplit to split each WAV into individual FLAC tracks
Fix names: Renames garbled tracks (CUE files in Chinese encodings produce mojibake filenames) using correct track titles from the CUE sheet
Organize: Multi-CD albums get CD1/, CD2/, etc. subdirectories
Lyrics: Auto-fetch synced lyrics from Netease Cloud Music (primary) and Kugou (fallback), inject as FLAC LYRICS tag with translation support
Clean up: Deletes original WAV and CUE files (optional: keep them)

Lyric Injection

Lyrics are fetched using the same strategy as ESLyric:

Primary: Netease Cloud Music via linuxapi (AES-ECB encryption, no login needed)
Fallback: Kugou Music

Synced LRC is embedded as Vorbis comment LYRICS tag. If Netease provides translation lyrics, they go in LYRICS_TRANSLATIONS tag.

Common Scenarios

Chinese album with garbled filenames

The script auto-detects and fixes GBK→UTF-8 mojibake in track names by comparing the actual filename bytes against the CUE sheet's GBK-encoded titles.

Multi-CD albums

If a directory contains multiple WAV+CUE pairs, they are treated as separate discs and placed into CD1/, CD2/, etc. subdirectories.

Already extracted albums

If the RAR is already extracted but not yet converted, the script detects the WAV+CUE pairs and processes them directly.

Add lyrics to an existing FLAC library

find /path/to/music -name "*.flac" -exec dirname {} \; | sort -u | \
  xargs -I{} python3 skills/cd2flac/scripts/lyric.py "{}"

---name: cd2flacdescription: Convert CD audio archives (RAR files containing WAV+CUE pairs) into organized FLAC files. Handles RAR extraction, CUE-based track splitting, GBK encoding fix for Chinese filenames, multi-CD album organization, and auto-fetch synced lyrics from Netease Cloud Music (with Kugou fallback). Use whenever someone needs to extract and convert CD-quality audio archives (WAV+CUE in RAR/7z/ZIP) to per-track FLAC files. Also handles direct WAV+CUE pairs without archives.---# CD to FLAC ConverterTool to extract CD audio from RAR archives and convert WAV+CUE pairs intoindividual FLAC tracks with correct names and synced lyrics.## Requirements- **System packages**: `unrar`, `cuetools`, `shntool`, `flac`- Install: `sudo apt-get install -y unrar cuetools shntool flac`## Python dependencies- `mutagen` (FLAC tag handling)- `pycryptodome` (Netease API encryption)- Install: `pip3 install mutagen pycryptodome`## Usage```bashpython3 skills/cd2flac/scripts/cd2flac.py <directory> [options]```### Basic — process RAR archives in a directory```bashpython3 skills/cd2flac/scripts/cd2flac.py "/path/to/albums/"```### With synced lyrics (Netease + Kugou)```bashpython3 skills/cd2flac/scripts/cd2flac.py "/path/to/albums/" --lyrics```### Inject lyrics into already converted FLACs (no conversion)```bashpython3 skills/cd2flac/scripts/cd2flac.py "/path/to/albums/" --lyrics-only```### Standalone lyric injector (for any FLAC directory)```bashpython3 skills/cd2flac/scripts/lyric.py "/path/to/album/"python3 skills/cd2flac/scripts/lyric.py "/path/to/track.flac"```### Dry run — preview without changes```bashpython3 skills/cd2flac/scripts/cd2flac.py "/path/to/albums/" --dry-run```### Keep WAV/CUE, delete RAR after extraction```bashpython3 skills/cd2flac/scripts/cd2flac.py "/path/" --keep-wav --delete-rar```### Process subdirectories recursively```bashpython3 skills/cd2flac/scripts/cd2flac.py "/path/" --recursive --lyrics```### Process already-extracted WAV+CUE pairs (no RAR)```bashpython3 skills/cd2flac/scripts/cd2flac.py "/path/to/album_with_wav/"```## What It Does1. **Extract**: Unpacks RAR archives in the target directory2. **Parse CUE**: Reads CUE sheets in GBK/GB18030/UTF-8 encoding, extracts track titles3. **Split**: Uses `shnsplit` to split each WAV into individual FLAC tracks4. **Fix names**: Renames garbled tracks (CUE files in Chinese encodings produce mojibake filenames) using correct track titles from the CUE sheet5. **Organize**: Multi-CD albums get `CD1/`, `CD2/`, etc. subdirectories6. **Lyrics**: Auto-fetch synced lyrics from Netease Cloud Music (primary) and Kugou (fallback), inject as FLAC LYRICS tag with translation support7. **Clean up**: Deletes original WAV and CUE files (optional: keep them)## Lyric InjectionLyrics are fetched using the same strategy as ESLyric:- **Primary**: Netease Cloud Music via linuxapi (AES-ECB encryption, no login needed)- **Fallback**: Kugou MusicSynced LRC is embedded as Vorbis comment `LYRICS` tag. If Netease providestranslation lyrics, they go in `LYRICS_TRANSLATIONS` tag.## Common Scenarios### Chinese album with garbled filenamesThe script auto-detects and fixes GBK→UTF-8 mojibake in track names bycomparing the actual filename bytes against the CUE sheet's GBK-encoded titles.### Multi-CD albumsIf a directory contains multiple WAV+CUE pairs, they are treated as separatediscs and placed into `CD1/`, `CD2/`, etc. subdirectories.### Already extracted albumsIf the RAR is already extracted but not yet converted, the script detects theWAV+CUE pairs and processes them directly.### Add lyrics to an existing FLAC library```bashfind /path/to/music -name "*.flac" -exec dirname {} \; | sort -u | \ xargs -I{} python3 skills/cd2flac/scripts/lyric.py "{}"```

Frequently asked questions