TV Rename Logo TV Rename

Organise your TV Shows with ease

The Options Menu

The Options Menu One of TV Rename’s strongest (and most confusing) features is its configurability. For the newcomer especially, it’s very easy to get “lost” in the plethora of options and preferences, and give up.

Luckily the “out-of-the-box” defaults work very well, and, should you wish to change any of the options or preferences at some point all the stuff you can “fiddle with” is described here.

If you’re in a hurry use the links on the left (or below) to jump to a specific item.

Offline Operation ◆ Automatic Background Download ◆ Preferences

Ignore List ◆ Filename Template Editor ◆ Search Engines ◆ Filename Processors

Offline Operation

If Offline Operation is enabled TV Rename will firstly prompt you to make sure you wish to go offline, and if you click Yes it will run on locally cached data from The TVDB. This will stop TV Rename attempting to update.

Automatic Background Download

If Automatic Background Download is enabled any action that reads data from the cache will also trigger an update fromThe TVDB, additionally updates will be performed at regular intervals.


The Preferences Tabs The tabs in “Preferences”, are each discussed below.

Use the links (below) to jump to a specific item…

Media Center ◆ Search Folders ◆ µTorrent / NZB ◆ Tree Coloring

General ◆ Files and Folders ◆ Automatic Export ◆ Scan Options ◆ Folder Deleting

The Media Center Tab

Preferences - the Media Centre tab Here you can tell TV Rename about your media player (and hence, any additional files you may need to download).

The tick box options in each group should already be familiar to you if you use that particular media player.

The Presets button (bottom right) allows you to quickly apply all the relevant presets for the chosen media player.

Note: The functionality of this tab is currently under review due to the growth in the media player market - so expect some changes in Version 3!

The Search Folders Tab

Preferences - the Search Folders tab The Search Folders tab is used to tell TV Rename where to look for TV show episode files BEFORE they are processed. Logical entries in here would be your downloads folder (if you download TV show episodes from the internet) or maybe your desktop (if you rip TV show episodes from DVD or Blu-ray). Or both!

Three buttons are available at the bottom of the tab. Add opens an explorer style window so you can browse to the folder location you wish to add and click OK, Remove removes a highlighted row from the panel and Open opens an explorer window targeting the row highlighted in the panel.

At the top of the tab the “Monitor folders for changes” tick box tell TV Rename to automatically check for new files in the identified locations and the “Scan Type” radio buttons tell TV Rename the type of scan to perform if anything is found.

Defaults: “Folder Monitor” Un-ticked
  “Scan type” Full

The µTorrent / NZB Tab

Preferences - the µTorrent / NZB tab Some of the contents of this tab are use by the Scan Options tab.

“The Torrent RSS URLs:” can be any suitable RSS-feeds provided by indexers or public RSS websites and are used to search for missing files.

Add and Remove allow you to add and remove feeds, and Open presents the highlighted feed in a web browser.

TV Rename can check both µTorrent and SABnzbd queues and uses some of the information provided on this tab to know where to look.

Both the “Host Port” and “API Key” are required to use this functionality in SABnzbd.

TV Rename also needs to know the µTorrent “Application” and “resume.dat” paths, (they can be found with the Browse buttons) so it can detect if files are queued, in the process of being downloaded or are complete.

The Tree Coloring Tab

Preferences - the Tree Coloring tab If you have a large catalogue of old tv shows, the My Shows tab can be somewhat cluttered, but you don’t want to remove anything from TV Rename. Tree Coloring to the rescue…

Tree coloring allows you to change the color of the text on the left hand pane of the My Shows tab depending on the status of the show or the show season.

To create a record:-

For example: to make finished shows less obtrusive in My Shows expand the “Status:” drop-down and select “Show Status: Ended”, in the “Text Color:” box type “#808080” and click Add. Back in the My Shows text for shows that have finished will be light grey and less obtrusive.

If you wish to remove a rule from the list just select it and click Remove.

The General Tab

Preferences - the General tab The number in When to watch “X” days count as recent specifies how many recent days are listed for the for “Aired in the last N days” section of the When to Watch tab.

Default: 7 days

The Double-click in When to Watch does: radio buttons control the double-click action in the When to Watch tab. Options are Search and Scan.

Default: Search

The Startup Tab: setting selects which tab you wish open when TV Rename loads. My Shows, Search or When to Watch.

Default: My Shows

“Show Notification Area” and “Show in Taskbar” interact, one of them must be ticked. If you try to un-tick both the option you are changing clears, but the other one automatically sets.

If “Show in Taskbar” is selected TV Rename’s icon appears in the Windows taskbar.
If “Show Notification Area” is selected TV Rename’s icon appears in the System Tray. Right-clicking it will show an “Upcoming Shows” list, and double clicking restores the main window.
Both boxes can be ticked, in which case you get both functionalities.

Defaults: “Show Notification Area” Un-ticked
  “Show in Taskbar” Ticked

Show episode pictures in episode guides does what-it-says-on-the-tin, if ticked screen grabs from show episodes are displayed with the episode description in the My Shows tab. If un-ticked only the episode description is displayed.

Default: Ticked

Download up to “X” shows simultaneously from The TVDB sets the number of concurrent connections to TheTVDB API. It can be set in the range to 1 to 8.

Default: 4

Refresh entire series if “X” % of episodes are updated sets the point at which TV Rename “decides” to do a full refresh of a show when updating data. This functionality is useful if for example you have a set of show recordings which you are replacing with DVD rips and the data structure is different.

Default: 20

Automatically select show and season in My Shows if ticked, works for both the When to watch and Scan tabs. If an item is selected in either of these tabs the My Shows tab is automatically updated to highlight the indicated show and season.

Default: Ticked

Look for air date in filenames if ticked, provides a second method of identifying show episodes by looking for a date (in a number of formats) in the shows filename and comparing that against the air-date.

The supported date formats are: “yyyy-MM-dd”, “dd-MM-yyyy”, “MM-dd-yyyy”, “yy-MM-dd”, “dd-MM-yy” and “MM-dd-yy”

And the “date separators” can be any of: - / . , “ “ (a space)

Default: Un-ticked

Preferred language: sets the language for returned data when requesting information from TheTVDB API. TV Rename will request “English” If the selected language is not available.

The Mode: drop-down, (new in Version 2.3.2) allows you to preview functionality that is being worked on but not yet ready for the mainstream releases. The options available are “Production” and “Beta”.

In Production mode the application looks and behaves as normal.

In Beta mode a new menu called Beta appears between Tools and Help which gives you access to preview upcoming additions and enhancements.

Default: Production

The Files and Folders Tab

Preferences - The Files and Folders tab The “Filename Replacements” grid controls the replacement of illegal characters in filenames.

If the filename contains a character that isn’t supported in a windows filename the grid is checked row by row to discover what to use instead of the problem character.

“Video Extensions:” tells TV Rename the extensions to match when looking for video files. The entries should be semicolon delimited, not contain spaces and include the “.” preceding the extension.

“Other Extensions:” follows the same rules as “Video Extensions” but the file extensions specified are typically for video related files rather than video. The extensions listed by default are :-

.srt Subtitles in text format.
.nfo An XML style file that contains information about the video, such as a title, summary, list of actors, year of production etc. This information is often used by media players to provide a more immersive viewing experience.
.txt Text files can be any text but quite often, if the base name of the text file is the same as that of the video file, they contain subtitles in text format.
.tbn A KODI/XBMC specific jpeg.

It is common for files to have the same base name for example: BigBuckBunny.avi, BigBuckBunny.sub and BigBuckBunny.nfo. This helps keep them organised.

TV Rename knows this, hence the “Copy/Move file with same base name as video” tick-box. Which gives you the ability to turn this functionality on or off.

Default: Ticked

The “Do” drop-down and text box underneath provide a degree of granularity to this function.

Subtitle files come in a number of guises of which one of the most common is a .sub file. These are text files structured in a way that media players can establish the start time, finish time and content of a subtitle and display it. Quite often sources for these files give them a .txt extension, for example: BigBuckBunny.txt. Ticking the “Rename .txt to .sub” option will tell TV Rename to rename these files when copied or moved.

Default: Un-ticked

The next four items affect how TV Rename creates folders in your Media Library and recognises seasons when searching.

The “Leading 0 on Season Numbers” tick-box simply tells TV Rename to use “Season 01” instead of “Season 1” etc. when creating new folders.

Default: Un-ticked

The next three preferences will be of special interest to those of you who speak “English as a second language”. You can now set the folder names used for “Seasons” and “Specials”, and the text recognised as “Season” when searching.

The “Specials folder name:” text box allows you to modify the name used when creating a “Specials” folder for a show.

It is common practice for specials to be labeled as part of “Season 0” so for example: special 3 of “Battlestar Galactica” would be labeled “Battlestar Galactica - S00E03 - The Story So Far” and stored (by default) in the “Specials” folder.

Default: Specials

Similarly, the “Season folder name:” text box allows you to customise the name used when creating a “Season” in tour Media Library.

Default Season

The “Season search terms:” text box provides TV Rename with a list of semicolon separated words that TV Rename will recognise as part of a season identifier when searching.

Default Season;Series;Saison;Temporada;Seizoen

The rest of the options in this pane are straightforward and need no explanation.

The Automatic Export Tab

Preferences - the Automatic Export tab Ticking the “RSS” box in the “When to watch” section of the panel will save a RSS-reader compatible XML file to the location you specify (by typing or browsing). This file can then be read by something like XBOX Media Center, or a Windows RSS App.

Ticking the “XML” box in the “When to watch” section of the panel will save a standard XML file to the location you specify (by typing or browsing).

In either case you can limit how many days or shows are written to the file. The files are updated whenever the “When to watch” tab is manually or automatically refreshed.

Ticking the “XML” box in the “Missing” section of the panel will save a standard XML file containing the missing episodes detected during a scan to the location you specify (by typing or browsing)

Ticking the “TXT” box in the “All Shows” section of the panel will save a TXT file whenever a show is added, edited or deleted from TV Rename. It also gets updated when Auto ID All in the Scan Results tab of Tools>Folder Monitor is clicked.

Default: All un-ticked

The Scan Options Tab

Preferences - the Scan Options tab This tab in conjunction with data from the µTorrent / NZB tab controls the Scan tabs checks and actions.

The settings in here are more or less self explanatory, however remember that the µTorrent / NZB tab must be populated before the µTorrent, SABnzdb and RSS options can be used.

Scan checks Rename Check Ticked
and actions Missing Check Ticked
  Look in “Search Folders” for missing files Ticked
  Copy files, don’t move Un-ticked
  Check µTorrent queue Un-ticked
  Check SABnzdb queue Un-ticked
  Search RSS for missing files Un-ticked
Folder Creation Automatically create missing folders Un-ticked

The Folder Deleting Tab

Preferences - the Folder Delete tab This tab is all about TV Rename tidying up after itself.

When downloading video from the internet its quite common to get .nfo files, screen grabs, sample video, text-art files and the like bundled with the download.

TV Rename automatically takes care of the video file and any others you media play may require, renaming them and copying or moving them to your Media Library.

The settings in this tab take care of the rest.

The flow through this tab is pretty self explanatory, start by ticking the “Delete empty folders…” box to enable the action. The other settings are fairly obvious, tick the boxes and modify the text as required.

If you use the copy option to update your library then ticking the “Clean up already copied…” box will delete the source files after the copy is complete.

*Default: All functionality disabled_

Ignore List

The Edit Ignore List window When a Scan is run any “missing” episodes for shows in your Media Library are listed.

These may be genuine missing episodes or they may be “Specials”, that don’t fit the season/episode pattern but are still part of the show, for example: -

My Favourite Show - S00E03 - Recap of Last Season

This may be something you want or it may just be adding to the “noise” in the Scan tab.

If it is “noise” you can highlight the row (or multiple rows if that fits better) and right click. A cut-down menu appears, if you select “Ignore Selected” the item is removed from the Scan results and appears in the “Ignore List”.

If, at a later date, you decide you wish to add the item, you can remove it from the Ignore list using the Edit Ignore List window, selecting the item in question and clicking Remove.

Filename Template Editor

The Filename Template Editor tab This is where the format of the filenames that TV Rename will rename to are defined.

To help illustrate the results the “Sample and Test:” panel contains the processed entries from the show and season selected in the My Shows tab.

The “Naming template:” text box displays a tokenised version of the filename which can be edited directly or populated using the “Tags:” drop-down, or overwritten with a record selected from the “Presets:” drop-down. Any changes in the “Naming Template:” are automatically reflected in the “Sample and Test:” panel.

The available tags with their definitions are listed below: -

{ShowName} Name of the Show
{Season} Number of the season
{Season:2} Number of the season forced to 2 characters with a leading zero
{Episode} Number of the episode (within a season), eg S01E03
{Episode2} Number of the second episode of a pair (within a season), eg S01E04-E05
  created by the default S{Season:2}E{Episode}[-E{Episode2}])
{EpisodeName} Name of the Episode
{Number} Overall number of the episode
{Number:2} Overall number of the episode forced to 2 characters with a leading zero
{Number:3} Overall number of the episode forced to 3 characters with leading zero(s)
{ShortDate} Air date in short format, eg 25/12/2017
{LongDate} Air date in lomg format, eg 25 December 2017
{YMDDate} Air date in YMD format, eg 2017/12/25
{AllEpisodes} All episodes - E01E02 etc
Default: {ShowName} - S{Season:2}E{Episode}[-E{Episode2}] - {EpisodeName}
  (the second preset).

Search Engines

The Modify Search Engines window The Modify Search Engines window controls TV Rename’s outgoing interface with the world (other than TheTVDB). Here, you can configure how and where TV Rename points a web browser searching for files.

Using the Add and Delete buttons you can create or remove records at will, and the Tags... pop up a list of supported tags to remind you whats available. (The tags supported are the same as those listed in the Filename Template Editor.)

As an example, here is a URL entry for Google.{ShowName}+S{Season:2}E{Episode}

The list of URL’s can be used when the When to watch tab is open, the last used entry becomes the default, and appears in a text box to the right of the Refresh button. It can be changed by clicking the button and selecting another entry.

With a little ingenuity you can get really creative with these entries and pass your search to its specific target through a web proxy.

Filename Processors

he Filename Processors window
In much the same way that the Filename Template Editor is used to process the names of files being moved to the Media Library so Filename Processors is used to inform Rename what filenames to look out for when searching for a missing files

To really understand the contents of the Regex column above, you need a working knowledge of Regular Expressions.

Once you have figured out whats going on you can see that all the regular expressions capture the season and episode number of a show from the filename. Each one can work on just the filename: -

ShowName S01E07.avi

or on the whole path: -


Each expression can be toggled on and off, as can the ability to process a full path.

Each expression has a Notes field which can be used to remind the user why the expression was added.

Additionally, a folder can be specified to test the results of the Regular Expression.

In all likelihood you will find it unnecessary to make changes here, only if a new, totally unrecognisable file name structure appeared would it be necessary, and then there would probably be discussion about it in the forum.