Purpose of Rename My TV Series
Originally the application was built as a purpose to learn more about Lazarus Pascal and cross-platform development.
Be properly informed about Local Copyright Laws …
Rename My TV Series, and Tweaking4All in general, does not provide any methods, means, or services, to access or distribute copyrighted materials.
Rename My TV Series cannot be used, and is not intended, to promote or facilitate the possible illegal distribution of copyrighted materials.
Always consult your local laws – be informed. It is your own responsibility to comply with these laws.
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.
- Support the new TheTVDB.com 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
If you like Rename My TV Series …
If you use and/or like Rename My TV Series, then please like us at Alternative.to, or share the link to this page on social media.
It’s would be greatly appreciated.
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 v2.0.10 macOS (64 bits)
Direct reference link: https://www.tweaking4all.com/downloads/RenameMyTVSeries-2-macOS(64bit).dmg
| Download Now
DOWNLOAD - RenameMyTVSeries v2 Windows (32 bits)
Direct reference link: https://www.tweaking4all.com/downloads/RenameMyTVSeries-2-Windows-32bit-setup.exe
| Download Now
DOWNLOAD - RenameMyTVSeries v2 Linux (64 bits)
Direct reference link: https://www.tweaking4all.com/downloads/RenameMyTVSeries-v2-Linux64bit.tar.gz
| Download Now
Linux users – OpenSSL Development Dependency!
Linux users may need to install openssl-devel (or libssl-dev) – which is not the same as “just” OpenSSL.
sudo apt-get update
sudo apt-get install libssl-dev
Fedora dnf (thanks Chris!!):
sudo dnf upgrade
sudo dnf install openssl-devel
To make access to beta releases easier, here the most current beta versions.
Please be aware that these are test versions, so they can have bugs and potentially will destroy all your files and set you house on fire.
Linux users: Please pay attention to the versions. There is a GTK version and a Qt5 version!
When using the Qt5 version, please make sure to install “QT5Pas” manually from your package manager that came with your system.
BETA DOWNLOAD - RenameMyTVSeries-2.1.5-b21-beta-Windows-32bit-setup.exe
||2.1.5 build 21
||Beta version of Rename My TV Series - 32 bit, including ffMPEG and SQLite. (updated, sqlite dll updated)
| Download Now
BETA DOWNLOAD - Rename-My-TV-Series-v2.1.5-(Build-22)-beta-macOS-64bit.dmg
||2.1.5 build 22
||Beta version of Rename My TV Series, resolving rename extra files issue, and DMG support for macOS 10.11+.
| Download Now
BETA DOWNLOAD - RenameMyTVSeries-2.1.5-GTK-b21-beta-Linux-64bit-shared-ffmpeg.tar.gz
||2.1.5 build 21 GTK
||Beta version of Rename My TV Series - 64 bit Linux, GTK, install your own ffMPEG/ffProbe with "sudo apt-get install ffmpeg"
| Download Now
BETA DOWNLOAD - RenameMyTVSeries-2.1.5-GTK-b21-beta-Linux-64bit-static-ffmpeg.tar.gz
||2.1.5 build 21 GTK
||Beta version of Rename My TV Series - 64 bit Linux, GTK, comes with static ffMPEG and ffProbe (big).
| Download Now
BETA DOWNLOAD - RenameMyTVSeries-2.1.5-QT5-b21-beta-Linux-64bit-shared-ffmpeg.tar.gz
||2.1.5 build 21 QT5
||Beta version of Rename My TV Series - 64 bit Linux, QT5, install your own ffMPEG/ffProbe with "sudo apt-get install ffmpeg"
| Download Now
BETA DOWNLOAD - RenameMyTVSeries-2.1.5-QT5-b21-beta-Linux-64bit-static-ffmpeg.tar.gz
||2.1.5 build 21 QT5
||Beta version of Rename My TV Series - 64 bit Linux, QT5, comes with static ffMPEG and ffProbe (big).
| Download Now
- v2.0.6 – Bug fix with database packetsize (Replace Chars) and some minor other bug fixes
- v2.0.5 – Bug fix similar named files.
- v2.0.4 – Bug fixes and some new features
– Fixed counter bug in list found episodes
– Added Force Refresh button (forces to redownload TheTVDB data)
– Added a splitter allowing you to resize the SelectedEpisodes and SelectedFiles lists
– Added button to reset the splitter position back to the middle
– Added # and ? to default replacement special chars to be replaced with nothing (removed)
– Added in Preferences: when double clicking a row in the “History”, that row will be removed
– Added in Preferences: Optional have no leading zero’s for the “Extras” (season 0)
– Added the option to load episodes right away when selecting a search result as an alternative to double clicking a show (see Preferences)
– Added the option to use both titles when merging 2 episodes (Eg. title 1 – title 2)
– Bug fixed: when more files are shown than episodes listed a would show name dummy for the missing episode in the list
– Renamed and repositioned some buttons in the main window (space needed for the new buttons)
– Work around for selecting from history and clicking search a second time – now shows results (removed year from edit field)
– Resolved issue with minimum number of characters for Season and Episode (for example with shows that have a year number instead of a season number)
– Fixed: For TV shows that miss a First Aired date, an attempt will be made to retrieve it from the first episode’s airdate
– Added AutoLog option with fixed path for log files – logs will be stored in that directory automatically when this option is enabled
– Added an optional default log location
– Added seconds to log filename (for those who are really quick)
- v2.0.3 – This version was skipped, since it was released for beta testing some of the new features in 2.0.4
- v2.0.2 – Added parameter for %NY (see below), implemented Database upgrade mechanism, improved language support
- v2.0.1b – Linux only: Minor refresh issue in the preferences made menus look transparent (thanks Mike for reporting!).
- v2.0.1 – Minor bug fixes and some cosmetic improvements mostly for macOS dark theme.
- v2.0.0 – Initial release of Rename My TV Series v2
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 Dark Theme)
Rename My Tv Series – Linux (Mint)
Rename My Tv Series – Linux (Mint Dark Theme)
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;
- Make sure you’re spelling the name correctly,
- Keep it short and simple, leave out things like the year and words at the beginning like “the”,
- If you still get no results, try looking for the English name (switch the language button to “English”),
- 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
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 theTVDB.com.
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;
|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
||Flip the selection
||1 or more rows
||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
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”),
“somevideofile.en.srt” (to: “episode 1.en.srt”),
“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.
To still accommodate the format used by TheTVDB, the code “%NY” has been introduced – since some media management tools seem to get confused when always (or never) adding a year.
When using this for the show title, a year may, or may not be included, depending on how the name was defined on TheTVDB.
It’s not recommended to use “%NY” and “%Y” in the same filename or directory name format string, since years may appear double.
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
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
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:
0 = 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”
“somevideofile.en.srt” to: “episode 1.en.srt”
“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.
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.
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.
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 “RenameMyTVSeries.app” 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\<username>\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.