# Installer tvnamer avec Homebrew, Nix, apt

Consultez les chemins d'installation, exécutables, métadonnées et notes de sécurité de tvnamer pour les workflows d'agents IA.

## installation

```sh
sudo av install brew:tvnamer
```

Commandes d'installation supplémentaires:

### macOS

- Homebrew (100%):

```sh
brew install tvnamer
```

  Preuve: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#tvnamer
```

  Preuve: 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
```

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

## Faits du paquet

- **Clé du paquet:** brew:tvnamer
- **Gestionnaire de paquets:** Homebrew
- **Version:** 3.0.4
- **Résumé source:** Automatic TV episode file renamer that uses data from thetvdb.com
- **Page d'accueil:** <https://github.com/dbr/tvnamer>
- **Dépôt:** <https://github.com/dbr/tvnamer>
- **Dernière mise à jour:** 2026-05-15T11:15:11Z
- **Généré:** 2026-08-03T19:37:03+00:00

## exécutables

- tvnamer (alias)

## Comportement d'installation

- Bouteille: non disponible

## Version et fraîcheur

- page générée: 2026-08-03
- version du gestionnaire: 3.0.4
## Historique du projet et usages

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.

### Historique du projet

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.

### Historique d'adoption

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.

### Modes d'utilisation

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.

### Pourquoi les passionnés de paquets s'y intéressent

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.

### Chronologie

- 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.


## Notes de sécurité

Aucun manifest local de gestion des secrets correspondant n'a été trouvé pour tvnamer. Les métadonnées de paquet Nucleus restent publiées ici afin que la couverture future dispose d'une URL stable.



## 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
## Autres enregistrements de gestionnaires de paquets

- 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)


## Sources

- 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
