tvnamer ☆
« Back to VersTracker
Description:
Automatic TV episode file renamer that uses data from thetvdb.com
Type: Formula  |  Latest Version: 3.0.4@12  |  Tracked Since: Oct 11, 2025
Links: Homepage  |  formulae.brew.sh
Category: Multimedia
Tags: tv media renamer thetvdb automation cli
Install: brew install tvnamer
About:
tvnamer is a command-line utility that automatically renames TV episode files based on metadata fetched from TheTVDB. It parses filenames to identify show and episode details, then organizes files into standardized naming conventions and directory structures. This tool eliminates manual renaming and ensures consistent media libraries for Plex, Kodi, and other media servers.
Key Features:
  • Automatic fetching of episode metadata from TheTVDB API
  • Flexible renaming patterns and directory organization
  • Batch processing of entire season directories
  • Handles various file formats and naming conventions
  • Configurable via JSON or command-line options
Use Cases:
  • Organizing downloaded TV show episodes into consistent file structures
  • Preparing media libraries for Plex, Kodi, or Jellyfin
  • Batch renaming large collections of episodes after initial download
Alternatives:
  • filebot – FileBot is more feature-rich with GUI and broader format support, but is proprietary and requires a license for ongoing use
  • sickbeard – SickBeard is an automated download manager with renaming features, while tvnamer focuses solely on renaming existing files
Version History
Detected Version Rev Change Commit
Jan 11, 2026 8:24am 12 REVISION_ONLY 01639cb5
Oct 11, 2025 8:46pm 10 VERSION_BUMP 127ae070
Oct 11, 2025 12:27pm 10 VERSION_BUMP a0957e4f
Sep 12, 2024 6:29pm 8 VERSION_BUMP e106504c
« Back to VersTracker  |  Browse Packages  |  About