A portable, local audio utility designed for AI agents to convert, compress, merge, split, clip, inspect, and decrypt diverse audio file formats.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install luis-audio-translator
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install luis-audio-translator using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Luis Audio Translator?
Luis Audio Translator is a robust, local-first audio processing utility designed to empower AI coding assistants and automation agents. This tool enables seamless integration with Openclaw Skills, giving developer agents the capability to manipulate media files directly on the host machine without relying on external SaaS APIs. It provides essential media operations including format conversion, bitrate compression, file splitting, merging, time clipping, and metadata inspection using Python and FFmpeg.
By leveraging this utility as part of your Openclaw Skills ecosystem, developers can automate media compilation, extract audio from videos, and even decode complex cached or encrypted audio formats like Ximalaya (.xm) and Kugou (.kgm) locally. Its strict privacy and portability standards guarantee that no sensitive metadata or files are transmitted over the network, making it perfect for secure local environments.
Luis Audio Translator Use Cases
- Audio Format Conversion & Extraction: Seamlessly convert between common audio formats (MP3, WAV, FLAC, M4A) or extract clean audio tracks directly from video files (MP4, MKV).
- High-Fidelity Audio Compression: Downscale high-bitrate audio files to optimized formats or lower bitrates to save disk space and meet file size constraints in downstream AI pipelines.
- Audio Segmenting & Compilation: Split long audio files into equal-duration segments for transcription or merge sequential clips together for unified playback.
- Cached Audio Decryption: Handle specialized local music-cache inputs, such as pure-Python decoding of Ximalaya (.xm) files and Kugou format conversions, directly within Openclaw Skills workflows.
How Luis Audio Translator Works
- Environment Diagnosis: The script first checks the host system configuration to verify Python and FFmpeg/FFprobe availability using the diagnose command.
- Path Resolution: It dynamically resolves the necessary binary engine paths (FFmpeg, FFprobe, and optional helpers) via command-line options, environment variables, or the system PATH.
- Command Execution: The CLI invokes specific subcommands (convert, compress, merge, split, clip, info, decrypt) to orchestrate audio manipulation processes.
- Local Native Processing: The python script routes core actions directly through subprocess calls to FFmpeg, or processes decryption logic natively in Python (such as Ximalaya decryption).
- Metadata & Workflow Reporting: The script outputs structured details (like file paths and execution status) so that AI agents using Openclaw Skills can seamlessly continue their automated pipelines.
Luis Audio Translator Setup
Ensure Python 3.8+ and FFmpeg/FFprobe are installed and available on your system's PATH. Then, check the dependency status by executing the diagnosis command.
# Check dependencies and diagnostic status
python scripts/luis_audio_translator.py diagnose
# Convert a video file to MP3 format
python scripts/luis_audio_translator.py convert "input.mp4" --format mp3 --bitrate 192k --output-dir "out"
# Split an audio file into 300-second segments
python scripts/luis_audio_translator.py split "input.mp3" --segment-seconds 300 --format mp3 --output-dir "out"
# Decrypt a Ximalaya (.xm) cached audio file locally
python scripts/luis_audio_translator.py decrypt "input.xm" --output-dir "out"
For advanced environments, configure local engine directories by setting environment variables:
export LUIS_AUDIO_TRANSLATOR_FFMPEG="/path/to/ffmpeg"
export LUIS_AUDIO_TRANSLATOR_FFPROBE="/path/to/ffprobe"
Luis Audio Translator Data Schema & Taxonomy
Luis Audio Translator works on standard local file system inputs and outputs. It organizes data dynamically based on the target command options:
| Command | Primary Input | Output Generated | Description |
|---|---|---|---|
convert / compress |
Any supported audio/video | Single processed audio file | Converts format and adjusts compression metrics (e.g., bitrates). |
split |
Single audio file | Multiple numbered audio chunks | Chunks files based on specified duration segments. |
merge |
Multiple audio files | Single combined audio file | Concatenates files sequentially using specified format and base name. |
decrypt |
.xm, .ncm (with helper) |
Decrypted audio file (e.g., MP3/FLAC) | Processes proprietary or cached formats natively into standard media files. |
info |
Single audio/video file | Structured stdout/JSON metadata | Provides codec, sample rate, duration, and stream information. |
Luis Audio Translator Advanced Features
- Pure Python Decoders: Built-in support for Ximalaya (.xm) decoding using a pure-Python implementation that requires zero external binaries or Node.js runtimes.
- Kugou Format Converter: Dedicated sub-helper (
scripts/kugou_audio_converter.py) capable of parsing advanced caching extensions including .kgm, .kgma, and .kgtemp utilizing local DLL infrastructure. - Flexible Engine Pathing: Multi-layered engine discovery prioritizing CLI options, custom environment variables, and system PATH mappings for ultimate portability.
- Specialized Audio Container Handling: Advanced output formatting adjustments, such as forcing 8000 Hz mono for
.amr, signed 16-bit configurations for.flac, and automatic MP4 container wrapping for.m4rformats. - AI Agent-Friendly Design: Zero absolute hardcoded paths or absolute identities, enabling reliable directory-relative invocation for Claude, Hermes, and other Openclaw Skills integrations.
SKILL.md
Loading
Related Openclaw Skills
Google Workspace Operator
A direct-OAuth Google Workspace skill that empowers AI agents to manage Gmail, Calendar, Drive, Docs, Sheets, and Slides with zero third-party gateways.
Automotive Marketing Solution
A comprehensive automation skill that helps automotive marketers, dealerships, and OEMs design, search, and deploy end-to-end H5 campaign solutions.
WOSO_lib
A specialized, interactive knowledge repository containing extensive data, literature, and analytical insights on global women's football.
BasicOps MCP Setup
A dedicated setup skill designed to connect, authenticate, and verify BasicOps Model Context Protocol (MCP) integrations in AI agent environments.
Write Planning Document
An AI-powered planning assistant designed to quickly map out comprehensive, launch-ready strategic plans from basic topic inputs.
Write Promotion Strategy
An automated AI planner from the suite of Openclaw Skills designed to craft structured, channel-specific promotion strategies, selling points, and ROI models.
Featured*
