Smart Video Tagger and Renamer.

• About
• Features
• Requirements
• Installation
• Usage
  • Example output
• Contributing
• Changelog
• License

If you run a media server (Plex, Radarr, Sonarr, etc), you know how important it is to keep your library clean and consistent.

But when downloading video files manually, filenames often come messy, inconsistent, and break automation — or just clutter your collection.

videotagger helps fix that.

It intelligently analyzes your video files (using ffprobe) and generates new, standardized filenames that reflect each file's resolution, codec, audio layout, and subtitles — all without requiring any manual tagging.

It's built for speed, flexibility, and everyday use.

(back to top)

• 📺 Detects and tags resolution (e.g. 720p, 1080p)
• 🎥 Detects video codec (H264, HEVC, etc.)
• 🔊 Tags audio tracks by codec, channel layout and language (AAC2.0 (ENG))
• 💬 Includes subtitle info (e.g. MSubs, ENGSub)
• 📝 Renames files using a consistent scene-style format
• 📦 Pre-processes filenames to avoid duplicate tags
• 🈳 Fallback to UND for undefined language streams
• 🚫 Skips files with missing resolution or invalid metadata
• 🧪 Dry-run mode for safe previews
• 🔁 Undo feature with log tracking
• 📁 Recursive support for batch folders
• 🐚 Native Fish Shell script — no external dependencies (besides ffmpeg)

(back to top)

• Fish Shell v3.0+
• ffmpeg (which includes ffprobe, required for media analysis)

You can install ffmpeg via:

brew install ffmpeg      # macOS (Homebrew)
sudo apt install ffmpeg  # Debian/Ubuntu

(back to top)

Install with Fisher:

fisher install demartini/videotagger.fish

(back to top)

💡 Tip: You can also use vt as a shortcut alias for videotagger.

🎬 File:        Some.Movie.2023.mp4
📺 Resolution:  1080p
🎥 Video:       H264
🔊 Audio:       AAC2.0 (ENG)
💬 Subtitle:    Multiple languages (2)
📝 New name:    Some.Movie.2023.1080p.WEB-DL.ENG-AAC2.0.H264.MSubs.mp4

(back to top)

If you are interested in helping contribute, please take a look at our contribution guidelines and open an issue or pull request.

(back to top)

See CHANGELOG for a human-readable history of changes.

(back to top)

Distributed under the MIT License. See LICENSE for more information.

(back to top)