Skip to content

📺 Rename and unmangle TV episode filenames

License

Notifications You must be signed in to change notification settings

fastily/tv-rename

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tv-rename

Python 3.13+ License: GPL v3

Collection of tools for renaming and unmangling TV episode filenames. Compares episodes against the TheTVDB to get proper ordering.

Usage

tv_rename

usage: __main__.py [-h] [-l] [-s] [-x ext] [-d] [-n season_number] [dirs ...]

renames TV episodes or Season directories

positional arguments:
  dirs              the directories to work on

options:
  -h, --help        show this help message and exit
  -l                Use lexigraphical sort instead of natural sort
  -s                Dry run, don't actually rename any files/dirs
  -x ext            The file extensions to target. Defaults to .mkv, .avi, .mp4
  -d                Treat the input dir as a dir containg of season dirs to rename
  -n season_number  The season number to rename episode files to. Ignored if -d is passed.

tv_rename.multipart

usage: multipart.py [-h] [-l] [-s] [-x ext] [--absolute] [--streaming] series_id [root_dir]

Program that renames multipart tv episodes into their aired ordering

positional arguments:
  series_id    The series id of the show in question on thetvdb
  root_dir     the series directory to work on. Defaults to the current working directory

options:
  -h, --help   show this help message and exit
  -l           Use lexigraphical sort instead of natural sort
  -s           Dry run, don't actually rename any files/dirs
  -x ext       The file extensions to target. Defaults to .avi, .mp4, .mkv
  --absolute   Treat input as absolute ordering
  --streaming  Treat input dirs as streaming ordering

tv_rename.unmangle

usage: unmangle.py [-h] [-l] [-s] [-x ext] [--absolute] [--streaming] [-i] series_id [root_dir]

Program that renames tv episode orderings from dvd/absolute/streaming order to aired order

positional arguments:
  series_id    The series id of the show in question on thetvdb
  root_dir     the series directory to work on. Defaults to the current working directory

options:
  -h, --help   show this help message and exit
  -l           Use lexigraphical sort instead of natural sort
  -s           Dry run, don't actually rename any files/dirs
  -x ext       The file extensions to target. Defaults to .mp4, .mkv, .avi
  --absolute   Treat input as absolute ordering
  --streaming  Treat input dirs as streaming ordering
  -i           Ignore errors mistmatch between episode count on thetvdb and the local filesystem

About

📺 Rename and unmangle TV episode filenames

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages