- March 10, 2006
- 4,434
- 1,897
- Moderator
- #1
This is a FAQ for the MP-TVSeries plugin.
In here you will find a solution for the most common problems. Over time more solutions will be added, so please check back on occasion before posting your 'question' on the forum.
Using the Forum Search
Setting up MP-TVSeries for the first time to import your collection
Naming your TV series, such as specials, so that they are matched correctly
UPDATED: Using the "String Replacements" to resolve weird filenames
Log File Errors explained
If you find any mistakes in my explanations, or have your own contributions, please reply to this thread so I can modify this first post to include them.
In here you will find a solution for the most common problems. Over time more solutions will be added, so please check back on occasion before posting your 'question' on the forum.
Using the Forum Search
If your problem is not in this FAQ, try searching the forum first...
[COLLAPSE]It is very likely your question was already asked by somebody else, so try a search first.
The entire MediaPortal forum is large and in different languages, so be sure to target your search at the right place.
Do not use the 'Search' option at the top of the forum, but instead click on the "Search this Forum" option on the right side:
Then try to search for a single noun keyword that describes your problem. For example if you have trouble playing back ISO files, then simply search on 'ISO'. You might get a lot of results, but focus on the thread titles first.
[/COLLAPSE]
[COLLAPSE]It is very likely your question was already asked by somebody else, so try a search first.
The entire MediaPortal forum is large and in different languages, so be sure to target your search at the right place.
Do not use the 'Search' option at the top of the forum, but instead click on the "Search this Forum" option on the right side:
Then try to search for a single noun keyword that describes your problem. For example if you have trouble playing back ISO files, then simply search on 'ISO'. You might get a lot of results, but focus on the thread titles first.
[/COLLAPSE]
Setting up MP-TVSeries for the first time to import your collection
The basic steps to get started with MP-TVSeries are as follows...
[COLLAPSE]Installing the plugin and enabling it inside MediaPortal configuration is covered by the wiki, so we will skip that for now.
If everything went ok, you should have the following shown when you enter the MP-TVSeries configuration screen:
So now we have to add a path, so that MP-TVSeries can monitor it for your TV Shows. Please click on the big grey button below 'Path' and you will be able to browse to a folder, such as:
Then you can use the refresh button:
to see the pre-import results of your collection.
If no parsing errors are shown in the list, then proceed with the import via:
otherwise fix the errors first by using the solutions provided next.
[/COLLAPSE]
[COLLAPSE]Installing the plugin and enabling it inside MediaPortal configuration is covered by the wiki, so we will skip that for now.
If everything went ok, you should have the following shown when you enter the MP-TVSeries configuration screen:
So now we have to add a path, so that MP-TVSeries can monitor it for your TV Shows. Please click on the big grey button below 'Path' and you will be able to browse to a folder, such as:
Then you can use the refresh button:
If no parsing errors are shown in the list, then proceed with the import via:
[/COLLAPSE]
Naming your TV series, such as specials, so that they are matched correctly
If you have any parsing errors, or are unable to find a matching result on import, try this first...
[COLLAPSE]The most obvious errors are the ones that show up in red.
Example:
As you can see in this larger view:
There is a problem parsing the "Bad" filenames, because there is no Season and Episode information available inside the filename. Support for "Show Name - Episode Title" is being worked on, so please 'star' the Google SVN issue then to be informed on the progress.
Until then you have to rename your folders and/or filenames and use the refresh button
until all parsing errors have been resolved.
Another solution is to use the "String Replacements", so please read the next FAQ solution as well. This also helps when you are using cryptic filenames or a different language.
After all the parsing errors are gone, it doesn't mean you are in the clear. That is because after you use the
button, the actual verification via thetvdb.com begins. This could then still result in a problem, as per:
Now you can manually correct this by entering something else at the "Local Series" textbox, after which the 'OK' button will change into 'Search Again'. Or you can skip the episode (it will be added in italic then in the Details overview), or skip the entire show with the other buttons. If you use the 'x' to close this screen, the episode will be added in raw mode, so whatever information the pre-import results showed will be used then.
That is what was done with our example, after we removed the parsing errors (in this case simply deleting those episodes in question as we already had added the 'Good' examples). Once the thetvdb.com import completes, we can go to the 'Details' tab to verify our results:
And you can see that the "Battlestar Galactica (2003)" example downloaded perfect, and we can see the cover and banner images for the show. The list on the left side:
Can be navigated to reveal all the seasons by clicking on the [+] icon to expand or the [-] icon to collapse. You will also be able to edit things in here by first selecting a show/season/episode and then use the right side to adjust the values. However if you find mistakes in the information (or missing information), then creating an account with thetvdb.com, and fixing those mistakes will help everybody else as well.
Tip: The specials at thetvdb.com are all Season 0, but to find out the Episode number you have to view the details on them. In our example the 3rd special on Battlestar Galactica is actually E08. You can verify this yourself, by going to the 'All' seasons overview page on that show, and click on the 3rd special 'The Lowdown'. The page that opens reveals 'Episode number' = 8. So S0E08 or 0x08 is needed for this episode to be found.
[/COLLAPSE]
[COLLAPSE]The most obvious errors are the ones that show up in red.
Example:
As you can see in this larger view:
There is a problem parsing the "Bad" filenames, because there is no Season and Episode information available inside the filename. Support for "Show Name - Episode Title" is being worked on, so please 'star' the Google SVN issue then to be informed on the progress.
Until then you have to rename your folders and/or filenames and use the refresh button
Another solution is to use the "String Replacements", so please read the next FAQ solution as well. This also helps when you are using cryptic filenames or a different language.
After all the parsing errors are gone, it doesn't mean you are in the clear. That is because after you use the
Now you can manually correct this by entering something else at the "Local Series" textbox, after which the 'OK' button will change into 'Search Again'. Or you can skip the episode (it will be added in italic then in the Details overview), or skip the entire show with the other buttons. If you use the 'x' to close this screen, the episode will be added in raw mode, so whatever information the pre-import results showed will be used then.
That is what was done with our example, after we removed the parsing errors (in this case simply deleting those episodes in question as we already had added the 'Good' examples). Once the thetvdb.com import completes, we can go to the 'Details' tab to verify our results:
And you can see that the "Battlestar Galactica (2003)" example downloaded perfect, and we can see the cover and banner images for the show. The list on the left side:
Can be navigated to reveal all the seasons by clicking on the [+] icon to expand or the [-] icon to collapse. You will also be able to edit things in here by first selecting a show/season/episode and then use the right side to adjust the values. However if you find mistakes in the information (or missing information), then creating an account with thetvdb.com, and fixing those mistakes will help everybody else as well.
Tip: The specials at thetvdb.com are all Season 0, but to find out the Episode number you have to view the details on them. In our example the 3rd special on Battlestar Galactica is actually E08. You can verify this yourself, by going to the 'All' seasons overview page on that show, and click on the 3rd special 'The Lowdown'. The page that opens reveals 'Episode number' = 8. So S0E08 or 0x08 is needed for this episode to be found.
[/COLLAPSE]
UPDATED: Using the "String Replacements" to resolve weird filenames
Solve more complicated parsing errors by cleaning up the filename before it is used...
[COLLAPSE]You might have made a typo in the filenames, are using cryptic/acronym based filenames or using a different language then what thetvdb.com uses to identify the TV Show.
Instead of renaming a lot of files, you can simply use the 'String Replacements' system to fix these problems.
In our example "Bad Show Name" was used to indicate such an example, and lets say that this is supposed to be the TV show 'Dexter'. Now only a single episode file was used in this example, but the same applies for an entire multi-folder structure.
Note: If you already ran an import and the 'bad' entry/entries are shown in the 'Details' tab as shown in the image above, then you first have to remove those. All the bad ones can be identified easy, because they will all be in lower case. Simply right click on them, select "delete" and remove all the database references. Be sure to click NO when it asks you if you also want to delete the files from your disk(s).
Then we need to create the solution, by going back to the 'Import' tab and clicking on the 'String Replacements' menu item, and then mark both the checkbox 'Enabled' and double click into the empty 'Replace this' field and enter the bad filename part that we are going to replace. Finally double click into the empty 'With this' field to enter the correct string that we need.
The result should then look something like this:
Now as you can see the 'Run before matching' is selected as well. Any changes you need to make to the filename to make the 'Parsing Expressions' work, need this option enabled. Say for example you have a filename "Zoey 101 S01E02 - New Roomies.avi", then you can see how the "101" part of the filename might cause a problem. A solution would be to run a "String Replacements" before, that takes "Zoey 101" and replaces it with "Zoey OneHundredOne". The 'Parsing Expressions' will then follow to split up the filename into series name, season number, episode number and episode title.
By renaming the 101 into OneHundredOne, we prevented any problems in the parsing expressions sequence to mistake the 101 as S01E01. But for our "Zoey OneHundredOne" to be recognized by thetvdb.com we need to change it back into "Zoey 101", so that's why you add another entry in the "String Replacements" setup that turns "Zoey OneHundredOne" back into "Zoey 101" with the 'Run before matching' checkbox not selected.
Tip #1: You can also use this to remove things from a filename, as you can already see by the default string replacement rules. Removing '[' and '#' characters, or replacing them with what is needed for a correct match is something you can do in here as well, without having to bother with creating complicated 'parsing expressions'.
Tip #2: Say for example your filenames are using S6E7 or 6x7 to identify Season 6 - Episode 7, then they will fail because 2 digits are needed for the episode number (S6E07 or 6x07 works fine). You could use string replacements for this as well, by adding a rule to replace 'E1 ' with 'E01 ', and do this for E2 to E9 as well.
Once you are done with all your entries, go back to the 'Import Paths' menu and click on the
button to verify that it worked.
In our example you can see that 'Dexter' now works perfectly:
Then complete the import by using the
button and you will be able to verify the results by going to the 'Details' tab:
[/COLLAPSE]
[COLLAPSE]You might have made a typo in the filenames, are using cryptic/acronym based filenames or using a different language then what thetvdb.com uses to identify the TV Show.
Instead of renaming a lot of files, you can simply use the 'String Replacements' system to fix these problems.
In our example "Bad Show Name" was used to indicate such an example, and lets say that this is supposed to be the TV show 'Dexter'. Now only a single episode file was used in this example, but the same applies for an entire multi-folder structure.
Note: If you already ran an import and the 'bad' entry/entries are shown in the 'Details' tab as shown in the image above, then you first have to remove those. All the bad ones can be identified easy, because they will all be in lower case. Simply right click on them, select "delete" and remove all the database references. Be sure to click NO when it asks you if you also want to delete the files from your disk(s).
Then we need to create the solution, by going back to the 'Import' tab and clicking on the 'String Replacements' menu item, and then mark both the checkbox 'Enabled' and double click into the empty 'Replace this' field and enter the bad filename part that we are going to replace. Finally double click into the empty 'With this' field to enter the correct string that we need.
The result should then look something like this:
Now as you can see the 'Run before matching' is selected as well. Any changes you need to make to the filename to make the 'Parsing Expressions' work, need this option enabled. Say for example you have a filename "Zoey 101 S01E02 - New Roomies.avi", then you can see how the "101" part of the filename might cause a problem. A solution would be to run a "String Replacements" before, that takes "Zoey 101" and replaces it with "Zoey OneHundredOne". The 'Parsing Expressions' will then follow to split up the filename into series name, season number, episode number and episode title.
By renaming the 101 into OneHundredOne, we prevented any problems in the parsing expressions sequence to mistake the 101 as S01E01. But for our "Zoey OneHundredOne" to be recognized by thetvdb.com we need to change it back into "Zoey 101", so that's why you add another entry in the "String Replacements" setup that turns "Zoey OneHundredOne" back into "Zoey 101" with the 'Run before matching' checkbox not selected.
Tip #1: You can also use this to remove things from a filename, as you can already see by the default string replacement rules. Removing '[' and '#' characters, or replacing them with what is needed for a correct match is something you can do in here as well, without having to bother with creating complicated 'parsing expressions'.
Tip #2: Say for example your filenames are using S6E7 or 6x7 to identify Season 6 - Episode 7, then they will fail because 2 digits are needed for the episode number (S6E07 or 6x07 works fine). You could use string replacements for this as well, by adding a rule to replace 'E1 ' with 'E01 ', and do this for E2 to E9 as well.
Once you are done with all your entries, go back to the 'Import Paths' menu and click on the
In our example you can see that 'Dexter' now works perfectly:
Then complete the import by using the
Log File Errors explained
Warning: Could not add Volume Label/Removable Property to episode...
[COLLAPSE]The 'Removable' checkbox option on an import path should only be used for dynamic content drives.
So an optical drive, CD/DVD/Blu-Ray is always the same drive letter (aka import path), but the contents depends on the optical media you insert. This is the dynamic content part, and MP-TVSeries is aware of this situation and uses volume labels and media IDs to keep track of each disc.
A network share however doesn't fall under that category and would cause the above error to show in the log file if you enable the checkbox on its import path.
[/COLLAPSE]
[COLLAPSE]The 'Removable' checkbox option on an import path should only be used for dynamic content drives.
So an optical drive, CD/DVD/Blu-Ray is always the same drive letter (aka import path), but the contents depends on the optical media you insert. This is the dynamic content part, and MP-TVSeries is aware of this situation and uses volume labels and media IDs to keep track of each disc.
A network share however doesn't fall under that category and would cause the above error to show in the log file if you enable the checkbox on its import path.
[/COLLAPSE]
If you find any mistakes in my explanations, or have your own contributions, please reply to this thread so I can modify this first post to include them.