← Back to Skills Marketplace
Music Tagger
by
utopiabenben
· GitHub ↗
· v1.0.0
262
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install music-tagger
Description
音乐文件批量标签工具，支持读取/编辑音乐元数据（歌名、艺术家、专辑、流派等），批量编辑标签，按标签整理音乐文件，预览模式和撤销功能！
README (SKILL.md)
Music Tagger - 音乐文件批量标签工具
功能特性
- ✅ 自动识别音乐文件格式（mp3, flac, wav, aac, m4a, ogg, wma, ape 等）
- ✅ 读取/编辑音乐元数据（歌名、艺术家、专辑、流派、年份、曲目号等）
- ✅ 批量编辑标签
- ✅ 按标签整理音乐文件（艺术家/专辑、流派、年份等）
- ✅ 预览模式（先看效果再执行）
- ✅ 撤销操作（安全可靠）
安装
# 方法一：通过 clawhub 安装
clawhub install music-tagger
# 方法二：作为 Python 脚本运行
git clone \x3Crepo-url>
cd music-tagger
pip install mutagen
依赖说明
当前版本是简化版，主要演示框架。要启用实际标签编辑功能，请安装：
mutagen：处理音乐元数据
快速开始
1. 读取音乐文件标签
music-tagger read song.mp3
2. 编辑音乐文件标签
music-tagger edit song.mp3 --title "My Song" --artist "My Artist" --album "My Album"
3. 批量设置标签
music-tagger batch ./music --artist "My Artist"
4. 按艺术家/专辑整理音乐
music-tagger organize ./music --by artist-album --output ./organized
5. 预览模式
music-tagger organize ./music --by artist-album --preview
6. 撤销操作
music-tagger undo ./organized
详细使用说明
read 命令参数
file：（必需）要读取标签的音乐文件
edit 命令参数
file：（必需）要编辑标签的音乐文件--title：歌名--artist：艺术家--album：专辑--genre：流派--year：年份--track：曲目号
batch 命令参数
directory：（必需）要批量编辑的音乐目录--title：批量设置歌名--artist：批量设置艺术家--album：批量设置专辑--genre：批量设置流派--year：批量设置年份
organize 命令参数
directory：（必需）要整理的音乐目录--by：整理方式，可选artist-album（按艺术家/专辑，默认）、genre（按流派）、year（按年份）--output：输出目录，默认在输入目录下创建organized文件夹--preview：预览模式，只显示方案不实际执行
支持的音乐格式
| 格式 | 说明 |
|---|---|
| mp3 | MP3 音频 |
| flac | FLAC 无损音频 |
| wav | WAV 音频 |
| aac, m4a | AAC 音频 |
| ogg | OGG 音频 |
| wma | Windows Media 音频 |
| ape | APE 无损音频 |
示例场景
场景 1：批量设置艺术家
# 将整个文件夹的音乐艺术家设置为 "My Artist"
music-tagger batch ./music --artist "My Artist"
场景 2：按艺术家/专辑整理音乐
# 按艺术家/专辑整理音乐文件夹
music-tagger organize ./music --by artist-album --output ./Music/Organized
场景 3：先预览，再执行
# 第一步：预览
music-tagger organize ./music --by artist-album --preview
# 第二步：确认没问题后执行
music-tagger organize ./music --by artist-album --output ./organized
注意事项
- 确保已安装所需的依赖库
- 编辑标签前建议先备份原文件
- 建议先用 --preview 预览效果
- 整理前建议先备份原文件
更新日志
v1.0.0 (2026-03-06)
- 初始版本发布
- 支持读取/编辑基本音乐标签
- 支持批量编辑标签
- 支持按标签整理音乐
- 支持预览模式
- 支持撤销操作
Usage Guidance
This skill appears internally consistent and implements local file operations only. Before installing/running: 1) prefer running the provided Python script in a sandbox or test folder; 2) back up your music files (the tool itself also writes a local .music-tagger-backup.json); 3) note that current read/write are simulated — installing 'mutagen' is required for actual tag edits, so review that dependency if you plan to enable real editing; 4) verify the install source/repo (SKILL.md references 'clawhub install' and a repo clone but no concrete URL was provided); and 5) inspect the code yourself if you have concerns about running code from an unknown author.
Capability Analysis
Type: OpenClaw Skill
Name: music-tagger
Version: 1.0.0
The music-tagger skill is a legitimate utility designed for managing music metadata and organizing audio files. The provided Python script (music_tagger.py) implements basic file system operations such as directory creation, file copying, and path management using standard libraries (pathlib, shutil). While the current version uses simulated tag reading and writing (as explicitly stated in the documentation), the logic is transparent, includes user confirmation prompts for batch operations, and provides a safety mechanism via a backup/undo feature. No indicators of data exfiltration, malicious execution, or prompt injection were found.
Capability Assessment
Purpose & Capability
Name/description match the code and documentation. The code implements reading/previewing/organizing/undo for music files. The README/SKILL.md mention mutagen for full tag write support; current code uses simulated read/write, which is coherent for a demo.
Instruction Scope
SKILL.md only instructs running local CLI commands and describes file operations (read/edit/organize/undo). It does not instruct reading unrelated system files, contacting external endpoints, or accessing environment variables.
Install Mechanism
No install spec provided (instruction-only skill) and included code is self-contained. The only third-party dependency mentioned is pip-installable 'mutagen', which is appropriate for the stated purpose and not suspicious. No downloads from arbitrary URLs or archive extraction are used.
Credentials
The skill declares no environment variables, credentials, or config paths. The code operates on user-specified directories only, so requested access is proportionate to the purpose.
Persistence & Privilege
always is false and the skill does not request persistent/system-wide privileges. It writes a local backup file (.music-tagger-backup.json) inside the output directory, which is expected for undo functionality.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install music-tagger - After installation, invoke the skill by name or use
/music-tagger - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
正式版本发布！音乐文件批量标签工具，支持读取/编辑音乐元数据（歌名、艺术家、专辑、流派等），批量编辑标签，按标签整理音乐文件，预览模式和撤销功能！
Metadata
Frequently Asked Questions
What is Music Tagger?
音乐文件批量标签工具，支持读取/编辑音乐元数据（歌名、艺术家、专辑、流派等），批量编辑标签，按标签整理音乐文件，预览模式和撤销功能！. It is an AI Agent Skill for Claude Code / OpenClaw, with 262 downloads so far.
How do I install Music Tagger?
Run "/install music-tagger" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Music Tagger free?
Yes, Music Tagger is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Music Tagger support?
Music Tagger is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Music Tagger?
It is built and maintained by utopiabenben (@utopiabenben); the current version is v1.0.0.
More Skills