CHAP — CHeck Audio Paths for Ren'Py

🛠 Fix broken audio references in seconds — with safety, style, and color. Made for every Ren'Py dev who's ever seen a missing play music path crash their scene.

What It Does

CHAP scans your entire Ren'Py project for broken or outdated audio file references (like "bgm_theme.mp3" or "audio/click.ogg") and offers:

✅ Interactive Fix Mode
🧪 Dry-Run Preview
⚙️ Batch Auto-Fix (with backup!)

Why You Need It

Ren'Py lets you organize audio into folders like audio/bgm/ or audio/sfx/, but...

• Did you rename or move files?

• Clone old scripts but forget to update "title_theme.ogg"?

• Suddenly see your music not playing?

Let CHAP clean that up for you — and even fix paths automatically.

✨ Features

• Detects broken audio paths in .rpy files

• Suggests fixes based on filename matches in game/audio/...

• Verifies new paths actually exist

• Interactive mode with line previews and color highlights

• Dry-run for safe diff viewing

• Batch fix mode with red warning ⚠️

• Backs up changed files (.bak)

• Logs everything — neatly grouped by file

• Skips code-generated paths like "{voice}_{name}.ogg"

How To Use

1. Drop check_audio_paths.py in your Ren'Py project folder

2. Open terminal (PowerShell / bash / VS Code terminal <- the coolest way!)

3. Run:

python3 chap_2.0.3.py

Follow the prompts to scan & fix!

What's Inside

• check_audio_paths.py — the tool

• README.md — full usage instructions

• LICENSE.txt — you can use it commercially (just credit the author)

License & Credits

Creative Commons Attribution 4.0 (CC BY 4.0) Made with ❤️ by RPS-games, bodagrave (and the friendly eyes and neurons of ChatGPT) Feel free to remix, improve, and share — just keep the name & author intact.

☕ Support This Tool

Saved you hours of tedious Ren'Py debugging? Let CHAP earn a tip by donating here!

CHAP — because every dev needs a reliable audio butler - and coffee. We cannot provide the latter, but let be CHAP your CHAMP!