# tvnamer を Homebrew, Nix, apt でインストール

tvnamer のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

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

追加のインストールコマンド:

### macOS

- Homebrew (100%):

```sh
brew install tvnamer
```

  証拠: local Homebrew formula metadata

### Linux

- Nix (92%):

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

  証拠: 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
```

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

## パッケージ情報

- **パッケージキー:** brew:tvnamer
- **パッケージマネージャ:** Homebrew
- **バージョン:** 3.0.4
- **ソース概要:** Automatic TV episode file renamer that uses data from thetvdb.com
- **ホームページ:** <https://github.com/dbr/tvnamer>
- **リポジトリ:** <https://github.com/dbr/tvnamer>
- **最終更新:** 2026-05-15T11:15:11Z
- **生成日時:** 2026-08-03T19:37:03+00:00

## 実行可能ファイル

- tvnamer (エイリアス)

## インストール挙動

- Bottle: 利用不可

## バージョンと鮮度

- ページ生成日: 2026-08-03
- マネージャ版: 3.0.4
## プロジェクトの歴史と使われ方

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.

### プロジェクトの歴史

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.

### 採用の歴史

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.

### 使われ方

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.

### パッケージ好きにとっての重要性

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.

### タイムライン

- 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

### ソース

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


## セキュリティノート

tvnamer に一致するローカルシークレット処理マニフェストは見つかりませんでした。将来の対応で安定したパッケージ URL を使えるよう、Nucleus パッケージメタデータはここに公開されています。



## 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
## 他のパッケージマネージャ記録

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


## ソース

- 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