tvrenamr 3.2.1

TV Renamr is a utility to rename TV shows based upon filenames or user input.<br /><br />Installation<br />Python Package Index<br /><br />Make sure you have the python setuptools package installed for your version of python (check with python --version).<br /><br />To install from the Python Package Index: easy_install tvrenamr - You may need to be an administrator to run this.<br />Source: GitHub<br /><br />git clone git://github.com/ghickman/tvrenamr.git<br /><br />cd tvrenamr<br /><br />python setup.py install - You may need to be an administrator to run this.<br />How To Use<br /><br />Run in your terminal of choice: tvr [options] file/folder<br />Config File<br /><br />For ease of use Tv Renamr uses a config file. By default it looks for it in ~/.tvrenamr/config.yml, an example one is available here which shows all the possible default values you can use.<br /><br />The defaults segment should be self-explanatory but I'll list them just for completeness. The listed values are the assumed defaults if any of the options are not added.<br /><br />format: '%n - %s%e - %t%x' The output format you want your files to be renamed to.<br /><br />library: thetvdb The online database to use for your episode names. Options are: thetvdb or tvrage<br /><br />organise: yes Organise your files within the renamed directory.<br /><br />renamed: /Volumes/Media/TV/ The target directory to move your renamed files to.<br /><br />the: true If a show has a leading 'The', such as 'The Big Bang Theory', move it to the end of the show name: 'Big Bang Theory, The'.<br /><br />Below the defaults are shows that won't get renamed correctly using the default options. Taking CSI as the example you have:<br /><br />csi:<br /> canonical: "CSI: Crime Scene Investigation"<br /> output: "CSI, Crime Scene Investigation"<br /><br />csi is the torrent name and needs to match whatever name your file is being downloaded with, which for CSI would be csi.s10e01.blah.blah.avi.<br /><br />canonical is name that the online database holds for the show.<br /><br />output is what you want the show to be renamed to.<br /><br />This method is the easiest way to deal with shows with a year in the name too, i.e. Castle (2009).<br /><br />Note: The quotes around the canonical and output names for CSI are needed because of the colon and comma characters as they are reserved by YAML.<br />Command Line Options<br /><br />If you need more control or if theres a pesky file you need to test, then the command line options give you the most power.<br /><br />-c or --canonical - Set the show's canonical name to use when performing the online lookup. --deluge - Checks Deluge to make sure the file has been completed before renaming. --deluge-ratio - Checks Deluge for completed and that the file has at least reached X share ratio. -d or --dry-run - Dry run your renaming. -e or --episode - Set the episode number. Currently this will cause errors when working with more than one file. -l or --log_file - Set the log file location. --log_level - Set the log level. Options: debug, info, warning, error and critical. --library - Set the library to use for retrieving episode titles. Options: thetvdb & tvrage. -n or --name - Set the show's name. This will be used as the show's when the renaming is completed. -o or --output - Set the output format for the episodes being renamed. --organise - Organise renamed files into folders based on their show name and season number. --no-organise - Explicitly tell Tv Renamr not to organise renamed files. Used to override the config. -q or --quiet - Don't output logs to the command line. -r or --recursive - Recursively lookup files in a given directory. --rename-dir - The directory to move renamed files to, if not specified the working directory is used. --no-rename-dir - Explicitly tell Tv Renamr not to move renamed files. Used to override the config. --regex - The regular expression to use when extracting information from files. -s or --season - Set the season number. -t or --the - Set the position of 'The' in a show's name to the end of the file.<br />Examples<br /><br /> * tvr<br /> * tvr /path/to/a/directory/<br /> * tvr /path/to/a/file.avi<br /> * tvr --organise -r '/path/to/a/directory/' /path/to/a/directory/[a_file.avi]<br /> * tvr --season '1' --name 'chuck' /path/to/a/file/the_file.avi<br /><br />Custom Regular Expressions<br /><br />By default TV Renamr will match shows in the formats: show.s0e00 and show.0x00 but you can specify custom regular expressions if your files aren't in either of these formats. Some custom regular expression syntax has been used to help you specify different parts of the filename:<br /><br /> * Show: %n - (?P<show />[ws.,_-]+)<br /> * Season: %s - (?P<season />[d]{1,2})<br /> * Episode: %e - (?P<episode />[d]{2})<br /><br />It is also possible to specify how many digits there are in the season and episode sections of the filename using the syntax:<br /><br /> * Season: %s{n}<br /> * Episode: %e{n}<br /><br />where the n in {n} specifies how many digits are in each of the sections.<br /><br />Note: All spaces are converted to periods before your regular expression is run.<br /><br />Python regular expression syntax can be found here<br />Custom Output Format<br /><br />It is possible to set a custom output format for your files using the following syntax:<br /><br /> * %n - Show<br /> * %s - Season<br /> * %e - Episode<br /> * %t - Title<br /> * %x - Extension<br /><br />you can specify the format you like, i.e. %n - %s%e - $t%x would mirror the default format.<br /><br />Note: Not including the %x section on Windows systems can cause problems when trying to run your media files.<br /><br />On the command line use the -o switch or set the format option in the defaults section of your config file.<br />Caveats | Known Issues<br /><br />All colons ':' are converted to commas ',' in both the show name and the episode title. This stops issues that can arise with network shares and gives a cleaner format on windows where python replaces the colon character with a backslash ''.<br /><br />Shows with a year in the canonical title, like Doctor Who (2005), will fail without specifying the show name which includes the year in brackets. You'll need to put this as the canonical name in the config file.<br /><br />Multiple episode files are just not coped with at all. The first episode is usually picked up so the file will be renamed using this.<br /><br />#md5=9dcc0dabf160625912d29061eca814bd

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Canonical,  Config,  Default,  Defaults,  Directory,  Episode,  Expression,  Files,  Format,  Options,  Output,  Python,  Regular,  Renamed,  Renamr,  Season,  Show,  Shows,  Syntax
Users rating:	0/10