music-tagger

Batch update metadata tags for audio and video files using ffmpeg.

Updated May 28, 2026
One-click install
npx skills add https://github.com/susamn/skills --skill music-tagger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: music-tagger
Source: https://github.com/susamn/skills/tree/main/music-tagger
Command: npx skills add https://github.com/susamn/skills --skill music-tagger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually updating metadata for large collections of media files is extremely time-consuming, and this skill automates the entire batch tagging process to save hours of repetitive work.

Core Features & Use Cases

  • Batch Metadata Updates: Apply artist, album, and other ID3/metadata tags to .mp3, .m4a, and other common media file formats in bulk using ffmpeg.
  • Flexible Tag Mapping: Support for both per-file custom tag sets and a default artist value for all files in a batch.
  • Use Case: If you have a folder of 100 ripped CD tracks that all need their artist and album information updated, this skill can apply the correct metadata to every file in one go instead of editing each file individually.

Quick Start

Use the music-tagger skill to batch update artist, album, and other metadata tags for all media files in your 'my-music' folder using your prepared tag mapping.

Frequently Asked Questions about music-tagger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch update ID3 tags for multiple mp3 files at once?

Batch updating ID3 tags for multiple mp3 files applies artist, album, and custom metadata values across an entire folder simultaneously. By using ffmpeg and a JSON mapping of filenames to tag values, you can update hundreds of files in one operation.

Can I use ffmpeg to edit audio metadata without re-encoding the source files?

Yes, ffmpeg can update audio metadata without re-encoding source media files. The skill applies tag changes directly to the file metadata structures, preserving the original audio stream quality while updating the ID3 tags.

What is the best way to organize metadata for a large folder of ripped CD tracks?

Organizing metadata for a large folder of ripped CD tracks is best handled through automated batch tagging. You can apply a default artist value to all files in the batch while supplying a JSON mapping for any per-file custom tag sets.

Do I need to prepare a specific file format to automate metadata updates for m4a files?

Yes, automating metadata updates for m4a files requires a JSON mapping of filenames to tag values. You also need ffmpeg installed in your environment to apply the metadata changes directly to the audio files.

Does this batch tagging approach support setting a default artist for all files while allowing per-file overrides?

Yes, batch tagging supports setting a default artist value for all files in a batch while allowing per-file custom tag sets. This handles bulk media library organization efficiently by combining global defaults with specific JSON overrides.

Why does batch tagging fail when my media files are missing from the JSON mapping?

Batch tagging relies on a strict JSON mapping of filenames to tag values to apply metadata changes. If media files are missing from this JSON structure, the ffmpeg process cannot locate the target files to update and skips them.