# tvnamer mit Homebrew, Nix, apt installieren Prüfe Installationswege, Executables, Metadaten und Sicherheitshinweise für tvnamer in AI-Agent-Workflows. ## Installation ```sh sudo av install brew:tvnamer ``` Weitere Installationsbefehle: ### macOS - Homebrew (100%): ```sh brew install tvnamer ``` Evidenz: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#tvnamer ``` Evidenz: nixpkgs package indexes: pkgs/by-name/tv/tvnamer/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt (92%): ```sh sudo apt install tvnamer ``` Evidenz: Ubuntu 24.04 LTS package indexes: tvnamer from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz ## Paketfakten - **Paketschlüssel:** brew:tvnamer - **Paketmanager:** Homebrew - **Version:** 3.0.4 - **Quellzusammenfassung:** Automatic TV episode file renamer that uses data from thetvdb.com - **Homepage:** - **Repository:** - **Zuletzt aktualisiert:** 2026-05-15T11:15:11Z - **Generiert:** 2026-08-03T19:37:03+00:00 ## Executables - tvnamer (Alias) ## Installationsverhalten - Bottle: nicht verfügbar ## Version und Aktualität - Seite generiert: 2026-08-03 - Manager-Version: 3.0.4 ## Projektgeschichte und Nutzung 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. ### Projektgeschichte 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. ### Adoptionsgeschichte 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. ### Wie es verwendet wird 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. ### Warum Paket-Nerds sich dafür interessieren 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. ### Zeitleiste - 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 ### Quellen - 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. - - source_facts.package-manager: Homebrew, Nix, and Ubuntu package-manager presence. ## Sicherheitshinweise Für tvnamer wurde kein passendes lokales Secret-Handling-Manifest gefunden. Nucleus-Paketmetadaten bleiben hier veröffentlicht, damit künftige Abdeckung eine stabile Paket-URL hat. ## 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 - Unix: ~/.config/tvnamer/tvnamer.json ## Andere Paketmanager-Einträge - Nix - tvnamer: normalized package name match | nixpkgs package indexes: pkgs/by-name/tv/tvnamer/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - tvnamer - 3.0.4-2: normalized package name match | Ubuntu 24.04 LTS package indexes: tvnamer from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | utility to rename TV-show episodes files | https://github.com/dbr/tvnamer ## Combined YAML source View the package source record on GitHub. [combined/tvnamer.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tvnamer.yml) ## Quellen - pkg.so package database - Geiger risk classifier - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph