brew / rank 5188

Install tvnamer with Homebrew, Nix, apt

Automatic TV episode file renamer that uses data from thetvdb.com. Version 3.0.4 via Homebrew; verified 2026-05-15. Also installable with nix: nix profile install nixpkgs#tvnamer.

Install command Security notes

install

Additional install commands

macOS

Homebrewverified · 100%

brew install tvnamer

local Homebrew formula metadata

Linux

Nixverified · 92%

nix profile install nixpkgs#tvnamer

nixpkgs package indexes · pkgs/by-name/tv/tvnamer/package.nix · source: api.github.com

Ubuntu aptverified · 92%

sudo apt install tvnamer

Ubuntu 24.04 LTS package indexes · tvnamer · source: archive.ubuntu.com

overview

Package summary

Automatic TV episode file renamer that uses data from thetvdb.com

Project links

Homepage

Commands and aliases

tvnamer

history

Project history and usage

tvnamer is a Python command-line utility for renaming TV episode files by parsing filenames and looking up episode metadata through tvdb_api and TheTVDB data.

Project history

The official GitHub repository was created in July 2009, placing tvnamer in the older generation of home-media-library command-line tools. Its README describes the core transformation from scene-style names such as `some.show.s01e03...avi` to cleaner names such as `Some Show - [01x03] - The Episode Name.avi`.

The README documents a v2-era shift toward extensive JSON configuration, saying custom configuration was one of the largest improvements in tvnamer v2. It later records Python 3.5+ support and notes that tvnamer 3 was the last version to support Python 2.7.

Adoption history

tvnamer's adoption came from media-library automation rather than from a single platform ecosystem. The official README says pip is the official install method and also lists community packaging for Homebrew, Debian, FreeBSD/DragonFlyBSD/MacPorts, and Nix; the supplied package metadata records Homebrew, Nix, and Ubuntu entries.

Its package-manager relevance comes from the old but durable need to normalize downloaded or ripped TV episode files before media centers, NAS folders, and archive scripts consume them.

How it is used

The basic workflow is `tvnamer file_or_directory`: tvnamer parses episode-like filenames, searches TVDB data, prompts the user to confirm a match, and renames files. It can run on individual files, multiple paths, directories, or recursively with `--recursive`.

For automation, the README highlights `--selectfirst`, `--always`, and `--batch`, plus `--series-id` for disambiguation. Users can save or place a JSON config at `~/.config/tvnamer/tvnamer.json` to customize language, filename formats, replacements, and safety behavior.

Why package nerds care

tvnamer is a classic package-nerd utility: small, scriptable, long-lived, and very specific. It sits at the intersection of Python packaging, Homebrew/Debian/Nix distribution, and personal media curation workflows.

Timeline

2009: Official GitHub repository created.
2010s: v2 series introduced JSON configuration according to the README.
2020: README notes tvnamer 3 as the final Python 2.7-compatible release.
2021: GitHub metadata shows the last push in May 2021 while package metadata still records active package-manager entries.

Related projects

TheTVDB
tvdb_api
Python packaging
media-center file organization

Sources

GitHub API for dbr/tvnamer: repository created 2009-07-16, homepage, description, license, and push metadata.
current_curation.repo: existing curated repository URL corroborates official GitHub repo.
https://github.com/dbr/tvnamer README: purpose, examples, official pip install, community package list, features, batch mode, recursive mode, config path, and Python version notes.
source_facts.package-manager: Homebrew, Nix, and Ubuntu package-manager presence.

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for tvnamer. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: ~/.config/tvnamer/tvnamer.json

executables

Installed executables

Command	Kind	Exposure	Note
`tvnamer`	executable	indexed executable	Discovered from the local executable index.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-08-03

manager version3.0.4

manager updated2026-05-15

local dataunknown

upstreamnot available

latest detectednot detected

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:tvnamer
Version	3.0.4
Package manager	Homebrew
Homepage	https://github.com/dbr/tvnamer
Repository	https://github.com/dbr/tvnamer
Last updated	2026-05-15T11:15:11Z
Pulse	updated
Bottle	not recorded
Service	none declared

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

tvnamer

nix profile install nixpkgs#tvnamer

normalized package name match
Matched by: Tvnamer

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/tv/tvnamer/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

Ubuntu apt95%

tvnamer 3.0.4-2

utility to rename TV-show episodes files

https://github.com/dbr/tvnamer

sudo apt install tvnamer

Section: universe/video
Architecture: all
3 dependencies
normalized package name match
Matched by: Tvnamer

Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: tvnamer from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/tvnamer.yml

Used sources

Geiger risk classifier
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
pkg.so package database
pkgdb category and tag curation