Welcome to Media Center Master!
A powerful solution for mastering your digital media library.
Supporting Emby, Kodi/XBMC/OSMC, Plex, Windows Media Center, and more!

Home Download Gallery Wiki Issue Tracker Licensing Forums

   FAQ  •  Search •  Login •  Register     
It is currently October 19th, 2017, 10:08 am

All times are UTC - 7 hours [ DST ]



Post new topic Reply to topic  [ 1 post ] 
Author Message
 Post subject: Non-download Parser vs. Download Parser (TV episodes)
PostPosted: November 9th, 2015, 7:00 pm 
Offline
Community Support

Joined: July 31st, 2011, 2:36 pm
Posts: 988
Location: Texas, USA
For Free and Premium License Versions

Should you require assistance with any information provided,
please post in the "Support & General" forum and refer to this guide.

Your "Support Information" is required for all Support posts and Bug reports.
Debug logging can provide additional details in the log window.
Please include any additional items to help describe the problem, e.g.,
a copy of the section from the log window or log file, or upload and attach
the log file, folder structure examples, file name examples, and/or any screen capture images.

Support Information:
Help (menu) --> Support Information (5th item) --> Include log file (optional) --> Copy All --> Yes --> OK --> Paste into forum
or
Window's Start button --> All Programs --> Media Center Master --> Support Information

Debug Logging:
Help (menu) --> Debug... (7th item) --> Show developer-level debug messaging

Log File:
Application (menu) --> Logs and data... (7th item) --> Open logs & data folder --> Activity log for YYYY-MM-DD.log
or
C:\Users\USERS NAME\AppData\Roaming\Peter Souza IV\Media Center Master\Activity log for YYYY-MM-DD.log

Log window:
"Ctrl+c" also works to copy.

Do not reply to this post.



Non-download Parser vs. Download Parser (TV episodes)
Media Center Master v2.14 (build 25615.885) / September 13th, 2015
Edited: November 13, 2015

  
Contents

  1.  Acknowledgements 
  2.  Introduction 
  3.  Non-Download Parser 
  4.  Download Parser 



  1. Acknowledgements  


      This guide would not be possible without the members of this community who have provided direct and indirect assistance.

        Pete
        doug2h
        mikep
        And, all of the users who have posted topics, and replies to the forums.

    ___________________________________

  2. Introduction  


      The Non-download Parser and the Download Parser are names given to the different methods used by Media Center Master to process media titles. The Non-download Parser is the core feature of the program and it is used after the user has added media titles to the collection "Scan" folders. The Download Parser is a "Premium" license feature and it is used to processes new downloads in the "Watch" folder.

      It is important for the user to understand how the two (2) methods work with TV episodes. The logic used for identifying TV series titles and the requirements for episode file names are completely different in each method. Knowing how the two (2) methods work will provide the user with different options to deal with problematic file names.

      Media Center Master does not support DVD order files.

        See: "Renaming files from DVD order to Aired order" (here) in the Guides Forum for more information.

      Movie titles are not included in the guide, because both methods process movies in similar manners.

       Back to contents 

    ___________________________________

  3. Non-download parser  
    Free and Premium versions


      When episodes are added to a season folder by the user, the program has several resources available to obtain information which is needed to identify the files correctly, e.g., file name identifiers, the series folder structure, and the metadata in the series.xml file.

      Offtopic :
      "Free" and "Premium" license users
      Although downloading torrents and nzbs is a "Premium" version feature and the options are disabled, grayed out, in the "Free" version, some of the options which relates to these features are not disabled in the "Free" version.

      Search terms are, only, used for downloading.

        Select series in library (left side) -> Metadata tab (right side) -> Search terms (3rd item under buttons)

      Advance Quality Tuning options are, only, used for downloading.

        Application (menu) -> Setting & Preferences... (1st item) -> Downloader (tab) -> Advance Quality Tuning (bottom section of tab)

      "Premium" license users
        Application (menu) -> T.V. series title detection override... (2nd item)

      The "T.V. series title detection override" feature is a "Premium" version feature, it is disabled, grayed out, in the "Free" version.

      When episodes are added to the "Season" folders by a user, overrides are not required. The mapping/matching information is proved to the program when the user adds an episode file to season folder for the related TV series, i.e., the program assumes the user is placing the file in the correct TV series.

      The standard naming convention for episode files is that it includes:

      1. The series title name, followed by

      2. A supported season/episode identifier, e.g., SxxEyy, SxEE, SEE, and finally, if included,

      3. An episode name

      But, this is not required when using the "Non-Download Parser."

      The following examples are provided to illustrate how the non-download parser works with different file naming patterns and show the user it is not always necessary to rename a file or use bulk renaming programs, such as: FileBot, Bulk Rename Utility ..., before processing problematic files with Media Center Master.

      The examples are not provided to indicate the program can and will handle any and all file naming patterns you throw at it. There may be a bug in the program or logic has not been written into the program to handle a particular scenario.

        TV Shows . . . <scan folder>
        |
        2 Broke Girls
        ||
        |Season 01
        ||
        |Season 02
        |||
        ||1.mp4 . . . <example 1>
        |||
        ||S02E02.mp4 . . . <example 2>
        |||
        ||Two and a Half Men S02E03.mp4 . . . <example 3>
        ||
        |backdrop.jpg
        ||
        |banner.jpg
        ||
        |poster.jpg
        ||
        |series.xml
        |
        Arrow

      The TV series metadata must be fetched, first, to generate the series.xml file. The best practice to do this is by using the "Add a T.V. series" wizard found in the "Media" menu (5th item). The wizard will automatically create a series folder in a specified "Scan" folder, fetch metadata and artwork, create the series.xml file, name the folder and files, and export to other metadata formats (Free and Premium versions).

      Season folders must be created and named by the user in Windows Explorer. The minimum naming requirement for a season folder is a number. Other acceptable examples are listed in the setting option for the "T.V. season naming convention" found in the Settings & Preferences Organization tab.

      1. 1.mp4

        Example 1 is an extreme case scenario, but it will be identified and fetched as episode #1 of season 2 for the series 2 Broke Girls. The number in the file name is used for the episode number. The number in the season folder name is used for the season number. The information in the series.xml file is used to provide the series title name and the series ID used at the fetching site.

          1.mp4 → 2 Broke Girls - S02E01 - And the Hidden Stash.mp4

          After the file is fetched, the information in the episode .xml file is used to provide the season and episode numbers and the episode name. The final rename result will vary depending upon the users renaming preferences in the "Organization" tab.

      2. S02E02.mp4

        Example 2 is more of a common case scenario, but it will be identified and fetched as episode #2 of season 2 for the series 2 Broke Girls. The season/episode identifier is used for the season and episode numbers. The information in the series.xml file is used to provide the series title name and the series ID used at the fetching site.

          S02E02.mp4 → 2 Broke Girls - S02E02 - And the Pearl Necklace.mp4

          After the file is fetched, the information in the episode .xml file is used to provide the season and episode numbers and the episode name. The final rename result will vary depending upon the users renaming preferences in the "Organization" tab.

      3. Two and a Half Men S02E03.mp4

        Example 3 is another extreme case scenario, but it will be identified and fetched as episode #3 of season 2 for the series 2 Broke Girls. The season/episode identifier is used for the season and episode numbers. "Two and a Half Men" will be ignored. The information in the series.xml file is used to provide the series title name and the series ID used at the fetching site.

          Two and a Half Men S02E03.mp4 → 2 Broke Girls - S02E03 - And the Hold-Up.mp4

          After the file is fetched, the information in the episode .xm. file is used to provide the season and episode numbers and the episode name. The final rename result will vary depending upon the users renaming preferences in the "Organization" tab.

      :!: The above examples are not adaptable for files that include Absolute Numbers (anime) or Daily Aired (daytime soaps, talk shows... ) identifiers in the name.

      :!: When you do not know what the end results will be after processing files, it is suggested to perform test scenarios with groups of files, e.g., 1, 3, 8... file/s at a time and verify the results, before processing several files at one time. If needed or wanted, test files can be made by creating a new blank (0 bit) .txt file, name the file as an episode, and change the .txt extension to a media extension, e.g., .avi, .mp4, .mkv...

        Open a season folder in Windows Explorer -> Right-click (context menu) -> New (bottom of list) -> Text Document (bottom of list)

       Back to contents 

    ___________________________________

  4. Download Parser  
    Premium version, only


      The Download Parser is used to process media titles that are added to the "Watch" folder from different sources:

      • Download clients, e.g., completed downloads from uTorrent, BitTorrent, the program's Usenet Downloader, SABnzbd ...

      • The user.

      In this writing the terms "download" and "downloads" are intended to be referred to episodes in general.

      When processing new downloads through the "Watch" folder, the program, only, has an episode file or a folder and an episode file to use as a resource to obtain information which is needed to identify the downloads and move them into the collection. The download name must include the TV series title as it is listed at the fetching site. The download name must, also, include a season/episode identifier that matches the season number and episode number for the TV series listed at the fetching site. There are three (3) possible scenarios that can happen.

      1. If the program determines the download name is a match to an episode for a TV series listed at the fetching site, it processes the download into the correct TV series season folder.

        1. Download example:

          • "Marvel's Avengers Assemble," thetvdb series ID 264030, season 1, episode list

              MCM Download Parser . . . <"Watch" folder>
              |
              Marvel's.Avengers.Assemble.S01E23.1080p.WEB-DL.DD5.1.AAC2.0.H264-BgFr [PublicHD]
              |
              Marvel's.Avengers.Assemble.S01E23.1080p.WEB-DL.DD5.1.AAC2.0.H264-BgFr.mkv

        2. Log message example:

            MCM: Processing new downloads in: F:\Downloads\MCM Download Parser
            -----------------------------------------------------------------------------------------
            MCM: Now working on Marvel's.Avengers.Assemble.S01E23.1080p.WEB-DL.DD5.1.AAC2.0.H264-BgFr.mkv.avi...
            thetvdb.com Searching by season 1, episode 23
            MCM: ... this is a T.V. show episode (detected using quick method)
            MCM: Moving and renaming to:
            MCM: F:\Media\TV\Marvel's Avengers Assemble (2013) [Animation]\Season 1
            MCM: Marvel's Avengers Assemble - S01E23 - One Little Thing.avi
            MCM: Fetching metadata for the new episode...

        3. Resulting media collection folder and file structure example:

            TV . . . <MCM "Scan" folder>
            |
            Marvel's Avengers Assemble (2013) [Animation]
            |
            Season 1
            |
            Marvel's Avengers Assemble - S01E23 - One Little Thing.avi

      2. Some downloads are named slightly different than what is listed at the fetching site. A known issue dealing with the uploader's preference of naming downloads different from what is listed at the fetching site. This issue brings about the two (2) problematic scenarios that are resolved with additional features in the program.
          
        1.  TV series title detection override Feature 
        2.  Series Episode Offset Mapping Feature 

        1. TV series title detection override Feature  

          1. If the program can not match the TV series title in the download to a TV series listed at the fetching site, the program stops all processing and notifies the user with a message in the log window.

            1. Problematic download example:

                "Marvel's Avengers Assemble," thetvdb series ID 264030

                  MCM Download Parser . . . <"Watch" folder>
                  |
                  Avengers Assemble S02E25 New Frontier HDTV x264-W4F[rartv]
                  |
                  avengers.assemble.s02e25.new.frontier.hdtv.x264-w4f.mp4

                Offtopic :
                If the program launched a torrent or nzb to a download client and the above download is the result of the program's processing, the default "Search terms," marvels avengers assemble, in the series "Metadata" tab had to be changed by the user to, avengers assemble. Because the user changed the "Search terms," the resulting download does not match the TV series title listed at fetching site. When search terms are changed for this type of issue the user must, also, include a T.V. series title detection override to map the download back to the original TV series.

                Search terms are, only, used for downloading torrents and nzbs.

                  Select series in library (left side) -> Metadata tab (right side) -> Search terms (3rd item under buttons)

                Advance Quality Tuning options are, only, used for downloading torrents and nzbs.

                  Application (menu) -> Setting & Preferences... (1st item) -> Downloader (tab) -> Advance Quality Tuning (bottom section of tab)

            2. Log message example:

                MCM: Now working on avengers.assemble.s02e25.new.frontier.hdtv.x264-w4f.mp4...
                MCM: Automatically detecting avengers.assemble.s02e25.new.frontier.hdtv.x264-w4f.mp4...
                MCM: F:\Downloads\MCM Download Parser\avengers.assemble.s02e25.new.frontier.hdtv.x264-w4f.mp4
                thetvdb.com Searching for: Avenger's Assemble
                MCM: ... this file was not detectable
                MCM: I'm not sure if this file is a T.V. episode or a movie -- I can't detect it as either: avengers.assemble.s02e25.new.frontier.hdtv.x264-w4f.mp4
                MCM: The file is not named in a way I understand. If this is a T.V. episode and you have a scan folder set up for it, then you may want to add a T.V. detection override settings to manually map a series description to its ID.

                The override, also, provides the program with the information to recognize future downloads that have the same wrong TV Series title. The TV series title detection override feature is found through:

                Application (menu) -> TV series title detection override... (2nd item)

            3. T.V. series title detection override example:

              • TV series listing at thetvdb:

                  "Marvel's Avengers Assemble," series ID 264030

              • Problematic download:

                  Avengers Assemble S02E25 New Frontier HDTV x264-W4F[rartv]
                  |
                  avengers.assemble.s02e25.new.frontier.hdtv.x264-w4f.mp4

              • Override:

                  Always detect T.V. show named: . . . avengers assemble

                  ... with this thetvdb.com (TVDB) ID: . . . 264030

                  ... with this tvrage.com (TVRage) ID: . . . fetcher not used in this guide

           Back to Subtopic Contents 

           Back to contents 

        2. Series Episode Offset Mapping Feature  

          1. Other downloads named with the correct TV series title and have the wrong season/episode identifier will be moved into the correct TV series folder, but the episode will be put in the wrong season folder. This will, also, cause the download to be renamed with the wrong episode information. The program has a method to map/match downloads back to the season episode listing at the fetching site. This feature requires the user to create a text file, name it: EpisodeMapping.txt, and save it in the program's "Logs and data" folder:

            1. In Media Center Master use "Ctrl+L" to open the folder location, or

            2. Navigate to, C:\Users\users name\AppData\Roaming\Peter Souza IV\Media Center Master

            :!: :arrow: If you have MCM open when you add the text file, you will need to close and restart the program so the file is loaded into the program.

            :!: :arrow: The file is used by the program for downloading and processing downloads through the "Watch" folder (no override required).

            :!: :arrow: The text file can be used to offset season and/or episode numbers.

          2. EpisodeMapping.txt syntax:

            fetchers||show name||season/episode at fetching site||season/episode in download

            :!: Use double pipes and no spaces for text separators

            1. Syntax usage details:

              • Fetchers

                  Single → thetvdb.com, or imdb.com, or tvrage.com

                  Combination → thetvdb.com+imdb.com, or thetvdb.com+tvrage.com, or imdb.com+tvrage.com

                  All → all

              • Show name → Problematic TV series title name

              • Season/episode at fetching site → SxEE

              • Season/episode in download → SxEE

            2. Series episode offset mapping example:

              • Problematic download:

                  MCM Download Parser . . . <"Watch" folder>
                  |
                  MythBusters S15E07 Blow It Out Of The Water XviD-AFG
                  |
                  MythBusters.S15E07.Blow.It.Out.Of.The.Water.XviD-AFG.avi

              • TV series listing at thetvdb:


              • EpisodeMapping.txt:

                  thetvdb.com||mythbusters||2015x07||15x07

    See: "Problem TV Series, Search Terms, Overrides, & Re-downloading" (here) for more information.

    See: "Series Episode Offset Mapping" (here) for more information.

      Related forum topics

        "Season Search Offset" (here)

        "Mythbusters - Cannot Detect" (here)

     Back to Subtopic Contents 

     Back to contents 

_________________
Support Information - Help menu (5th item)
Debug Messaging - Help menu (7th item)
Log files - "Ctrl+L" or C:\Users\user name\AppData\Roaming\Peter Souza IV\Media Center Master


 Profile  
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 1 post ] 

All times are UTC - 7 hours [ DST ]


Who is online

Users browsing this forum: No registered users and 1 guest


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  


Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group



Copyright © 2009-2017, Media Center Master, Inc. All rights reserved.