← Back to Skills Marketplace
kaiyuelv

Audio Processor

by Lv Lancer · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
68
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install audio-processor
Description
音频处理工具集 - 支持音频录制、剪辑、格式转换、频谱分析、降噪、变速变调等操作。Use when: (1) 需要处理音频文件(录音、剪辑、合并、分割), (2) 需要转换音频格式(MP3/WAV/FLAC/OGG等), (3) 需要分析音频特征(频谱、音量、静音检测), (4) 需要对音频进行效果处理(降噪、变...
README (SKILL.md)

Audio Processor

音频处理全能工具集,基于 Python + ffmpeg + librosa/pydub 实现。

核心能力

1. 音频格式转换

  • 支持 MP3 / WAV / FLAC / OGG / AAC / M4A 互转
  • 批量转换目录内音频
  • 自定义比特率、采样率、声道数

2. 音频剪辑与合并

  • 按时间码裁剪(hh:mm:ss 格式)
  • 去除首尾静音段
  • 多段音频合并拼接
  • 淡入淡出效果

3. 音频分析

  • 波形可视化(matplotlib)
  • 频谱分析(FFT + spectrogram)
  • 音量检测(RMS / dBFS)
  • BPM / 节奏检测
  • 静音段检测与分割

4. 音频效果处理

  • 降噪(spectral gating)
  • 变速不变调 / 变调不变速
  • 音量标准化(peak / RMS / LUFS)
  • 混响、延迟效果

5. 音频信息提取

  • 时长、采样率、比特率、声道数
  • ID3 标签 / 元数据读写
  • 音频指纹生成

快速开始

# 格式转换
python3 scripts/convert_format.py input.wav output.mp3 --bitrate 320k

# 剪辑音频(从30秒到2分钟)
python3 scripts/cut_audio.py input.mp3 output.mp3 --start 00:00:30 --end 00:02:00

# 分析音频特征
python3 scripts/analyze_audio.py input.mp3 --output report.json

# 降噪处理
python3 scripts/denoise.py input.mp3 output.mp3

# 批量处理目录
python3 scripts/batch_process.py ./audio_dir/ --action convert --format mp3

依赖安装

pip install -r requirements.txt

核心依赖:ffmpeg(系统级)、pydub、librosa、soundfile、mutagen、numpy、matplotlib、noisereduce

脚本说明

脚本 功能
convert_format.py 格式转换,支持所有主流格式
cut_audio.py 按时间码裁剪音频
merge_audio.py 多文件合并拼接
analyze_audio.py 音频特征分析(波形/频谱/BPM)
denoise.py 降噪处理
speed_pitch.py 变速变调
normalize_volume.py 音量标准化
batch_process.py 批量处理目录
extract_metadata.py 元数据提取与编辑
detect_silence.py 静音检测与自动分割

详细用法

参见 references/ 目录:

  • audio-formats.md - 支持的音频格式详解
  • effects-guide.md - 效果处理参数指南
  • api-reference.md - 脚本 API 参考
Usage Guidance
This package appears to be a straightforward local audio-processing toolkit. Before installing or running: (1) ensure ffmpeg is installed on the host (SKILL.md assumes a system ffmpeg binary); (2) run pip install -r requirements.txt in a Python virtualenv; (3) review and run scripts in an isolated or trusted environment because they execute local file operations and call subprocesses (ffmpeg and python scripts) — avoid running them on directories containing sensitive files you don't want modified; (4) note a small documentation mismatch: SKILL.md mentions an api-reference.md that is missing; (5) if you need network isolation, run inside a sandbox/container. Overall the code is coherent with the stated purpose and contains no obvious signs of credential exfiltration or unexpected network activity.
Capability Analysis
Type: OpenClaw Skill Name: audio-processor Version: 1.0.0 The audio-processor skill bundle is a legitimate collection of tools for audio manipulation and analysis using standard libraries like librosa, pydub, and mutagen. The scripts (e.g., convert_format.py, cut_audio.py) interact with ffmpeg using secure subprocess calls with argument lists, avoiding shell injection vulnerabilities. No evidence of data exfiltration, malicious persistence, or prompt injection was found in the code or documentation.
Capability Assessment
Purpose & Capability
Name/description match the provided scripts and requirements. The included Python scripts implement format conversion, cutting/merging, analysis, denoise, metadata, silence detection, normalization, and speed/pitch — exactly what the description claims.
Instruction Scope
SKILL.md instructs running local scripts and installing requirements; the runtime instructions and quick-start examples only reference local files and directories. Minor note: SKILL.md references an 'api-reference.md' that is not present in the repository (small documentation mismatch). The scripts do not read environment secrets or call external network endpoints.
Install Mechanism
No install spec is provided (instruction-only install), and dependencies are standard Python audio packages listed in requirements.txt. The SKILL.md correctly documents a system-level dependency on ffmpeg. There are no downloads from untrusted URLs or extraction of remote archives.
Credentials
No environment variables, credentials, or config paths are requested. The required Python packages and ffmpeg are appropriate for audio processing and proportional to the toolset's purpose.
Persistence & Privilege
always is false and the skill does not request persistent system-wide privileges or attempt to modify other skills/config. Scripts operate on user-supplied files and directories only.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install audio-processor
  3. After installation, invoke the skill by name or use /audio-processor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Audio Processor 1.0.0 初始版本发布 - 支持多种主流音频格式互转(MP3/WAV/FLAC/OGG/AAC/M4A) - 提供音频剪辑、合并、淡入淡出等处理功能 - 实现音频特征分析(波形、频谱、音量、BPM、静音分割) - 支持降噪、变速变调、音量标准化、混响等效果处理 - 可提取和编辑音频元数据(ID3 标签、指纹等) - 批量处理、详细脚本及参数说明
Metadata
Slug audio-processor
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Audio Processor?

音频处理工具集 - 支持音频录制、剪辑、格式转换、频谱分析、降噪、变速变调等操作。Use when: (1) 需要处理音频文件(录音、剪辑、合并、分割), (2) 需要转换音频格式(MP3/WAV/FLAC/OGG等), (3) 需要分析音频特征(频谱、音量、静音检测), (4) 需要对音频进行效果处理(降噪、变... It is an AI Agent Skill for Claude Code / OpenClaw, with 68 downloads so far.

How do I install Audio Processor?

Run "/install audio-processor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Audio Processor free?

Yes, Audio Processor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Audio Processor support?

Audio Processor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Audio Processor?

It is built and maintained by Lv Lancer (@kaiyuelv); the current version is v1.0.0.

💬 Comments