tvnamer

A utility to rename files from some.show.s01e03.blah.abc.avi to Some Show - [01x03] - The Episode Name.avi, using data from TheTVDB.

Runs as tvnamer|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 7 fields

Rename TV episode files using data from TheTVDB. Config-file saving and naming-pattern flags are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui tvnamer

Rename TV episodesExample values, fixed in this page — nothing here reaches a terminal

Basic

Files or directories*

any

Recurse into directories

--recursive

TheTVDB series ID

integer

Advanced

Config file

file

TasksEach one presets the form for one job

Rename interactively

pathsrecursiveseries_idconfig

Rename without prompts

pathsrecursiveseries_idconfig

ParametersOnly these flags are editable in the form

Files or directories

path · positional 0 · repeatable

Recurse into directories

boolean

--recursive-r

Select first search result

boolean

--selectfirst

Always rename

boolean

--always

Batch (no prompts)

Selects the first result and renames everything. Use carefully.
boolean

--batch

TheTVDB series ID

integer

--series-id

Config file

path

--config

SourcesEvery flag above is checked against these

readme

tvnamer will only descend one level into directories unless the `-r` (or `--recursive`) flag is specified. tvnamer --recursive dir1/ The most useful are most likely `--batch`, `--selectfirst` and `--always`: `--selectfirst` will select the first series the search found, but will not automatically rename any episodes. `--always` will ask you select the co…

manual2026-10-27

github.com

Before it fills your prompt, Otty checks the installed tvnamer against its version. A form that does not match your version is not offered.