Page 1 of 1

Rename My TV Series 2

Rename My TV Series 2

Rename My TV Series, a tool to rename tv series episodes, has been around for a while now, and it’s time for an update (the “old one” can still be found here). So I proudly present: Rename My TV Series 2.

Two of the main reasons for this new version are the needed update of the user interface and support for the new API of But there is more; macOS users wanted a 64 bit version to avoid the 32 bit complaining and having the application signed was on the wishlist for them as well. Support for SSL (since API requires this), the use of notifications and the support for a dark theme, the merging of 2 episodes, caching results, are a few of other desired or needed items.

I’m still striving to do as much cross-platform development as possible, so macOS, Windows and Linux users can use my tools, which means that this new version will be available for all these 3 platforms.

Purpose of Rename My TV Series

Originally the application was built as a purpose to learn more about Lazarus Pascal and cross-platform development.

In the meanwhile, my tool is being used be a lot of users to help them rename TV-Series files.
Just keep in mind that this tool is not to promote illegal downloading or illegal sharing of copyrighted materials. It’s just a handy tool to occasionally rename some of your TV show files.

The philosophy is a simple work flow; you have a few odd named TV Show episodes and you’d like to give them a proper name, based on the TV Show name, season, episode and title of the episode. This has been expanded with features like resolution, year, data first aired, etc.

This tool by no means pretends to be anything else than just that.

Some features:

  • Support the new API (v2)
  • Caching shows and banners (so reloading at the later time could go faster)
  • Dark Theme support (MacOS and Linux only, accent color observed)
  • Automatically move files into a desired directory structure
  • Define your own file and directory name format
  • Create NFO files for the TV Show and for the individual Episodes
  • Store a banner for the TV Show
  • Merge 2 Episodes into 1 (filename only of course)
  • Detection of resolution, video format, Audio and Video codec, and audio channels
  • Log file of what files have been renamed

Getting Started – Downloading Rename My TV Series

At the time of writing this article, the following Intel based systems are supported:

  • Most Windows versions that can run Windows 32 bit applications.
  • Most MacOS versions that can run 64 bit applications.
  • Most Linux versions that can run 64 bit applications.

Step 1 is obviously downloading the latest version. Pick from the list below, the version suitable for your Operating System:

DOWNLOAD - RenameMyTVSeries-2.0.1-macOS-64bit 

Platform: Mac OS X
Filename: RenameMyTVSeries-2.0.1-macOS-64bit.dmg
Version: 2.0.1
Size: 22.7 MiB
Date: November 13, 2018
 Download Now 

DOWNLOAD - RenameMyTVSeries-2.0.1-Windows-32bit-setup 

Platform: Windows
Filename: RenameMyTVSeries-2.0.1-Windows-32bit-setup.exe
Version: 2.0.1
Size: 15.3 MiB
Date: November 13, 2018
 Download Now 

DOWNLOAD - RenameMyTVSeries2.0.1-Linux64bit Tar 

Platform: Linux
Filename: RenameMyTVSeries2.0.1-Linux64bit.tar.gz
Version: 2.0.1
Size: 23.1 MiB
Date: November 13, 2018
 Download Now 


v2.0.1 – Minor bug fixes and some cosmetic improvements mostly for macOS dark theme.


Note: Signing issue for macOS has been resolved.

 MacOS users simply drag RenameMyTVSeries from the DMG into their “Applications” folder.

 Linux users create a directory and drop the renamemytvseries and ffprobe binaries in it. You can optionally use one of the icons.

 Windows users run the setup file to get the installation started.

Finding your way in the GUI

Most likely nobody reads this section, and I hope that is the case, as it would mean that I did a good job on designing the application. I’ll start with some screenshot, since I like to see those right away with applications build by others.

  Tip: Quite a few options can also be found in the regular menu op the application. Even though rarely used, I’ve still implemented it. For Windows users the menu becomes visible by pressing the “Alt” key. MacOS users will find it in the top menu bar, and Linux users will see the menu in the top part of the application.

Rename My Tv Series - MacOS (Mojave)

Rename My Tv Series – MacOS (Mojave)

Rename My Tv Series - MacOS (Mojave Dark Theme)

Rename My Tv Series – MacOS (Mojave Dark Theme)

Rename My Tv Series - Linux (Mint)

Rename My Tv Series – Linux (Mint)

Rename My Tv Series - Linux (Mint Dark Theme)

Rename My Tv Series – Linux (Mint Dark Theme)

Rename My Tv Series - Windows (10)

Rename My Tv Series – Windows (10)

For those familiar with the “old” version; the interface has become mature and modern – probably still room for improvements of course, but I have to work with the tools that I have. On that note: tons of thanks to the people at the Lazarus Forum and especially Dmitry who did a lot of Cocoa development.

The initial workflow is easy: On the left we select a TV show, retrieve the episode, add the files and add the matching TV shows, and hit the “Rename” button.

Things have been growing a little out of proportion, I hope to though on some of these new features as we go through the user interface.

Rename My TV Series – Finding your TV Show and Episodes

Note: This application is completely English and that will probably not change anytime soon. This is just a hobby for me, and society expects me to have a job. The people from the lottery haven’t let me win either, so I’m stuck with how much time I can put into projects like this.

Section – TV Shows

In the upper left corner you’ll find a field where we can enter a search text. This can be part of the name or the full name of a TV show. With an initial search I’d avoid adding the year to the show. So when looking for “Stargate SG-1”, just type that. Avoid adding the year in this format “(1997)”. Not all shows are stored on TheTVDB in that fashion and it may prevent the show from appearing.

Below a small video showing you how I look for the TV show “Stargate SG-1” from 1997. Yeah, I know, I keep falling back to Stargate SG-1 – can’t help being a fan 


As you can see, just type the show, click on “Search” and a list of matching shows will appear. If the list remains empty, well, then you’d better try a different search string.

Better Results when Searching 

Sometimes the desired show does not appear right away. Here a few trips that may help you get the show you’re looking for;

  1. Make sure you’re spelling the name correctly,
  2. Keep it short and simple, leave out things like the year and words at the beginning like “the”,
  3. If you still get no results, try looking for the English name (switch the language button to “English”),
  4. If you know the TVDB-ID, you can enter this directly, in this format: TVDB:12345 for example “TVDB:72449” (without quotes)

You’ll notice a few things in the screen and maybe when you’re giving it a try yourself;

  • When a section is “working”, the grey header will change color (for example “TV Shows“, “TV Show Details” and “Episodes” in the little video), just so you know it’s busy.
  • By default, when only one result returns (try: “Stargate SG-1”), Episodes will automatically be retrieved (you can change this in preferences).
  • When there are multiple results, you’ll have to select the desired show. The “TV Show Details” will then show some of the details of the selected show.
  • You can select a language, in the example set to English, but keep in mind that not all shows are available or correctly or complete translated!
  • When clicking “Get Episodes” the list “Episodes” will be populated with data retrieved from TheTVDB or your local database.

One thing we haven’t talked about is the little arrow button next to the search field: The History menu.
This button pulls up a list of TV Shows you’ve retrieved Episodes from at an earlier time. Shows will only be added if you actually retrieve episodes, to avoid that it gets filled with shows you weren’t looking for. This will look something like this:

Rename My TV Series - History Menu

Rename My TV Series – History Menu

Selecting a show from the history menu will pull right away just that show and it’s episodes.

This brings us to the use of the database. Once a show has been retrieved with episodes, it will all be cached in a database, so the next time you want to retrieve this show it will pull it from the database which is much faster. Obviously, since TheTVDB community is very active, results will be updated. This is why there is an option in the preferences that allows you to dictate how quick data expires and needs to be refresh. By default this is 7 days, since most shows have one episode per week anyway.

Section – TV Show Details

In the section “TV Show Details” you’ll find some basic info like the title, story line, date the show started, by what network, and a banner. You’ll also find two small links:

  • Copy TVDB ID” – This copies the TVDB string onto the clipboard in the format “TVDB:12345“, which can be used in other applications,
  • Open TVDB Page” – This will open the matching page of the TV Show on

Section – Episodes

In this section you will see the episodes of the selected show listed. As described earlier, you will have to click the “Get Episodes” button to retrieve the episodes. Exceptions are when the search only returned one result, or you selected an item from the History menu, episodes appear automatically.

You’ve probably already noticed it; you can set the desired sort and numbering order. “Episodes” can be sorted by “Air Date” or “DVD” order, and you can have episodes numbered per season or continuous. Continuous numbering starts with Season 1, Season “0” (or: ‘Specials”) will not be included in continuous numbering. Continuous numbering means that when Season 1 ends with episode 24, then Season 2 starts with episode 25, etc.

Right clicking an episode will bring up a menu, with items depending on your selection;

Menu Options
Menu Item Purpose Selection
Add Selected Episode(s) Add the selection to the rename list 1 or more rows
Show Episode Details Show a popup with episode details 1 row only
Select This Season Select an entire season 0 or more rows
Select All Normal Episodes Select all episode not in “Specials” 0 or more rows
Select All Episodes Select all episodes including “Specials” 0 or more rows
Select Inverse Flip the selection 1 or more rows
Deselect All Clear the selection 1 or more rows

Double clicking an single episode (with left mouse button) will add the episode to the rename list on the right (under the header “Selected Episodes“).

When selecting “Show Episode Details“, a details window will popup, which will disappear when clicking elsewhere in the application window.

Rename My TV Series - Episode Details

Rename My TV Series – Episode Details

Renaming Your Files

On the right half of the application window, you’ll see two (initially empty) lists: “Selected Episodes” and “Selected Files”.
Each row will link a selected episode to a selected file, which can be shuffled manually or sorted before actually renaming anything.

At the bottom you’ll see a small text indicating how many episodes and files are in the list, and if you’re missing some episodes or files.
As long as these 2 lists are not aligned, the “Rename” button not work and will say “Cannot Rename” on the button – indicating the the lists are not in sync.

After clicking “Rename“, a summary will be shown how many files have been renamed and how many failed.
In Linux and MacOS the proper notifications will be shown, under Windows I had to mimic notifications as this is not supported for standard “exe” files (win32/desktop applications). None of the notifications require interaction, as they disappear automatically.

Section – Selected Episodes

In this section you will find the episodes you’ve added from the “Episodes” section on the left.
Adding episodes can be done by double clicking and episode, or by selecting one or more episodes and clicking the “Add” button under the “Selected Episodes” header.
Alternatively, you can right click episodes and select “Add Selected Episode(s)” from the popup menu.

  Tip for Windows users: Before right clicking a selection of multiple episodes, you may need to keep the Shift button pressed to not loose the selection.

After adding episodes, you can Sort or Remove them, drag them up and down, or Clear the entire list.

  Tip for those that would like to mix shows: Depending on your preferences settings you actually can mix several shows, by unchecking the “Clear lists when selecting a new TV Show” in the Preferences window. See “Preferences” for more details.

Section – Selected Files

I know it’s pretty obvious, but just for completeness: in this section you can add the files, or directories with files, you’d like to rename.
To add files you can use the buttons “Add File(s)“, or “Add Dir(s)“, or drag and drop you files or directories on the application window. MacOS users can also drag and drop on the dock icon of Rename My TV Series.

When adding a directory, all files in the directory and its sub-directories will be added.

After adding one or more files has completed, a brief summary will appear showing you how many files were found and added.
If FFprobe was enabled, but somehow failed to find media information, this will be reported as well.

Supported File Extensions for Video Files 

At this time only the following file extensions will be recognized as video files:

.3gp, .asf, .avi, .divx, .dvb, .flv, .m4v, .mjpeg, .mkv, .mov, .mp2, .mp4, .mpg, .ogg, .ogm, .ogv, .qt, .raw, .rmvb, .ts, .vid, .vob, .wma, .wmv, .xvid

As with episodes, added files can be Sorted, Removed, shuffled by manually dragging them around, and you can Clear the entire list.

  Sorting is done on best effort and may or may not work perfectly. We try to remove numbers in show-names and years, in hopes to get a useful sort based on numbers remaining. This has worked very well for me, but I can imagine that this is not perfect. Feel free to report sort issues in the comments below.

  When adding files, and with FFprobe enabled, files will be analyzed right away. This will slow down reading the files, even though FFprobe is amazingly fast.
If you do not use resolution, video format, audio codec, video codec, and audio channels, then consider disabling FFprobe in the Preferences window (uncheck “Enable FFprobe”) which will speed up import significantly.

Optional: Rename Similar Named Files

Do not worry about additional files like subtitles, info files etc.

If you have the option “Rename similar named files” checked in Preferences, ALL files that start with the same name will be renamed as well, no matter what extension they have. To illustrate this, say we have a video file called “somevideofile.avi”, any file in the same directory that starts with “somevideofile” will be renamed as wel, even if what follows in the name is more than just an extension. Say we’d rename it to “episode 1.avi” then the following files would be renamed correctly as well;

“somevideofile.sub” (to: “episode 1.sub”),
“” (to: “episode”),
“somevideofile.trailer.mp4” (to: “episode 1.trailer.mp4”),
“somevideofile-sample.mkv” (to: “episode 1-sample.mkv”),

Optional: Moving Renamed Files

Rename My TV Series offers the option to move renamed files to a new location. This could be the TV Shows folder on your NAS or any directory accessible for that matter (for Windows users, I’d recommend mapping network drives to a drive letter!). For this we’d need to define where to move the files and what the directory format should be.

Option 1 – Moving it to your “TV Shows” directory

Say you have a central location where you store your TV Shows, say a NAS share under Windows mapped as E:\TVShows.
If you set the directory “Move to folder” format (in Preferences) to “%N (%Y)/Season %SZ” and the “Base Path” to “E:\TVShows“, renamed files will be moved to “E:\TVShows\ShowName (year)\Season XY” automatically. More about the renaming format later, as this is the same format used to define the renaming format for files.

Option 2 – Make a directory structure in the directory where the file currently resides

Say you want a similar structure but just keep it in the directory where the file current resides, click the “X” button to make sure the “Base Path” is set to “(currentdir)“.
As an example, say the file(s) reside in “C:\Converted“, and the directory format is set to “%N (%Y)/Season %SZ“, renamed files will be moved to “C:\Converted\ShowName (year)\Season XY” automatically

Experiment with empty files 

Since we don’t like losing our video files, I’d recommend playing with a few empty files with names you made up.
I’ve written for that purpose an article that shows you how you can make empty dummy files.
Obviously FFprobe will not detect any media info, as there is none, but at least you can try and test without losing any important files.

Optional: Create a log file

Sometimes it’s good to see what happened, so there is an option to create a log file which will show what file has been renamed and/or moved to what filename/location. Failures will be reported in this log file as well. If you enabled this option, a dialog will ask you if and where you’d like to store the log after you have executed a rename.

This option can be enabled in the Preferences window by checking “Create log file of renamed files“.

Optional: Clear the lists after renaming files

After renaming files, their new names will be listed in “Selected Files“, and files that failed to be renamed will still be listed with their original name. I find this convenient since I can see right away what happened. The downside is that I have to click the “Clear Both Lists” button to clear the lists.

By checking the option “Clear lists after renaming completed” in Preferences, your lists will be completed right away.

File or Directory Format Definition

Obviously we all have our own taste and preferences when it comes to naming files or directory, and that’s why Rename My TV Series offers you a free formatting definition.

TV Show name and years … 

On TheTVDB, some shows do and some shows do not have a year in their title in the (YEAR) format – unfortunately a little inconsistency.

This could cause potential issues when using “%N (%Y)” in the filename or path string. With some shows it would produce “Doctor Who (1963)” and with other “Doctor Who (2005) (2005)” – so the user would not be able to define a filename string applicable for all shows.

To remedy this, Rename My TV Series strips the years from names, for those that have a year in the name.
This way all shows do not have a year when used in the format string, and a code like “%N (%Y)” would always work.

In essence this is a string with a few special codes in it, and those codes will be replaced with values relevant for selected TV Show and/or Episode. You can also see this list in the application, by clicking “Show Format Help” (upper right corner in the Preferences window) – it will show a window with an explanation and this window can remain open while editing “Filename Format” or “Move to folder” in the preferences window.

Rename My TV Series - Format Help window

Rename My TV Series – Format Help window

  Tip: When using %S (not %SZ or %Sx) or %E (not %EZ or %Ex), there will be no leading zero’s, unless you checked the option “Season and Episode numbers at least 2 chars wide” in Preferences. If this option is checked, a leading zero WILL be added anyway for numbers less than 10.


Clicking the “Settings” button on the main window, will open the Preferences window.
I’ll briefly explain each of the options here.

Back to Default Settings … 

All settings can be reset to default by clicking “Reset All to Default” – this will also erase “History” and reset “Special Characters” to its default values.


Rename My TV Series - Preferences Window

Rename My TV Series – Preferences window

Preferences – Generic Application Settings

Enable FF Probe (Default: disabled)

This option enables or disables scanning video files with FFprobe. Enabling this will slow down adding files, but it does allow you to use the codes/tags for Audio Codec, Audio Channels, Video Codec, Video Resolution and Video Format. If you do not use these codes/tags, then I’d recommend disabling this.
This option will be disabled if FFprobe cannot be found in the directory where Rename My TV Series is located.
FFprobe is included with the files you download here.

Allow Adding Multiple The Same Episodes (Default: disabled)

If the same episode is added to the “Selected Episodes” list, but the episode is already in this list, it will not be added by default to prevent renaming issues (files ending up with the same name). Rename My TV Series would catch this during the renaming process as well (and produce a failure) as well.

In some cases however one may want to have multiple episodes as they may be stored in different formats or resolutions. For example a 480p version for mobile use and a 1080p version for watching it at home on your TV.

Enabling this option (default disabled) allows you to override this. Be warned though; this may result in unexpected outcomes.

Enable Applications Hints (Default: enabled)

This option enables or disables the little hint windows popping up when hovering over certain user interface elements. Convenient when you just start using Rename My Tv Series, but maybe annoying when you’ve used it for a while.

Compact Database on Close (Default: enabled)

The data of your TV shows will be stored and cached in a SQLite database. By adding, removing, or updating data, the database may get defragmented and become slower. This is probably only noticeable with large amounts of data in the database, but SQLite has a cleaning (vacuum) option which will run each time the application is closed. This does slow down closing the application a tiny bit, so if it takes too long for your taste; you can disable it.

Save Window Size/Position when closing Application (Default: enabled)

Since we all have different monitors, different preferences on the position and size of the application window; this option will save the size and position of Rename My TV Series. Next time when you open Rename My TV Series it will open the same way you left it last time.

The button “Reset Windows” will reset size and position to the default position. This option also exists in the main menu.

Preferences – Finding TV Shows

Default language for searching TV Shows (Default: English)

Searching TV Shows is best done in the English language, but it can be desirable to select another language. Here you can set the default language (which can be overridden in the main window on an individual basis).

Note: TheTVDB has an impressive amount of data, but not all shows and/or episodes are translated. Some are not translated, some only partially. Selecting another language may result in finding less TV shows, incomplete translations, etc.

Automatically download Episode list when only one TV Show was found (Default: enabled)

When searching for TV Shows, you may get zero or more results. When this option is enabled, Rename My TV Series will automatically click the “Get Episodes” button for you when only one result was found. Assuming this was the TV Show you were looking for anyway.

Default: Sort by DVD Sort Order (Default: disabled)

By default, Episodes are listed by date Aired. By checking this option, the DVD sort order will be used instead.

Default: Continuous Episode numbering (Default: disabled)

Normally, episodes are numbered in such a way that each season start with episode 1.
Enabling this option will start numbering with Season 1, episode 1, and keep numbering the following season in sequence.
This means, if Season 1 ends with Episode 24, then Season 2 will start with Episode 25.

Episodes in Season 0 (zero) a.k.a. “Specials” will not be included in this numbering, they will just start with one and the episode counting resets to “1” with the beginning of season 1.

Always sort all files after adding files (Default: enabled)

When adding files, Rename My TV Series will do an attempt to sort the files in season/episode order. This usually results in a nicely sorted list, but sometimes it doesn’t, especially when mixing TV show or very odd filenames.

Clear lists when selecting a new TV Show (Default: enabled)

With a normal workflow, one may start with selecting a TV Show, select episodes, add files, rename, and start the next TV show. With this option enabled, all lists will be cleared when you select another TV Show, to avoid mixing up things.

In case your workflow is different, for example you do mix TV Shows or you have the habit of adding files first, then you may want to disable this option by unchecking it.

Display Episodes, in Rename list, as: (Default: New filename (formatted))

This option allows you to change the way episodes are listed in “Selected Episodes”. By default this would be the “new filename (formatted)“, previewing what the new filename would look like (for video information, dummy data is being used). If you’d like you can set this to “Show name, Season#, Episode#, title” or “Season#, Episode#, Title“.

Remove colon (:) from TV Show name (Default: disabled)

In theTVDB data, sometimes shows are not named in a consisted way. In the video demo in the beginning of this article, you could already see this. For example, we were looking for “Stargate” which resulted in:

Stargate Atlantis (2004)
Stargate Origins (2018)
Stargate SG-1 (1997)
Stargate Universe (2009)
Stargate: Infinity (2002)

Now these names are most likely correct, but you can see the inconsistency with “Stargate: Infinity (2002)”.
Enabling this option will remove the colon (:), so that “Stargate: Infinity (2002)” becomes “Stargate Infinity (2002)” automatically.

Cache Episodes will expire in x days (Default: 7 days)

To speed up things, episodes information is being cached in the SQLite database, which in most cases is just fine. Weekly broadcasted shows will most likely not update more than once a week, and most of the time information is already known far before the next episode is being broadcasted. For old show, the data may never update.
TheTVDB is however very active and old data may be corrected and updated at any time.

This is way Rename My TV Series offers the option to control the expiration time, which makes Rename My TV Series check if data has been updated. After the indicated number of days, Rename My TV Series will check if an update is needed, and if so, execute the update.

Default this is set to 7 days, but you can pick anything you want.
Some special values are:

= Cached data ALWAYS expires, so we check for updates each time we access this show,
-1 = Cached data NEVER expires, so we never check if data needs to be updated.

Preferences – TV Show History

Each time you download episodes for a given TV Show, the TV Show will be added to the history list, giving you quick access in the main window. This is convenient for TV Shows you work frequently with. There is basically no limit to the size of this list, so sometimes you’d want to clean up some of these shows. For example shows you never or no longer use, or because the list became too long for your taste.

In this section you can remove individual shows or even clear the list completely.

Preferences – Filename Format

In this section you can define the format of episode filenames (see also the “File or Directory Formatting” paragraph above for details).
You can simply type in the “Filename format” field, whatever you want. Special codes can be insert (click “Show Format Help” for details) and some predefined formats can be picked by clicking the little arrow-down button.

As you type, or change the format string, you will see the example change as well.
The example is based on the 1997 TV Show “Stargate SG-1”, Season 2, Episode 7, “Message in a bottle”, 5.1 AC3 audio (6ch), 720p (1280×720) H264 video, as an MP4 file. It will give you an idea what the episode names will look like.

Preferences – Renaming Files

Display warning before renaming files (Default: enabled)

This option will popup a confirmation request when clicking the “Rename” button. This is great to prevent accidental clicking the “Rename” button. Others may find that annoying.

Rename similar named files (Default: enabled)

When checked, Rename My TV Series will rename similar named files (any!) found in the same directory.

To illustrate this, say we have a video file called “somevideofile.avi”, any file in the same directory that starts with “somevideofile” will be renamed as wel, even if what follows in the name is more than just an extension. Say we’d rename it to “episode 1.avi” then the following files would be renamed correctly as well;

“somevideofile.sub” to: “episode 1.sub”
“” to: “episode”
“somevideofile.trailer.mp4” to: “episode 1.trailer.mp4”
“somevideofile-sample.mkv” to: “episode 1-sample.mkv”

Season and Episode numbers at least 2 chars wide (Default: enabled)

By checking this option, Season or Episode numbers will always be at least 2 characters long, and if needed a leading zero will be added.
This option has been added since normally (%SZ) the maximum length of these numbers will be used as a guide to add leading zero’s or not. However, sometimes episodes or seasons beyond number 9 may not yet exist when released, which may result in a less nice looking file or folder name in the future.
Therefor this options forces a length of at least 2 characters, as many TV Shows do not exceed 99 episodes or 99 seasons.

Video Codec: Replace H26x with x26x (Default: disabled)

As an example H264 is the official generic name for a video encoding format, but x264 is the commonly used open source H264 encoder. So H264 is a format, and X264 is a software library to create H264 files. Some users prefer to see x264. This works for all codecs starting with H26, for example H265 will become x265.

Create log file of renamed files (Default: disabled)

To debug, undo, or just see what has happened, a log file can be created. In this log file you find the failures, original filename and directory, and the new filename and directory. After clicking “Rename” and the renaming process has completed a dialog will popup asking you if you want to save a log and where you’d want to save it.

Set Media Files Creation date to First Aired Date (Default: enabled)

The creation date, or last-modified date (depending on your Operating System), of your video file and extra files, will be changed to the first aired date. This gives you right away an idea when a given episode was first aired by looking at the files, and it allows for easier sorting of files.

Clear list after renaming completed (Default: disabled)

After a rename has completed, the “Selected Files” list will reflect the new filenames (or the old filenames if it failed). Personally I find it convenient to see this as a visual feedback, but some like to work faster and in that case, clearing the list right-away can be more convenient.

Save TV Show Banner (JPG) and info file (NFO) in parent folder of media file (Default: disabled)

This option will create a banner JPG file and an NFO file in the directory that holds the directory with the new named video file in it. For example if you video file is “C:\TVShows\MyShow\Season 01\MyEpisode.avi“, then it will create banner.jpg and show.nfo in “C:\TVShows\MyShow\“.

The NFO file will include some basic info about the TV Show.

Save Episode info (NFO) with Media File (Default: disabled)

Here episode information file (NFO) will be saved with the episode video file, with the same name.
Again, this file will include some basic episode information. Audio and Media information will be pretty basic, since tools like KODI tend to overwrite this anyway.

Capitalization: Series Name, Episode Title (Default: Do not change)

Here you can choose if a series name and episode title needs to be changed when it comes to using caps or not.
Your options are:

  • Do not change” (recommended),
  • Caps for the first letter of the first word“,
  • Caps for the first letter of each word“,
  • all uppercase” or
  • all lowercase“.

Keep in mind that this may give undesired results, for example “Stargate SG-1” looks weird if you’d choose caps for each first letter of each first word (Stargate Sg-1).

Capitalization: File Extension(s) (Default: all lowercase)

Extension of video files and similar named files are either set to either “all lowercase” (mp4, srt, sub etc) or “all uppercase” (MP4, SRT, SUB etc).

Move to folder (Default: disabled, “%N (%Y)/Season %SZ/”, current directory)

As mentioned before, renamed files can automatically be moved to a different location.

The destination is determined by 2 parts; “Base Path” and “Move to Folder“.

The “Base path” can be either the current directory of the video file “(currentdir)” (click the “X” button), or a path you select by clicking the “Select base Path” button.
The “Move to Folder” path where to move the file to is determined by the format string (%N (%Y)/Season %SZ/) which works the same way as the filename format.
When using directory separator symbols, make sure you use the right one (“/” for Linux/Mac and “\” for Windows).

All put together: <base patch>/<move to folder>/episode.avi

Preferences – Replace Special Characters

Sometimes, titles or names have funny characters in it, and depending on your Operating System this will cause problems.
Here we can define what characters should be replaced with what character or text.

Default for MacOS and Linux;

  • *” will be replaced with “x”,
  • double quote (“) will be replaced with “`”,
  • single quote (‘) will be replaced with “`”,
  • forward slash (/) will be replaced with “_”,
  • colon (:) will be removed (= replaced with “nothing”).

For Windows we additionally have the following removed (replaced with “nothing”):

  • less than (<)
  • greater than (>)
  • forward slash (/)
  • backslash (\)
  • vertical bar or pipe (|)
  • question mark (?)

Windows does NOT allow these characters in filenames (reference).

As you can imagine these characters can cause serious issues in filenames.

You can add/remove/change anything you’d like in this list.

If a character is a space, [SPACE] will be shown in the list, if a character is “nothing” then [EMPTY] will be displayed. This is for display purposes only, otherwise you wouldn’t be able to see the difference.

How to Uninstall

Not every program you try is all that great and awesome, or doing what you were looking for – suggestions are welcome, but incase you really want to remove Rename My TV series, follow these steps.


All executables are in the application that you’ve placed in “Applications” named either “” or “RenameMyTVSeries“. Just drag it into the trash.

Settings, banners and database are located in /Users/<username>/Library/Application Support/Rename My TV Series , which you can drag into the Trash as well.


Under Linux you’ll find 2 executables; “RenameMyTVSeries” and “ffprobe” – delete those.
If you saved the icons as well, then you can toss those as well.

Settings, banners and database are stored in ~/.config/Rename My TV Series , so it’s hidden in your home directory. Delete that as well.


Under Windows you can use the uninstall option, which removes DLL’s, executables, settings, database and banner cache. Executables and DLL’s are usually stored in C:\Program Files (x86)\Rename My TV Series just in case you want to double check..

Settings, banners, and database are located in c:\Users\<gebruikersnaam>\AppData\Local\Rename My TV Series.

A word of gratitude …

I’ve spend numerous days in developing this application, but without the help and work of others, this may not have been possible at all. So I’d like to take a minute to thank some teams and folks for helping out, providing the means to develop, or tools that made my life easier, in no particular order.

Lazarus Pascal Team, for providing an awesome free tool to developers on numerous platforms, especial Dmitry (skalogryz) for his work on the Cocoa widget set and Leandro for his BGRA controls.

TheTVDB Team and users, without their work there would not be no data on TV Shows.

SQLite Team, for providing a compact, fast and cross-platform database engine.

FFmpeg team, for providing the tools to work with media files.

And of course some of the users here providing ideas, suggestions and doing beta testing.

Donation options

Donations are very much appreciated, but not required. Donations will be used for web-hosting expenses, project hardware or a motivational boost (a drink or snack). Thank you very much for those have donated already! It's truly AwEsOmE to see that folks like our articles and small applications.


There are 38 comments. You can read them below.
You can post your own comments by using the form below, or reply to existing comments by using the "Reply" button.

  • Oct 28, 2018 - 5:25 PM - Mike Skultety Comment Link

    The mac version reports the app is damaged and needs to be moved to the Trash.

    Version 2.0.0


    Mike Skultety

    • Oct 28, 2018 - 5:35 PM - hans - Author: Comment Link

      Hi Mike,

      thanks for testing this quick, as I had not caught that problem. 

      I’ve just uploaded a new version – seems to be a DMG issue. Please download again and try again.
      I’ve signed the DMG and the application. If it fails again, I’ll upload it without signing the DMG.



      • Oct 28, 2018 - 5:40 PM - Mike Skultety Comment Link

        Hans, same error I’m afraid.


        Mike Skultety

        • Oct 28, 2018 - 6:07 PM - hans - Author: Comment Link

          Yep, I’ve noticed it … I’ve just uploaded a unsigned version – which did work after I downloaded it here.
          This means that when you start the application, you’ll get an “unknown developer” message and in System Preferences you’ll have to click “Open Anyway” under the Security and Privacy options. If you’re running “Little Snitch” it will bark that it’s blocking Internet traffic because the application is not signed and you’ll have to manually allow traffic to go through.

          It’s past midnight here, so I’ll give the signing thing another try tomorrow when I’m more awake.
          Thanks Mike for catching this so fast. I’ll add a note to the article for now. 



    • Oct 28, 2018 - 5:41 PM - hans - Author: Comment Link

      Hangon – I just downloaded the DMG and am getting the same message again.
      My local file works just fine … 



      • Oct 28, 2018 - 5:58 PM - hans - Author: Comment Link

        Alright, found the problem, just not yet how to fix it 
        One pays $99/year to get the ability to sign applications and they make it far from easy. 
        So it seems that it doesn’t like my signature, I do not know why just yet … So I’ll try to make a DMG with an (for now) unsigned version.



        • Oct 28, 2018 - 6:44 PM - Mike Skultety Comment Link

          Got the unsigned version, opens fine. The application is generic. Get some sleep and thanks, great program!


          Mike Skultety

          • Oct 28, 2018 - 6:49 PM - Mike Skultety Comment Link

            May have found a bug, or a preference Im missing. Renaming Dr. Who under the old version would include the year (2005) in the name, the new version, while listed in the search, no longer includes the year. FYI.

            Mike Skultety

          • Oct 29, 2018 - 3:56 AM - hans - Author: Comment Link

            Thanks Mike,

            oh man, the signing issue has been frustrating, oh well – another day, and a new attempt to fix it.
            I’m glad you could at least play with the unsigned version 

            As for the bug you found;
            On TheTVDB, some shows do and some shows do not have a year in their title in the (YEAR) format – unfortunately a little inconsistency.
            This could cause potential issues when using “%N (%Y)” in the filename or path string. With some shows it would produce “Doctor Who (1963)” and with other “Doctor Who (2005) (2005)” – so the user would not be able to define a filename string applicable for all shows.

            To remedy this, I’ve stripped the years from names, if they would have a year. This way all shows do not have a year when used in the format string, and a code like “%N (%Y)” would always work.

            So, the fix for you would be to replace %N with %N (%Y) in the filename and move-to-folder path format 


          • Oct 29, 2018 - 4:04 AM - hans - Author: Comment Link

            Thanks for the reminder though – I’ve added the comment to the article! 


          • Nov 1, 2018 - 9:08 AM - hans - Author: Comment Link

            Mike, I just updated the Mac version – still not signed though.
            Some minor bugs have been fixed related to languages and such.


  • Oct 29, 2018 - 7:08 PM - Tony Comment Link

    Hi Hans. I’m having trouble with the new Windows 32 bit version (I’m on Windows 7 x64 Service pack 1). It installs fine, all install options left as default. When it launches a window opens and says “SQLite Initial database created successfully). That window closes after a few seconds, and there are 2 grouped icons on the taskbar, but the app doesn’t bring up a working GUI, only the small windows as shown in this screenshot – .I’ve tried a few compatibility settings (I’m signed on as administrator) and reinstalled, but no luck yet. Do you have any suggestions? For what it’s worth, the older version worked fine. Thank you.



    • Nov 13, 2018 - 9:39 AM - hans - Author: Comment Link

      Hi Tony – I just uploaded v2.0.1. Would you mind testing this one under Windows 7? Thanks 



  • Oct 29, 2018 - 7:49 PM - Tony Comment Link

    I have found a fix for the above problem – it appears the program is launching minimised. I right clicked the right hand side box as shown in the screenshot above and selected ‘maximise’ and it works. It appears there are some sizing shenanigans present as resizing it is difficult.



    • Oct 30, 2018 - 4:26 AM - hans - Author: Comment Link

      Hi Tony,

      Interesting and good find! 
      I have no means to reproduce this issue though (only have Windows 10 available) – but the application does remember size and position by default and at startup resizes (if needed). I’ll triple check if there is anything in the code that may cause this.

      After restoring the size of the window, please check in settings: uncheck “Save Window Size/Pos”, and click “Reset Windows” – see what happens.



    • Oct 30, 2018 - 4:33 AM - hans - Author: Comment Link

      I remembered Microsoft has some free virtual machines available (link) for Internet Explorer testing.
      I did find one for Windows 7, which I’m downloading as we speak. I’ll take a look and see if I can reproduce this issue.



    • Oct 30, 2018 - 8:41 AM - hans - Author: Comment Link

      I think I may have found what triggers this and it seems specific for older Windows versions. 
      I have one more bug to fix and then I’ll upload a new version. 



    • Nov 1, 2018 - 9:08 AM - hans - Author: Comment Link

      Hi Tony,

      just uploaded a version that may or may not fix this (never got the virtual machine to go, but noticed something while compiling that may have caused this issue).



  • Oct 30, 2018 - 5:36 AM - Martin Comment Link

    I’ve downloaded the Windows version yesterday and it works well so far. The only thing is, that it offers me only English titles, although there are also German titles available at TVDB. I have already changed the default language to German. No other languages are downloadable except of English.





    • Oct 30, 2018 - 5:39 AM - hans - Author: Comment Link

      Hi Martin,

      You can set the languages in 2 places: in the main window (temporary) and setting (more permanent, setting the language in the main window at program startup).
      Can you tell me what show you’re looking for, or what steps you’ve taken? I’d like to test and see if I can reproduce the issue.




      • Oct 30, 2018 - 5:46 AM - Martin Comment Link

        Hi Hans,

        thanks for your quick answer. I set it to German on both places, I also tried Italian. I tried it with Homeland, The Middle and Unbreakable Kimmy Schmidt. For all 3 series are also German episode titles available on TVDB.




        • Oct 30, 2018 - 4:13 PM - Bob Comment Link

          Hi Hans,

          i have the same problem on my IMac. I set the languages to Italian on both places and, with more series, I have only the English titles available.




          • Oct 30, 2018 - 6:04 PM - hans - Author: Comment Link

            Thanks Bob, I found the issue; the standard query for episodes does not seem to honor the accepted language return.
            I’ve rewritten things so it uses a slightly different query to actually pull the right language for the episodes.

            Because of this I noticed a bug when mixing TV shows in different languages, I hope to implement that tomorrow.

            Thanks for reporting and thanks for your patience … 


      • Oct 30, 2018 - 5:50 AM - hans - Author: Comment Link

        Hi Martin!

        Thank you too for the quick response 

        I’ll go test in a minute, I’m setting up a virtual machine to test Windows 7 for Tony, and after that I’ll test on Windows 10 as well.
        Which Windows version do you run?



        • Oct 30, 2018 - 5:53 AM - Martin Comment Link

          I use Windows 10 Pro (1803)

          Thanks in advance for testing it! :)



        • Oct 30, 2018 - 8:43 AM - hans - Author: Comment Link

          I think I found the issue. 
          The new TheTVDB API doesn’t look at the language with it’s default episodes query.
          I’ll try to implement using a different type of query that does look at the language selected.
          I hope to post a new version today.



          • Oct 30, 2018 - 8:48 AM - Martin Comment Link

            Great! Thank you very much! 


        • Oct 30, 2018 - 5:47 PM - hans - Author: Comment Link

          OK, fixed the issue – other languages work very well now.
          One bug did get introduced with this; when mixing shows in different languages.
          For those mixing shows; when adding episodes of a show in German, and the adding episodes in English will either result in all episodes becoming english, or blanks for where there are none. 
          I do have a fix for this in mind, but that will take a few hours to implement.
          I hope to post a new version tomorrow as it’s almost midnight here. 



    • Nov 1, 2018 - 9:09 AM - hans - Author: Comment Link

      Hi Martin,

      I just uploaded new builds that should address this issue – please give it a try.



      • Nov 1, 2018 - 9:15 AM - Martin Comment Link

        Hi Hans,

        many thanks for your work! I just downloaded and tested it, now it works well! 




      • Nov 1, 2018 - 9:51 AM - hans - Author: Comment Link

        Awesome! Thanks Martin – this kept me busy for 2 full days, so I’m happy to hear things work well! 



  • Nov 1, 2018 - 9:17 AM - hans - Author: Comment Link


    New builds available for Windows, MacOS and Linux, addressing some language issues.
    Switching back and forth between language should work properly now. Please note that not all shows are available or complete in all languages. If this happens, Rename My TV Series will switch to English, most of the time automatically. I did notice that some TV shows have rather poor translations, with a weird sorting order for DVD. So your mileage may vary.

    You can now even mix languages in the Selected Episodes list – for those working with mixed shows.

    Some additional things have been added, like tracking the database structure version (for the language issues I had to change a few things in the database).
    In the future I may create a more elegant way to handle this. Right now, if the database structure is old, all data will be dropped and a new database will be created.

    Additionally, the similar named files will no longer be renamed if the related media file failed to rename. This will be indicated in the log file as well.

    When toggling languages:
    – When you were searching for a show, the search will be started again in the selected language. If the search fails, it will revert to English.
    – When selecting a show from the history dropdown, only that show will be attempted to download. If this fails, it will revert to English as well.

    Pending issue: Signing the application for MacOS.
    I’ve followed all the rules by Apple, but for some reason it refuses to work with FFprobe. I’ve reached out to other developers, but so far no clear fix for this issue.



  • Nov 3, 2018 - 5:14 AM - hans - Author: Comment Link


    Signing issue for MacOS has been resolved – the application is now signed officially, FFprobe and notifications work as they should!



  • Nov 7, 2018 - 11:44 PM - Pokewhat Comment Link


    So I haven’t used this in a while and didn’t know there was an entirely new one out. I just tried renaming a series with sequential episode count, and the old one was giving an error so I downloaded this, but it doesn’t have the option for sequential episode naming. Any chance you’d be adding that?



    • Nov 8, 2018 - 3:46 AM - hans - Author: Comment Link

      Hi PokeWhat,

      actually, it does have the option to number episodes sequentially.
      Under the header “Episodes“, you’ll see the option to sort by aired or DVD … and the option to number “continuously“.
      When choosing that options, episodes will be numbered starting with episode 1, season 1. If Season 1 ends with episode 24, then season 2 will start with episode 25, etc.
      Episodes for Episode 0 (zero, a.k.a. “Specials”) will be ignored in this count.

      I assume this is what you mean?



      • Nov 8, 2018 - 11:17 AM - Pokewhat Comment Link

        Yes! So sorry about not realising it. I guess I was looking for it so hard in the place where it used to be, I couldn’t see it right under my eyes. Thank you very much!



      • Nov 9, 2018 - 2:15 AM - hans - Author: Comment Link

        No problem – it happens 
        At least you’ve found it now. 



  • Nov 13, 2018 - 7:59 AM - hans - Author: Comment Link

    UPDATE (2.0.1):

    Minor bug fixes and some cosmetic improvements (mostly for macOS dark theme).



Your Comment …

Friendly request to not post large files here (like source codes, log files or config files). Please use the Forum for that purpose.

Please share:
Notify me about new comments (email).
       You can also use your RSS reader to track comments.

Tweaking4All uses the free Gravatar service for Avatar display.
Tweaking4All will never share your email address with others.