Movie File Tools‎ > ‎

Documentation

How to install?

No real install is needed, just expand the zip to anywhere on your local computer.
 A few bat files is included purely to demonstrate how to use use the script

In the "Settings"-folder you will find normal.cfg and local.cfg + others. Customize these settings for your specific needs. See more about the settings on this page

[ OPTIONAL ] If you like using the script I recommend that you make your own "sets" of cfg + bat - This will avoid overwriting your customizations upon future updates of this script.

[ Pure commandline ] The settings-files was thought as an easier way to manage and edit settings, but you can add any of the settings as an argument as well, these will overrule the settings.cfg.
This requires that you edit the actual commandline to cscript. like:
cscript //NOLOGO %VBSCRIPT% "%~1" -cfg:"mySetting.cfg" -createfolderjpg:1 -trimext:1

The above commandline will launch the script, and tell it to load mySettings.cfg, and then apply/overwrite the last two arguments shown in example. 





What should i use the .meta file for, can i delete it?
No matter which method you are using the MFT script, it will require a meta file, if none is found, it will create one. What the meta file can be used for is almost unlimited, but for; categorizing, indexing and naming would be some of them. Of course, it all depends on the media player, or whatever tools you have to perform your specific tasks (like this script does)

If you are using a media player that can read meta data from linked files, and you need the metafile a certain format, then please contact me, then i will see if can build a "converter" that will create compatible meta files for your system.

You can delete the file yes, but if you decide later to change your naming convention, you'd have to download meta file again. Having the meta file next to the movie is like having certified link between a file and a IMDB id, the most crucial part is often the detection of the movie.




The Settings

This is the list of settings that you can use.

metaforceupdate=0
If enabled (1), this option will refresh/update metafile, even if it already exist.

downloadartwork=1
This option will download artwork (if it does not exist)

trimext=1
If disabled (0), this option will keep the file extension in metafilename The Movie [2010].avi.meta

createfolderjpg=1
This option will make a folder.JPG

getlocaltitles=0
If you use the local title option #title_xx# , then an additional pageload at imdb is required.
This option will force the getting and storing the data of multiple titles, even if you selected the original title

filerename=#title# [#year#]
This is the file name convention. New feature is that you can now use any of the settings from the meta file. Better not use #plot# as name..unless you want to end up with a very long file name ;)  Per default, the script gets the "Original" title from IMDB, this means; even if it's an international known movie, if the movie is made in France, it will most likely have a French title. You can use #title_int# to try and get the "international" title.. or any other local title #title_it# (Italian title) (if not found, it will fall back to original title).

filefilter=| []|
Works in conjunction with filerename. With this you can filter unwanted results, | character is delimiter (white/spaces is included! , start and end the filter with an | to be sure to wrap the string correct)

filesuffix=|The|A|An|Le|La|
Move prefixes to suffix so "The Movie [2010].avi" will be named "Movie, The [2010].avi"

folderrename=#title# [#year#] [#rating#]
Same procedure as filerename

folderfilter=| [#year#]| [#rating#]| [ Subs]|.:,|
Works in conjunction with folderrename. Same procedure as filefilter

foldersuffix=|The|A|An|Le|La|
Same procedure as filesuffix

metadir=
This option allows you to store/get meta files from a shared directory.
example: metadir=c:\moviemetafiles
 
artworkdir=

This option allows you to store/get artwork files from a shared directory.
example: metadir=c:\covers

sublightdetect <0|1>  (new 2012.02.08)
This makes you able to disable Sublight detection (0) ,
Warning: When disabled, the detection is based completely on filename. 






Renaming Details

Whatever value is in the meta file you can use them all as a wildcard:
#title# #year# #rating# #pg#  etc..

Get local titles:
Example #title_ro# - this will get you the Romanian title (if it exist)
See lib/countrycodes.txt for country codes.

Fallback titles (new 2012.02.08)
If a certain title does not exist for your country, you can create a prioritized title-wildcard like this
#title_ro|title_int#

Above example will try to get the Romanian title, if that does not exist it will use the "International"
Note: If none of the "local" titles exist, the script will end up using the "Original title" which always exists.

#title# - The "original title"
#title_int# - The "International title"


There are some other special wildcards as well
#sublang# - If this wildcard is used, the MFT script will try to detect the language of found subtitle, so you can use it in the filename.





Filtering unwanted results

filerename and folderrename ,both has a post filter; filefilter and folderfilter
The filters should be considered as an array, delimiter is character: |

The most common filters are already applied in example files, but in case you are mixing up your own structure, you need to use the filters.

Example:

Consider you are using following naming convention:
filerename=#title# [#year#] [#rating#]

Ideally outputting something like: The Heist [2008] [6,7].avi, but If the movie has not been rated by anyone, your filename could end up like this: The Heist [2008] [].avi
To "fix" that, you need to can put that specific unwanted result into your filefilter array.

filerename=#title# [#year#] [#rating#]
filefilter=| []|.:,|


Note: the space before the empty brackets is included!
- The file ends up being called: The Heist [2008] [6,5].avi
- Also note how the filter also replaces
dots with comma's


Another example:

You can mix wildcards with any other characters, and as in example, if you use:
filerename=#title# [#year#] [#rating#] [#sublang# Subs]

If no subs are found, without a filter it would come out like this:  The Heist [2008] [7.6] [ Subs].avi

Again, to fix this we add the unwanted result to the filter

filerename=#title# [#year#] [#rating#] [#sublang# Subs]
filefilter=| []|
[ Subs]|


Same procedure for folderrename/folderfilter
Comments