Utility.GuidePlus History

Hide minor edits - Show changes to output

May 11, 2013, at 04:39 PM by carpeVideo -
Deleted line 61:
'''renameOnly'''  - optional, will only rename files, skipping guide operations (still needs to read the guide file to get data for the rename). \\
May 11, 2013, at 04:38 PM by carpeVideo -
Changed line 62 from:
'''CreateNpvrTrigger'''  - optional, only needed once, explained above. \\
to:
'''renameOnly'''  - optional, will only rename files, skipping guide operations (still needs to read the guide file to get data for the rename). \\
May 11, 2013, at 04:33 PM by carpeVideo -
Added line 55:
'''addExts'''    = [string delimited by ~] - additional ~ delimited extension that guidePlus should consider as video\\
Added line 83:
0.86 - Added vprj as legal extension for videos. Added new tag for showfile allowing user to specify a specific tvdb ID to use rather than search for a show.  Added ability to add further extensions.
Changed line 85 from:
0.83 - added new tag for show file "exactMatchOnly"
to:
0.83 - added new tag for show file "exactMatchOnly" which causes guidePlus to only accept exact matches on a title from theTVDB or rage.
May 08, 2013, at 07:41 PM by carpeVideo -
Changed line 27 from:
GuidePlus also adds a '*' at the end of the title if it is a new episode (aired within 3 days of its first air date), prepends the original air date to the description, and, if the description of the episode on TVRage/TVDb is larger than that from the XML file, it will replace it with the longer description. \\
to:
GuidePlus also ensures that the xml has a first run indicator and if desire adds a '*' or other character) at the end of the title if it is a new episode (aired within 3 days of its first air date), prepends the original air date to the description, and, if the description of the episode on TVRage/TVDb is larger than that from the XML file, it will replace it with the longer description. \\
Added line 55:
'''newShowInd'''    = [string] - character used to indicate new shows - optional defaults blank\\
May 08, 2013, at 07:39 PM by carpeVideo -
Added line 81:
0.85 - Correct support for first run tag.  Change default of newShowInd to "" (no indicator since TV listings will show one for you)
Added line 81:
0.83 - added new tag for show file "exactMatchOnly"
Added line 35:
Changed line 18 from:
With series listings, GuidePlus will do a lookup on manually specified series and on series that are pending recordings in GBPVR (for NPVR it will do this only if the NPVR trigger has been created - see 'NPVR Trigger' further on in this doc) to add the season and episode number (with syntax sXeY) to the subtitle of a TV series.  It saves lookups in showDetail.txt (in your GBPVR dir) to save time and internet traffic later. This file is also where you must put the title of the series you want episode information for it if it's not a pending or existing recording. The syntax for this file is as follows (in other words use a text editor to add to it): 
to:
With series listings, GuidePlus will do a lookup on manually specified series and on series that are pending recordings in GBPVR to add the season and episode number (with syntax sXeY) to the subtitle of a TV series.  It saves lookups in showDetail.txt (in your GBPVR dir) to save time and internet traffic later. This file is also where you must put the title of the series you want episode information for it if it's not a pending or existing recording. The syntax for this file is as follows (in other words use a text editor to add to it): 
Deleted lines 34-40:

!! First use with NextPVR requirements

'''NPVR Trigger:''' GBPVR keeps an easily query-able record of all pending and completed recordings. Fields such as the unique program ID are used extensively by GuidePlus. However, NPVR drops this unique ID after the event is out of the program guide window, so GuidePlus can not reliably tell if a recording is a series or movie. To get around this, a new table and a trigger are created. This trigger will drop the guide data in a new table every time a recording is scheduled/created, allowing GuidePlus to go on its merry way. To have GuidePlus create the table and trigger, run GuidePlus once with the argument 'createNpvrTrigger'. As new recordings are added, it will start to auto-detect series and do its thing.    **** Please note: As of Sept 2011, you need to rerun with createNpvrTrigger again to fix an issue with a mismatch between guidePlus and NPVR!!
\\
\\

Added line 87:
0.82 - added support for mc2xml \\
Changed line 7 from:
* Third, it's a file mover: it moves series and movies into their own directories (on any location on your network), while updating the NextPVR database.
to:
* Third, it's a file mover/archiver: it moves series and movies of a certain age into their own directories (on any location on your network), while updating the NextPVR database.
Changed line 64 from:
'''archiveAgr'''      = [days] - optional if included when archive GP will only archive files with an age of >= to the days specified \\
to:
'''archiveAge'''      = [days] - optional if included when archive GP will only archive files with an age of >= to the days specified \\
Added lines 64-65:
'''archiveAgr'''      = [days] - optional if included when archive GP will only archive files with an age of >= to the days specified \\
'''archiveOnly'''              - optional if included guide plus will only archive - no rename or guide ops \\
Added line 87:
0.76 - added archiveAge and archiveOnly options, also updates playback position table when archiving.  \\
Changed line 85 from:
0.74 - fix an issue where a join between recorded_event and other table that used start time was not working by allowing a 5 minute difference.  Also add season episode in XML recognizable by NPVR.  \\
to:
0.74 - fixed an issue where a join between recorded_event and other table that used start time was not working by allowing a 5 minute difference.  Also add season episode in XML recognizable by NPVR.  \\
Added line 85:
0.74 - fix an issue where a join between recorded_event and other table that used start time was not working by allowing a 5 minute difference.  Also add season episode in XML recognizable by NPVR.  \\
Changed line 86 from:
0.72 - 2011-05-26 - Fixed an issue where renamed recordings were getting listed as failed in the NPVR database
to:
0.72 - 2011-05-26 - Fixed an issue where renamed recordings were getting listed as failed in the NPVR database \\
Changed line 2 from:
Guide plus is yet another guide enhancer with several extra features. \\
to:
GuidePlus is yet another guide enhancer with several extra features. \\
Changed lines 5-7 from:
* First its a guide enhancer: it takes a schedules direct XML file (may work with other XML guides as well) and writes a new XML file with several enhancements for NextPVR. 
* Second it is a file renamer: if shows have season/episode tags it groups those shows and renames the file of a show to include season episode info and episode title.
* Third it is a file mover: it moves series and movies into their own directories (on any location on your network) while updating the NextPVR database.
to:
* First, it's a guide enhancer: it takes a Schedules Direct XML file (may work with other XML guides as well) and writes a new XML file with several enhancements for NextPVR. 
* Second, it's a file renamer: if shows have season/episode tags, it groups those shows and renames the file of a show to include season episode info and episode title.
* Third, it's a file mover: it moves series and movies into their own directories (on any location on your network), while updating the NextPVR database.
Changed line 9 from:
Guide plus does everything when you run your nightly epg update.  This means that files will not be renamed or relocated immediately after they are recorded which is a slight disadvantage.  However, guidePlus will do its thing (renaming, moving) for all files in the database, not just those recently created which is a great advantage.  Have 300 recordings of series you would like renamed, run guidePlus!
to:
Guide Plus does everything when you run your nightly EPG update. This means that files will not be renamed or relocated immediately after they are recorded, which some will find is a slight disadvantage. However, GuidePlus will do its thing (renaming, moving) for all files in the database, not just those recently created, which is a great advantage. Have 300 recordings of series you would like renamed? Run GuidePlus!
Changed line 16 from:
With movie listings GuidePlus will add the year it was made, the star rating (as (4+)), and if it is new to the guide (meaning its likely the first time this movie was released on the air/cable) it adds (new).  It knows it is new to the guide by creating a guideHistory.txt (in your GBPVR dir) where it records every movie its seen in a guide file that is less than 2 years old.\\\
to:
With movie listings, GuidePlus will add the year the movie was made, the star rating (as (4+)), and, if it is new to the guide (meaning its likely the first time this movie was released on the air/cable) it adds (new). GuidePlus knows a movie is new to the guide by creating a guideHistory.txt (in your GBPVR or NPVR dir) where it records every movie seen in a guide file that is less than 2 years old.\\\
Changed line 18 from:
With series listings GuidePlus will do a lookup on manually specified series and on series that are pending recordings in GBPVR (for NPVR it will do this only if the NPVR trigger has been created - see NPVR trigger further on in this doc) to add the season and episode number (with syntax sXeY) to the subtitle of a TV series.  It saves lookups in showDetail.txt (in your GBPVR dir) to save time and internet traffic later.  This file is also where you must put the title of the series you want episode information for it if its not a pending or existing recording. The syntax is as follows for this file. (in other words use a text editor to add to it.
to:
With series listings, GuidePlus will do a lookup on manually specified series and on series that are pending recordings in GBPVR (for NPVR it will do this only if the NPVR trigger has been created - see 'NPVR Trigger' further on in this doc) to add the season and episode number (with syntax sXeY) to the subtitle of a TV series.  It saves lookups in showDetail.txt (in your GBPVR dir) to save time and internet traffic later. This file is also where you must put the title of the series you want episode information for it if it's not a pending or existing recording. The syntax for this file is as follows (in other words use a text editor to add to it): 
Changed line 24 from:
Just use any year and number for the year entry and seasons entry it will get corrected by guidePlus later.  To save time and bandwidth guidePlus ONLY does series lookups on series with their titles in this file and on series that are pending/existing recordings.  If a series has been cancelled it will only do the lookup once.  If it is active it will only do the lookup if the air date of an episode in the guide is greater than that in the showDetail.txt file (skipping internet updates when a show is dormant for a long period)
to:
Just use any year and number for the year entry and seasons entry--it will get corrected by GuidePlus later.  To save time and bandwidth, GuidePlus does series lookups ONLY on series with their titles in this file and on series that are pending/existing recordings. If a series has been cancelled, it will only do the lookup once. If a series is active, GuidePlus will only do the lookup if the air date of an episode in the guide is greater than that in the showDetail.txt file (skipping internet updates when a show is dormant for a long period).
Changed line 27 from:
GuidePlus also adds a * at the end of the title if it is a new episode(aired within 3 days of its first air date), prepends the original air date to the description and if the description of the episode on TVRage/TvDb is larger than that from the XML file it will replace it with the longer description. \\
to:
GuidePlus also adds a '*' at the end of the title if it is a new episode (aired within 3 days of its first air date), prepends the original air date to the description, and, if the description of the episode on TVRage/TVDb is larger than that from the XML file, it will replace it with the longer description. \\
Changed line 32 from:
GuidePlus will alter GBPVR database entries of existing recordings as above the with episode number and air date.  This is necessary since shows already recorded will keep their data despite new information from a guide update.\\
to:
GuidePlus will alter GBPVR database entries of existing recordings as above, with the episode number and air date.  This is necessary since shows already recorded will keep their data despite new information from a guide update.\\
Changed line 38 from:
'''Npvr trigger:''' GBPVR keeps an easily query-able record of all pending and completed recordings.  Fields such as the unique program ID are easily query-able - GuidePlus uses this field extensively. Npvr drops this unique ID after the event is out of the program guide window so guidePlus can not reliably tell if a recording is a series or movie.  So I created a new table and a trigger, this trigger will drop the guide data in a new table every time a recording is scheduled/created allowing guidePlus to go on its merry way.  To have guidePlus create the table and trigger run guidePlus once with the argument createNpvrTrigger.   As new recordings are added it will start to auto-detect series and do its thing.    **** Please note as of Sept 2011 - you need to rerun with createNpvrTrigger again to fix an issue with a mismatch between guidePlus and NPVR!!.
to:
'''NPVR Trigger:''' GBPVR keeps an easily query-able record of all pending and completed recordings. Fields such as the unique program ID are used extensively by GuidePlus. However, NPVR drops this unique ID after the event is out of the program guide window, so GuidePlus can not reliably tell if a recording is a series or movie. To get around this, a new table and a trigger are created. This trigger will drop the guide data in a new table every time a recording is scheduled/created, allowing GuidePlus to go on its merry way. To have GuidePlus create the table and trigger, run GuidePlus once with the argument 'createNpvrTrigger'. As new recordings are added, it will start to auto-detect series and do its thing.    **** Please note: As of Sept 2011, you need to rerun with createNpvrTrigger again to fix an issue with a mismatch between guidePlus and NPVR!!
Changed line 44 from:
If the rename switch is on, it will also rename series files replacing npvr/gbpvr's date in the file name with the episode string and subtitle.  From ugly_betty_20090101_201010.mpg to ugly_betty.s03e05.i_found_a_cat.mpg.\\
to:
If the rename switch is on, it will also rename series files replacing NPVR/GBPVR's date in the file name with the episode string and subtitle.  For example, from ugly_betty_20090101_201010.mpg to ugly_betty.s03e05.i_found_a_cat.mpg.\\
Changed lines 46-47 from:
For GBPVR GuidePlus also regroups shows that have a series string at the start of the subtitle (eg s05e01) with other shows with the the same title.   This groups shows that have a * and no * so you don't have two series groups when you record older episodes, and also groups in episodes imported with vidImport assuming the Titles are the same and they have a series episode string using the s00e01 format.  This is helpful when you miss recording an episode and you d/l it from another source and wish it grouped with the rest.
to:
For GBPVR, GuidePlus also regroups shows that have a series string at the start of the subtitle (e.g. s05e01) with other shows with the the same title. This groups shows that have a '*' and no '*', so you don't have two series groups when you record older episodes, and also groups in episodes imported with vidImport assuming the Titles are the same and they have a series episode string using the s00e01 format. This is helpful when you miss recording an episode and you acquire it from another source and wish it to be grouped with the rest.
Changed lines 50-51 from:
GuidePlus will also move the shows files (and associated .edl, .txt, .xml) to one of two specified directories if desired.  If a seriesDir is specified all shows with a season string in the title (s00e00) will be moved to that directory (this means you need to run with renaming on to add the s00e00 to the file for this to work).  If movieDir is specified all shows that uniqueIDs do not start with "EP" will be moved to that directory.  The gbpvr/npvr directory will be updated to reflect these changes.  Bonus - if you put files on a separate file server guidePlus will send a wake on lan magic packet before doing the moves if specified.  Note guide info is not perfect so some series may end up in the movie folder as it is not correctly tagged in the guide.
to:
GuidePlus will also move the shows files (and associated .edl, .txt, .xml) to one of two specified directories if desired.  If a seriesDir is specified, all shows with a season string in the title (e.g. s00e00) will be moved to that directory. (This means you need to run with renaming on to add the s00e00 to the file for this to work). If movieDir is specified, all shows with uniqueIDs that do not start with "EP" will be moved to that directory. The GBPVR/NPVR directory will be updated to reflect these changes.  Bonus: if you put files on a separate file server, GuidePlus will send a Wake On LAN (WOL) magic packet before doing the moves if specified.  Note that guide info is not perfect, so some series may end up in the movie folder if they're not correctly tagged in the guide.
Changed line 56 from:
'''xmlout'''    = the altered guide file (don't use the same name)\\
to:
'''xmlout'''    = the altered guide file (don't use the same name as in 'xmlin')\\
Changed lines 64-65 from:
'''CreateNpvrTrigger'''  - optional, only needed once, explained above \\
to:
'''CreateNpvrTrigger'''  - optional, only needed once, explained above. \\
Changed lines 68-71 from:
Typical users will create an updateEpg.bat that uses at least two steps.  Step 1: invoke xmltv to download listings as an xml file from schedules direct.  Step 2: invoke guidePlus.exe to create an augmented .xml listings file.  Point to this file when configuring sources in the NextPVR settings dialog. \\
Xmltv can be downloaded from source forge.\\
Please note: to see the results the first time you need to empty the EPG since NextPVR doesn't update show descriptions that already exist in the database.
to:
Typical users will create an updateEpg.bat that uses at least two steps.  Step 1: invoke XMLTV to download listings as an XML file from Schedules Direct.  Step 2: invoke GuidePlus.exe to create an augmented .xml listings file.  Point to this file when configuring sources in the NextPVR settings dialog. \\
Xmltv can be downloaded from Sourceforge.\\
Please note: to see the results the first time, you need to empty the EPG since NextPVR doesn't update show descriptions that already exist in the database.
Changed lines 73-74 from:
'''Warning:''' guidePlus does not have a whole lot of error handling YMMV. Not sure how well it will work with non-English language filenames.
to:
'''Warning:''' GuidePlus does not have a whole lot of error handling, so YMMV. Not sure how well it will work with non-English language file names.
Changed lines 78-79 from:
Requires [[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en|Microsoft .NET Framework 3.5]] and SQLite dll (included in zip).
to:
Requires [[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en|Microsoft .NET Framework 3.5]] and SQLite .dll (included in zip).
Changed lines 81-83 from:
* Add a few command line switches or an ini file
* Include schedules direct download in utility\\
to:
* Add a few command line switches or an .ini file
* Include Schedules Direct download in utility\\
Changed lines 85-100 from:
.73 new trigger syntax to fix an issue due to a change in an NPVR table.  \\
.72 05.26.2011 - Fixed an issue where renamed recordings were getting listed as failed in the NPVR database
.71 05/05/2011 - Small bug fixes, added check for (US) in theTvdb.com lookups to improve accuracy, updated to latest sqlLite dll \\
.70 10/13/2010 - GuidePlus now extracts hidden metadata into <filename>.xml\\
.69 10/12/2010 - Fixed an issue where database entries were not being renamed when a file is moved\\
.68 10/11/2010 - Added NPVR compatibility stuff, ability to move files to series and movie directories, plus WOL\\
.65 04/06/2010 - Improved series lookups, improved lookup for series with multiple versions (ie battlestar (1978) vs. battlestar (2005)\\
.64 11/25/2009 - Fixed bug where gp was adding "The " to shows with names that have very short lengths
.61 5/18/2009 - Fixed bug where gp was writing multiple air dates to season descriptions\\
.60 4/20/2009 - Will now regroup shows with the same name and a subtitle starting with a series string\\
.58 4/19/2009 - Few more fixes with series - it adds a (us) to series search defaulting to U.S. based series first.  Added 2 new features (file rename and altering of exisiting recordings descriptions.)\\
.55 3/26/2009 - Fixed error handling shows with multiple runs (eg Battlestar Galactic (2008))\\
.5 12/18/2008 - Improved HTML special character handling\\
.4  12/17/2008 - Includes sqllite dll and reads GBPVR to get a list of shows that are recording - these shows are looked up on TVRage for seas/ep numbers\\
.3  12/11/2008 - Fixed bug reading history file\\
.2  11/30/2008 - First Version (beta)
to:
0.73 - new trigger syntax to fix an issue due to a change in an NPVR table.  \\
0.72 - 2011-05-26 - Fixed an issue where renamed recordings were getting listed as failed in the NPVR database
0.71 - 2011-05-05 - Small bug fixes, added check for (US) in theTvdb.com lookups to improve accuracy, updated to latest sqlLite dll \\
0.70 - 2010-10-13 - GuidePlus now extracts hidden metadata into <filename>.xml\\
0.69 - 2010-10-12 - Fixed an issue where database entries were not being renamed when a file is moved\\
0.68 - 2010-10-11 - Added NPVR compatibility stuff, ability to move files to series and movie directories, plus WOL\\
0.65 - 2010-04-06 - Improved series lookups, improved lookup for series with multiple versions (e.g. Battlestar Galactica (1978) vs. Battlestar Galactica (2005)\\
0.64 - 2009-11-25 - Fixed bug where GuidePlus was adding "The " to shows with names that have very short lengths
0.61 - 2009-05-18 - Fixed bug where GuidePlus was writing multiple air dates to season descriptions\\
0.60 - 2009-04-20 - GuidePlus now regroups shows with the same name and a subtitle starting with a series string\\
0.58 - 2009-04-19 - Few more fixes with series - GuidePlus now adds a (us) to series search defaulting to US-based series first.  Added two new features (file rename and altering of existing recordings descriptions.)\\
0.55 - 2009-03-26 - Fixed error handling shows with multiple runs (e.g. Battlestar Galactica (2008))\\
0.50 - 2008-12-18 - Improved HTML special character
handling\\
0.40 - 2008-12-17 - Includes sqllite dll and reads GBPVR to get a list of shows that are recording - these shows are looked up on TVRage for seas/ep numbers\\
0.30 - 2008-12-11 - Fixed bug reading history file\\
0.20 - 2008-11-30 - First Version (beta)
Changed line 18 from:
With series GuidePlus will do a lookup on manually specified series and on series that are pending recordings in GBPVR (for NPVR it will do this only if the NPVR trigger has been created - see NPVR trigger furter on in this doc) to add the season and episode number (with syntax sXeY) to the subtitle of a TV series.  It saves lookups in showDetail.txt (in your GBPVR dir) to save time and internet traffic later.  This file is also where you must put the title of the series you want episode information for it if its not a pending or existing recording. The syntax is as follows for this file. (in other words use a text editor to add to it.) 
to:
With series listings GuidePlus will do a lookup on manually specified series and on series that are pending recordings in GBPVR (for NPVR it will do this only if the NPVR trigger has been created - see NPVR trigger further on in this doc) to add the season and episode number (with syntax sXeY) to the subtitle of a TV series.  It saves lookups in showDetail.txt (in your GBPVR dir) to save time and internet traffic later.  This file is also where you must put the title of the series you want episode information for it if its not a pending or existing recording. The syntax is as follows for this file. (in other words use a text editor to add to it.) 
Changed line 27 from:
GuidePlus adds a * at the end of the title, if it is new (aired within 3 days), prepends the original air date to the description and if the description of the episode on TVRage is larger than that from he XML file it will replace it with the longer description. \\
to:
GuidePlus also adds a * at the end of the title if it is a new episode(aired within 3 days of its first air date), prepends the original air date to the description and if the description of the episode on TVRage/TvDb is larger than that from the XML file it will replace it with the longer description. \\
Changed line 78 from:
Requires [[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en|Microsoft .NET Framework 3.5]] and SQLite dll (included in zip)
to:
Requires [[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en|Microsoft .NET Framework 3.5]] and SQLite dll (included in zip).
Deleted lines 0-3:
(:comment UNCOMMENT THE LINE BELOW IF THIS IS THE MAIN PAGE FOR A UTILITY:)
(:comment Category:[[!Utility]] :)

Changed line 5 from:
* First its a guide enhancer: it takes a schedules direct XML file (may work with other XML guides as well) and writes a new XML file with several enhancements for N/GBPVR
to:
* First its a guide enhancer: it takes a schedules direct XML file (may work with other XML guides as well) and writes a new XML file with several enhancements for NextPVR
Changed line 7 from:
* Third it is a file mover: it moves series and movies into their own directories (on any location on your network) while updating the gbpvr/npvr database.
to:
* Third it is a file mover: it moves series and movies into their own directories (on any location on your network) while updating the NextPVR database.
Changed lines 36-37 from:
!! First use with NPVR requirements
to:
!! First use with NextPVR requirements
Changed line 68 from:
Typical users will create an updateEpg.bat that uses at least two steps.  Step 1: invoke xmltv to download listings as an xml file from schedules direct.  Step 2: invoke guidePlus.exe to create an augmented .xml listings file.  Point to this file when configuring sources in the GBPVR config app. \\
to:
Typical users will create an updateEpg.bat that uses at least two steps.  Step 1: invoke xmltv to download listings as an xml file from schedules direct.  Step 2: invoke guidePlus.exe to create an augmented .xml listings file.  Point to this file when configuring sources in the NextPVR settings dialog. \\
Changed lines 70-71 from:
Please note: to see the results the first time you need to empty the EPG since GBPVR doesn't update show descriptions that already exist in the database.
to:
Please note: to see the results the first time you need to empty the EPG since NextPVR doesn't update show descriptions that already exist in the database.
Changed lines 73-74 from:
'''Warning:''' guidePlus does not have a whole lot of error handling YMMV. Not sure how well it will work with non-english language filenames.
to:
'''Warning:''' guidePlus does not have a whole lot of error handling YMMV. Not sure how well it will work with non-English language filenames.
Changed lines 76-81 from:
'-(Version .72)-'
Download:guidePlus.
zip\\
Requires
.net 3.5: http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en \\
Requires sqlite dll (included in
zip)

!! Possible To Do's
to:
Download:guidePlus.zip (DownloadCount:guidePlus.zip downloads)

Requires [[
http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en|Microsoft .NET Framework 3.5]] and SQLite dll (included in zip)

!! Possible ToDo's
Deleted line 83:
Changed lines 100-102 from:
.2  11/30/2008 - First Version (beta)\\

to:
.2  11/30/2008 - First Version (beta)
Deleted line 103:
Changed lines 77-80 from:
'''Warning'''
 
guidePlus does not have a whole lot of error handling YMMV.  Not sure how well it will work with non-english language filenames.

!! Download :
to:
'''Warning:''' guidePlus does not have a whole lot of error handling YMMV. Not sure how well it will work with non-english language filenames.

!! Download
Changed line 42 from:
'''Npvr trigger:''' GBPVR keeps an easily query-able record of all pending and completed recordings.  Fields such as the unique program ID are easily query-able - GuidePlus uses this field extensively. Npvr drops this unique ID after the event is out of the program guide window so guidePlus can not reliably tell if a recording is a series or movie.  So I created a new table and a trigger, this trigger will drop the guide data in a new table every time a recording is scheduled/created allowing guidePlus to go on its merry way.  To have guidePlus create the table and trigger run guidePlus once with the argument createNpvrTrigger.  As new recordings are added it will start to auto-detect series and do its thing
to:
'''Npvr trigger:''' GBPVR keeps an easily query-able record of all pending and completed recordings.  Fields such as the unique program ID are easily query-able - GuidePlus uses this field extensively. Npvr drops this unique ID after the event is out of the program guide window so guidePlus can not reliably tell if a recording is a series or movie.  So I created a new table and a trigger, this trigger will drop the guide data in a new table every time a recording is scheduled/created allowing guidePlus to go on its merry way.  To have guidePlus create the table and trigger run guidePlus once with the argument createNpvrTrigger.  As new recordings are added it will start to auto-detect series and do its thing.    **** Please note as of Sept 2011 - you need to rerun with createNpvrTrigger again to fix an issue with a mismatch between guidePlus and NPVR!!.
Added line 92:
.73 new trigger syntax to fix an issue due to a change in an NPVR table.  \\
May 27, 2011, at 12:58 PM by carpeVideo -
Changed line 81 from:
'-(Version .71)-'
to:
'-(Version .72)-'
May 27, 2011, at 12:55 PM by carpeVideo -
Added line 92:
.72 05.26.2011 - Fixed an issue where renamed recordings were getting listed as failed in the NPVR database
May 05, 2011, at 01:29 PM by carpeVideo -
Changed line 92 from:
.71 05/05/2011 - Small bug fixes, added check for (US) in theTvtb.com lookups to improve accuracy, updated to latest sqlLite dll
to:
.71 05/05/2011 - Small bug fixes, added check for (US) in theTvdb.com lookups to improve accuracy, updated to latest sqlLite dll \\
May 05, 2011, at 01:24 PM by carpeVideo -
Changed line 92 from:
.71 05/05/2011 - Small bug fixes - add check for (US) in theTvtb.com lookups to improve accuracy
to:
.71 05/05/2011 - Small bug fixes, added check for (US) in theTvtb.com lookups to improve accuracy, updated to latest sqlLite dll
May 05, 2011, at 01:23 PM by carpeVideo -
Changed line 81 from:
'-(Version .70)-'
to:
'-(Version .71)-'
Added line 92:
.71 05/05/2011 - Small bug fixes - add check for (US) in theTvtb.com lookups to improve accuracy
Changed lines 9-11 from:
* First its a guide enhancer: it takes a schedules direct XML file (may work with other XML guides as well) and writes a new XML file with several enhancements for N/GBPVR.  \\
* Second it is a file renamer: if shows have season/episode tags it groups those shows and renames the file of a show to include season episode info and episode title.\\
* Third it is a file mover: it moves series and movies into their own directories (on any location on your network) while updating the gbpvr/npvr database. \\
to:
* First its a guide enhancer: it takes a schedules direct XML file (may work with other XML guides as well) and writes a new XML file with several enhancements for N/GBPVR. 
* Second it is a file renamer: if shows have season/episode tags it groups those shows and renames the file of a show to include season episode info and episode title.
* Third it is a file mover: it moves series and movies into their own directories (on any location on your network) while updating the gbpvr/npvr database.
Added line 8:
Added line 38:
Added lines 38-39:
!! First use with NPVR requirements
Changed lines 3-5 from:
----
Category:[[!Utility]]

to:

Deleted lines 106-107:
[[!GBPVR_v1_2_9]], [[!GBPVR_v1_2_13]], [[!GBPVR_v1_3_7]]
Changed line 108 from:
Categories:  [[!EPG]] [[!XMLTV]] [[!Enhancer]]
to:
Category:[[!Utility]]
Added lines 3-5:
----
Category:[[!Utility]]

Added lines 1-108:
(:comment UNCOMMENT THE LINE BELOW IF THIS IS THE MAIN PAGE FOR A UTILITY:)
(:comment Category:[[!Utility]] :)
!! Overview
Guide plus is yet another guide enhancer with several extra features. \\
\\
* First its a guide enhancer: it takes a schedules direct XML file (may work with other XML guides as well) and writes a new XML file with several enhancements for N/GBPVR.  \\
* Second it is a file renamer: if shows have season/episode tags it groups those shows and renames the file of a show to include season episode info and episode title.\\
* Third it is a file mover: it moves series and movies into their own directories (on any location on your network) while updating the gbpvr/npvr database. \\
\\
Guide plus does everything when you run your nightly epg update.  This means that files will not be renamed or relocated immediately after they are recorded which is a slight disadvantage.  However, guidePlus will do its thing (renaming, moving) for all files in the database, not just those recently created which is a great advantage.  Have 300 recordings of series you would like renamed, run guidePlus!
\\

!! Guide Enhancement

GuidePlus enhances guide information for both movies and series.
\\
With movie listings GuidePlus will add the year it was made, the star rating (as (4+)), and if it is new to the guide (meaning its likely the first time this movie was released on the air/cable) it adds (new).  It knows it is new to the guide by creating a guideHistory.txt (in your GBPVR dir) where it records every movie its seen in a guide file that is less than 2 years old.\\\
'''''Example movie result:''''' Raiders of the Lost Ark (2002)(4+)(new)\\\
With series GuidePlus will do a lookup on manually specified series and on series that are pending recordings in GBPVR (for NPVR it will do this only if the NPVR trigger has been created - see NPVR trigger furter on in this doc) to add the season and episode number (with syntax sXeY) to the subtitle of a TV series.  It saves lookups in showDetail.txt (in your GBPVR dir) to save time and internet traffic later.  This file is also where you must put the title of the series you want episode information for it if its not a pending or existing recording. The syntax is as follows for this file. (in other words use a text editor to add to it.) 
\\
SHOWFILE~~1.0}}  \\
NEWSHOW~~Burn Notice~~2008~~n/a~~1}}\\
NEWSHOW~~Ugly Betty~~2006~~n/a~~3}}\\
\\
Just use any year and number for the year entry and seasons entry it will get corrected by guidePlus later.  To save time and bandwidth guidePlus ONLY does series lookups on series with their titles in this file and on series that are pending/existing recordings.  If a series has been cancelled it will only do the lookup once.  If it is active it will only do the lookup if the air date of an episode in the guide is greater than that in the showDetail.txt file (skipping internet updates when a show is dormant for a long period)
\\
\\
GuidePlus adds a * at the end of the title, if it is new (aired within 3 days), prepends the original air date to the description and if the description of the episode on TVRage is larger than that from he XML file it will replace it with the longer description. \\
\\
'''Example series result:'''  Title="Ugly Betty*"  subtitle="s1e4: the one where betty isn't ugly"  description="2009-01-03 A long description of Betty"
\\
\\
GuidePlus will alter GBPVR database entries of existing recordings as above the with episode number and air date.  This is necessary since shows already recorded will keep their data despite new information from a guide update.\\
\\
\\
'''Npvr trigger:''' GBPVR keeps an easily query-able record of all pending and completed recordings.  Fields such as the unique program ID are easily query-able - GuidePlus uses this field extensively. Npvr drops this unique ID after the event is out of the program guide window so guidePlus can not reliably tell if a recording is a series or movie.  So I created a new table and a trigger, this trigger will drop the guide data in a new table every time a recording is scheduled/created allowing guidePlus to go on its merry way.  To have guidePlus create the table and trigger run guidePlus once with the argument createNpvrTrigger.  As new recordings are added it will start to auto-detect series and do its thing
\\
\\

!! Renaming

If the rename switch is on, it will also rename series files replacing npvr/gbpvr's date in the file name with the episode string and subtitle.  From ugly_betty_20090101_201010.mpg to ugly_betty.s03e05.i_found_a_cat.mpg.\\
\\
For GBPVR GuidePlus also regroups shows that have a series string at the start of the subtitle (eg s05e01) with other shows with the the same title.  This groups shows that have a * and no * so you don't have two series groups when you record older episodes, and also groups in episodes imported with vidImport assuming the Titles are the same and they have a series episode string using the s00e01 format.  This is helpful when you miss recording an episode and you d/l it from another source and wish it grouped with the rest.

!! File relocation

GuidePlus will also move the shows files (and associated .edl, .txt, .xml) to one of two specified directories if desired.  If a seriesDir is specified all shows with a season string in the title (s00e00) will be moved to that directory (this means you need to run with renaming on to add the s00e00 to the file for this to work).  If movieDir is specified all shows that uniqueIDs do not start with "EP" will be moved to that directory.  The gbpvr/npvr directory will be updated to reflect these changes.  Bonus - if you put files on a separate file server guidePlus will send a wake on lan magic packet before doing the moves if specified.  Note guide info is not perfect so some series may end up in the movie folder as it is not correctly tagged in the guide.

!! Usage

guidePlus.exe <xmlin=""> <xmlout="">  [showfile=""]  [history=""] [rename=On|Off] [repeat=""] [movieDir=""] [seriesDir=""] [wol=""]\\
'''xmlin'''  = the guide file you start with.\\
'''xmlout'''    = the altered guide file (don't use the same name)\\
'''showfile'''  = your showDetail file - optional, defaults to (gbpvr dir)\showDetail.txt.\\
'''history'''  = your history file - optional, defaults to (gbpvr dir)\guideHistory.txt.\\
'''rename'''    = [yes|no] - if yes, renames the files of series appending s00e00.subtitle - optional defaults to no\\
'''repeat'''    = [string] - character used to indicate repeats - optional defaults blank\\
'''movieDir'''  = [directory] - optional if included files the unique series IDs start with MV will be moved here\\
'''seriesDir''' = [directory] - optional if included files the unique series IDs start with EP will be moved here\\
'''wol'''      = [max address] - optional if included a wol magic packet will be sent before any renames or moves \\
'''CreateNpvrTrigger'''  - optional, only needed once, explained above \\

\\
\\
Typical users will create an updateEpg.bat that uses at least two steps.  Step 1: invoke xmltv to download listings as an xml file from schedules direct.  Step 2: invoke guidePlus.exe to create an augmented .xml listings file.  Point to this file when configuring sources in the GBPVR config app. \\
Xmltv can be downloaded from source forge.\\
Please note: to see the results the first time you need to empty the EPG since GBPVR doesn't update show descriptions that already exist in the database.

!! Behavior
'''Warning'''
 guidePlus does not have a whole lot of error handling YMMV.  Not sure how well it will work with non-english language filenames.

!! Download :
'-(Version .70)-'
Download:guidePlus.zip\\
Requires .net 3.5: http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en \\
Requires sqlite dll (included in zip)

!! Possible To Do's
* Add a few command line switches or an ini file
* Include schedules direct download in utility\\


!! Version(s) / History
.70 10/13/2010 - GuidePlus now extracts hidden metadata into <filename>.xml\\
.69 10/12/2010 - Fixed an issue where database entries were not being renamed when a file is moved\\
.68 10/11/2010 - Added NPVR compatibility stuff, ability to move files to series and movie directories, plus WOL\\
.65 04/06/2010 - Improved series lookups, improved lookup for series with multiple versions (ie battlestar (1978) vs. battlestar (2005)\\
.64 11/25/2009 - Fixed bug where gp was adding "The " to shows with names that have very short lengths
.61 5/18/2009 - Fixed bug where gp was writing multiple air dates to season descriptions\\
.60 4/20/2009 - Will now regroup shows with the same name and a subtitle starting with a series string\\
.58 4/19/2009 - Few more fixes with series - it adds a (us) to series search defaulting to U.S. based series first.  Added 2 new features (file rename and altering of exisiting recordings descriptions.)\\
.55 3/26/2009 - Fixed error handling shows with multiple runs (eg Battlestar Galactic (2008))\\
.5 12/18/2008 - Improved HTML special character handling\\
.4  12/17/2008 - Includes sqllite dll and reads GBPVR to get a list of shows that are recording - these shows are looked up on TVRage for seas/ep numbers\\
.3  12/11/2008 - Fixed bug reading history file\\
.2  11/30/2008 - First Version (beta)\\


!!Author(s)
[[~carpeVideo]]


[[!GBPVR_v1_2_9]], [[!GBPVR_v1_2_13]], [[!GBPVR_v1_3_7]]

----
Categories:  [[!EPG]] [[!XMLTV]] [[!Enhancer]]

Page last modified on May 11, 2013, at 04:39 PM