🏷️ CLI Metadata Editor

🎵

mdit

A powerful MP3 Metadata Editor built in pure Bash. Edit titles, artists, and albums directly from the terminal.

Get Started View on GitHub

🏷️

Edit Metadata

🐚

Pure Bash

📦

Batch Processing

🆓

Open Source

About mdit

$ mdit -s

Track 1 by Artist from Album

$ mdit

change? [Y/n/f] y

$ ls mdit_output/

song.mp3 - Updated!

$ _

✏️

Simple Yet Powerful

mdit is a command-line tool that makes editing MP3 metadata incredibly easy. No complex setup, no bloated GUI - just pure, simple functionality.

Built entirely in Bash, mdit provides fast, reliable tag editing with support for interactive mode, batch processing, and regex-powered find & replace.

🐧 Linux 🍎 macOS 💻 CLI 📝 Bash

Key Features

Why Choose mdit?

🎯

Interactive Mode

Interactively select which MP3s to modify. Preview each file and decide with a simple y/n/f prompt.

📦

Batch Processing

Edit all files at once with find & replace. Use regex for powerful pattern matching across your library.

✏️

Each Mode

Edit each file individually with custom prompts. Perfect for unique changes to each track.

🛡️

Safe by Default

Original files stay untouched. Modified files go to mdit_output folder unless you use -i flag.

👁️

Show Tags

Quickly view all metadata with -s or -ss flags. Read-only mode for inspecting your collection.

🆓

Free & Open

Completely free and open source. No ads, no premium tiers, no BS.

Getting Started

Installation

Quick Install

Clone the repository and run the install script:

                    # Clone the repository
                  
                    git clone
                    https://github.com/psdkjoon/mdit.git
                  
                    # Navigate to directory
                  
                    cd mdit
                  
                    # Run installer
                  
                    ./install.sh

Uninstallation

If you ever want to remove mdit (but why would you? 😉):

sudo rm -rf /usr/bin/mdit

Command Reference

Options

Option	Name	Description
`(none)`	Interactive	Default mode. Interactively select which MP3s to modify.
`-s`	Show	Lists Title, Artist, and Album for all files. Read-only.
`-ss`	ShowSmall	Lists metadata in a compact format. Read-only.
`-a`	All	Auto-selects all MP3s, skipping interactive selection.
`-e`	Each	Prompts for each file individually with unique edits.
`-i`	In-place	⚠️ DANGER: Replaces original files with modified ones.
`-h`	Help	Displays help message and exits.

How to Use

Workflow Examples

🎯 Interactive Selection

                  # Run in your music folder
                
                  mdit
                
# Select files: y/n/f
# Then batch edit tags

The default workflow. Select files interactively, then apply find & replace to all.

✏️ Edit Each File

                  mdit -e
                
# Select files first
# Then edit each one

Perfect for unique changes. Edit title, artist, or album for each file individually.

📦 Batch All Files

                  mdit -a
                
# Selects all MP3s
# Supports RegEx!

Auto-select all files for batch processing. Great for fixing entire albums at once.

👁️ View Tags Only

                  mdit -s
                
                  # or compact view:
                
                  mdit -ss

Read-only mode. Quickly inspect all metadata without making any changes.

⚠️ In-Place Editing (Danger Zone)

                  # Replace original files - USE WITH CAUTION!
                
                  mdit -i
                
                  # Can combine with other flags:
                
                  mdit -a -i
                  # All files, in-place
                
                  mdit -e -i
                  # Each file, in-place

⚠️ Back up your files first! The -i flag replaces your originals. By default, mdit saves changes to mdit_output/ and leaves originals untouched.

Ready to organize your music library? 🎵

Get mdit on GitHub