← 返回 Skills 市场
luis1213899

Luis Audio Translator

作者 Luisclaw · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
49
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install luis-audio-translator
功能描述
Convert, compress, merge, split, clip, inspect, and extract audio locally with FFmpeg, plus decode supported music-cache formats including pure-Python Ximala...
使用说明 (SKILL.md)

Luis-audio-translator Skill

Overview

Use this skill for local audio processing through scripts/luis_audio_translator.py. It is portable: it does not contain personal paths, API keys, machine identifiers, or bundled proprietary binaries.

The core script works after download when Python is available and FFmpeg is installed on PATH. Ximalaya .xm decoding is built in and uses only Python. Other encrypted/cache formats may require optional local helper binaries.

When to Use

  • Convert audio formats, including extracting audio from video.
  • Compress audio by bitrate.
  • Merge multiple audio files in order.
  • Split a file into equal-duration parts.
  • Clip a time range from an audio/video file.
  • Inspect duration, codec, bitrate, sample rate, and audio streams.
  • Decode supported local music-cache inputs when the user has configured local helper tools.
  • Convert Kugou special formats with scripts/kugou_audio_converter.py.

Prerequisites

  • Python 3.8+.
  • FFmpeg for conversion, merge, split, clip, and video-to-audio.
  • FFprobe for info and duration-aware split.

Resolution order:

  1. Command-line option: --app-dir \x3Cengine-dir>.
  2. Environment variables:
    • LUIS_AUDIO_TRANSLATOR_ENGINE_DIR
    • LUIS_AUDIO_TRANSLATOR_FFMPEG
    • LUIS_AUDIO_TRANSLATOR_FFPROBE
    • LUIS_AUDIO_TRANSLATOR_UM
    • LUIS_AUDIO_TRANSLATOR_MUSIC_TOOL
    • LUIS_AUDIO_TRANSLATOR_SILK
    • LUIS_AUDIO_TRANSLATOR_KGG_HELPER
    • LUIS_AUDIO_TRANSLATOR_KUGOU_INFRA_DLL
    • LUIS_AUDIO_TRANSLATOR_KUGOU_DB
  3. System PATH for ffmpeg and ffprobe.

Do not put user-specific paths in SKILL.md. If a machine needs a local engine directory, set an environment variable outside the skill.

How to Run

Resolve paths relative to the directory containing this SKILL.md.

Check dependency status:

python scripts/luis_audio_translator.py diagnose

Convert or extract audio:

python scripts/luis_audio_translator.py convert "input.mp4" --format mp3 --bitrate 192k --output-dir "out"

Compress:

python scripts/luis_audio_translator.py compress "input.wav" --format mp3 --bitrate 96k --output-dir "out"

Merge:

python scripts/luis_audio_translator.py merge "a.mp3" "b.wav" --format mp3 --output-dir "out" --basename "merged"

Split:

python scripts/luis_audio_translator.py split "input.mp3" --segment-seconds 300 --format mp3 --output-dir "out"

Clip:

python scripts/luis_audio_translator.py clip "input.mp3" --start 00:01:20 --duration 45 --format wav --output-dir "out"

Inspect:

python scripts/luis_audio_translator.py info "input.flac"

Decode local cache input:

python scripts/luis_audio_translator.py decrypt "input.ncm" --output-dir "out"

Decode Ximalaya .xm input:

python scripts/luis_audio_translator.py decrypt "input.xm" --output-dir "out"

Convert Kugou special formats:

python scripts/kugou_audio_converter.py diagnose --app-dir "\x3Cengine-dir>"
python scripts/kugou_audio_converter.py convert "KugouMusic" --format mp3 --output-dir "out" --recursive --app-dir "\x3Cengine-dir>"

Quick Reference

Common output formats: mp3, wav, ogg, flac, m4a, m4r, mp2, aiff, ac3, wma, amr, aac, opus, caf, au, mka, webm.

Kugou special input formats handled by kugou_audio_converter.py: .kgm, .kgma, .kgtemp, .kgm.flac, .kgg.

Ximalaya input handled by luis_audio_translator.py decrypt: .xm.

Special output handling:

  • amr forces 8000 Hz mono.
  • flac uses signed 16-bit sample format.
  • m4r uses an MP4 container.

Read references/core-behavior.md for supported input-extension lists and optional decode helper behavior.

Privacy And Portability

  • The skill does not embed local usernames, absolute install paths, credentials, or machine IDs.
  • The script does not send files or metadata over the network.
  • JSON output may include input/output paths because agents need them to continue workflows.
  • --print-command prints full local paths and should be used only for debugging.

Pitfalls

  • If diagnose reports no FFmpeg, install FFmpeg or set LUIS_AUDIO_TRANSLATOR_FFMPEG.
  • If split fails but convert works, install FFprobe or set LUIS_AUDIO_TRANSLATOR_FFPROBE.
  • Decrypt helpers other than .xm are optional and environment-specific; ordinary conversion and .xm decoding should not depend on them.
  • .kgg conversion needs kgg-helper and a compatible local Kugou infra.dll; KGMusicV3.db is used when available. Run the Kugou converter's diagnose command first.
  • .xm decoding is implemented in pure Python and does not require Node.js, WebAssembly, or external helpers.
  • OpenClaw, Hermes, Claude, and Codex should invoke the script by resolving scripts/luis_audio_translator.py relative to SKILL.md, not by using a machine-specific absolute path.

Verification

  • Run python scripts/luis_audio_translator.py diagnose.
  • Run python -m py_compile scripts/luis_audio_translator.py scripts/kugou_audio_converter.py scripts/xm_audio_decoder.py.
  • Run python scripts/xm_audio_decoder.py --self-test.
  • Generate or provide a short test media file, then run info, convert, merge, and split.
安全使用建议
Install only if you are comfortable with a local audio tool that runs FFmpeg and optional configured helper programs. Avoid using --clean with any output directory that contains important files; use a new empty output folder for split jobs until the cleanup behavior is constrained or documented with stronger safety checks.
能力评估
ℹ Purpose & Capability
The stated purpose and implemented capabilities are coherent: local FFmpeg-based conversion, compression, merge, split, clip, metadata inspection, and supported local cache decoding. The scripts do not show network upload, credential harvesting, hidden telemetry, or unrelated behavior.
⚠ Instruction Scope
Most instructions are scoped to user-invoked local audio operations, but the split command accepts a user-controlled output directory and a --clean flag that recursively removes that directory before writing split files, with no path guard, confirmation, or documented safety boundary.
✓ Install Mechanism
The package contains documentation, YAML prompt metadata, and Python scripts only. It does not bundle proprietary helper binaries or install persistent services; optional external tools are discovered through PATH, --app-dir, or environment variables.
ℹ Credentials
Local file reads and writes, FFmpeg/FFprobe subprocess use, and optional helper execution are proportionate for audio conversion and decoding. The Kugou helper path discovery reads standard local Kugou locations when used, which is disclosed in the reference material.
⚠ Persistence & Privilege
No persistence or privilege escalation was found, but the unbounded recursive deletion behavior under --clean can remove unrelated accessible directories if the output path is mistaken or agent-selected poorly.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install luis-audio-translator
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /luis-audio-translator 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial packaged release: local audio conversion, compression, merge/split/clip/info, pure-Python .xm decoding, and optional helper-backed encrypted/cache audio support.
元数据
Slug luis-audio-translator
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Luis Audio Translator 是什么？

Convert, compress, merge, split, clip, inspect, and extract audio locally with FFmpeg, plus decode supported music-cache formats including pure-Python Ximala... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 49 次。

如何安装 Luis Audio Translator？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install luis-audio-translator」即可一键安装，无需额外配置。

Luis Audio Translator 是免费的吗？

是的，Luis Audio Translator 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Luis Audio Translator 支持哪些平台？

Luis Audio Translator 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Luis Audio Translator？

由 Luisclaw（@luis1213899）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论