audio-rename

What This Skill Does

The audio-rename skill is a specialized utility designed to normalize audio filenames by removing Chinese characters, special symbols, or non-standard encoding. Many machine learning transcription tools, specifically those built on MLX-STT (Machine Learning Exploration Speech-to-Text), often encounter file path errors or processing failures when dealing with non-ASCII characters. This skill automatically detects files with problematic naming conventions and converts them into safe, English-based identifiers (e.g., 'audio_001.m4a'), ensuring seamless downstream processing for AI-driven transcription tasks.

Installation

To install this skill on your OpenClaw agent, run the following command in your terminal: clawhub install openclaw/skills/skills/ayakolin/audio-rename

Ensure that you have Python 3 installed in your environment, as the skill utilizes Python's robust Unicode handling to safely rename files without corrupting metadata or losing file associations.

Use Cases

This skill is essential for users who frequently download media content from platforms like Bilibili, where filenames are often generated using complex Chinese characters. It is particularly useful for researchers, content creators, and developers building automated transcription pipelines. If you are preparing a large library of audio files for batch processing through local LLM-based speech tools, this utility eliminates the manual drudgery of renaming hundreds of files, preventing execution crashes caused by path-handling bugs in underlying libraries.

Example Prompts

1. "OpenClaw, please run the audio-rename tool on all .m4a files located in my downloads folder to make them compatible with my transcription workflow."
2. "Rename the audio file located at /Users/user/recordings/会议录音.m4a to a standard English name like meeting_audio.m4a."
3. "Batch process the audio directory /path/to/media/ using audio-rename so I can start the mlx-stt transcription process without path errors."

Tips & Limitations

• Safety: Always verify your directory paths before running the --all flag to prevent unintended mass renaming in root folders.
• Conflicts: The script intelligently handles name collisions by appending incrementing numbers, but it is recommended to back up your original files if you are working with sensitive data.
• Compatibility: While the script works on most Unix-based systems, ensure you have sufficient read/write permissions for the target directories. The script relies on standard Python libraries, making it highly portable across different operating systems, though it is optimized for macOS/Linux environments where MLX frameworks are typically deployed.