Smart Video Tagger and Renamer.
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.
- 📺 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-styleformat - 📦 Pre-processes filenames to avoid duplicate tags
- 🈳 Fallback to
UNDfor 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)
- Fish Shell v3.0+
- ffmpeg (which includes
ffprobe, required for media analysis)
You can install ffmpeg via:
Install with Fisher:
fisher install demartini/videotagger.fish| Command | Description |
|---|---|
videotagger |
Preview all videos in current folder |
videotagger -d, --dry-run |
Show only files that would be renamed |
videotagger -r, --rename |
Rename files and save a log |
videotagger -u, --undo |
Undo last renaming |
videotagger -R, --recursive |
Recursively scan subfolders |
videotagger -v, --version |
Show version |
videotagger -h, --help |
Display help message |
💡 Tip: You can also use
vtas a shortcut alias forvideotagger.
🎬 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.mp4If you are interested in helping contribute, please take a look at our contribution guidelines and open an issue or pull request.
See CHANGELOG for a human-readable history of changes.
Distributed under the MIT License. See LICENSE for more information.