Difference between revisions of "Mythfilldatabase"
(→1. Obtain xml file of tv guide) |
(→Run mythfilldatabase with the --file flag) |
||
(28 intermediate revisions by 10 users not shown) | |||
Line 4: | Line 4: | ||
= Automatic use of mythfilldatabase = | = Automatic use of mythfilldatabase = | ||
− | Normally mythfilldatabase is run automatically by [[mythbackend]] every 24 hours | + | Normally mythfilldatabase is run automatically by [[mythbackend]] every 24 hours. For most people allowing mythfilldatabase to run automatically will be sufficient, however in areas with no XMLTV grabber or an unusual channel setup it may be run manually. |
= Manual use of mythfilldatabase = | = Manual use of mythfilldatabase = | ||
+ | To run an extra time out of sequence (for example, because your subscription had run out, and you just renewed it), use no command line options: | ||
+ | mythfilldatabase | ||
== Command line options == | == Command line options == | ||
− | -- | + | <pre> |
− | :Run | + | $ mythfilldatabase --help |
+ | mythfilldatabase version: fixes/0.25 [v0.25-100-gb5b4c48] www.mythtv.org | ||
+ | Misc. Options: | ||
+ | --dd-file Bypass grabber, and read SD data from file | ||
+ | --lineupid DataDirect lineup of input xml file | ||
+ | --offset Day offset of input xml file | ||
+ | --xmlfile XML file to import manually | ||
+ | --dd-grab-all refresh full data using DataDirect | ||
+ | --file Bypass grabbers and define sourceid and file | ||
+ | --xmlfile XML file to import manually | ||
+ | --manual Run interactive configuration | ||
+ | --no-mark-repeats do not mark repeats | ||
+ | --preset Use channel preset values instead of numbers | ||
+ | -h OR --help OR --usage Display this help printout, or give detailed | ||
+ | information of selected option. | ||
+ | --version Display version information. | ||
+ | --sourceid Operate on single source | ||
+ | --update Run non-destructive updates | ||
+ | --xawchannels Read channels from xawtvrc file | ||
+ | --xawtvrcfile xawtvrc file to import channels from | ||
− | -- | + | Channel List Handling Options: |
− | + | --do-channel-updates update channels using datadirect | |
− | + | --do-not-filter-new-channels don't filter ATSC channels for addition | |
− | + | --only-update-channels only update channel lineup | |
− | + | --remove-new-channels disable new channels on datadirect web interface | |
− | -- | + | Filtering Options: |
− | + | --dont-refresh-tba don't refresh "To be announced" programs | |
+ | --max-days force number of days to update | ||
+ | --refresh Provide a day or range of days to refresh. Can | ||
+ | be used repeatedly. | ||
− | -- | + | Channel Icon Handling Options: |
− | + | --export-icon-map export icon map to file | |
+ | --import-icon-map import icon map to file | ||
+ | --reset-icon-map resets icon maps | ||
+ | --update-icon-map updates icon map icons | ||
− | -- | + | Logging Options: |
− | : | + | --loglevel Set the logging level. All log messages at |
+ | lower levels will be discarded. | ||
+ | In descending order: emerg, alert, crit, err, | ||
+ | warning, notice, info, debug | ||
+ | defaults to info | ||
+ | --logpath Writes logging messages to a file in the | ||
+ | directory logpath with filenames in the format: | ||
+ | applicationName.date.pid.log. | ||
+ | This is typically used in combination with | ||
+ | --daemon, and if used in combination with | ||
+ | --pidfile, this can be used with log rotators, | ||
+ | using the HUP call to inform MythTV to reload | ||
+ | the file | ||
+ | --nodblog Disable database logging. | ||
+ | -q OR --quiet Don't log to the console (-q). Don't log | ||
+ | anywhere (-q -q) | ||
+ | --syslog Set the syslog logging facility. | ||
+ | Set to "none" to disable, defaults to none. | ||
+ | -v OR --verbose Specify log filtering. Use '-v help' for level | ||
+ | info. | ||
− | + | </pre> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== External XMLTV == | == External XMLTV == | ||
If you are in a country where mythfilldatabase will not work the normal way you will need to use the --file flag (e.g. XMLTV does not have a grabber included, or the grabber options are not fully supported by MythTV). | If you are in a country where mythfilldatabase will not work the normal way you will need to use the --file flag (e.g. XMLTV does not have a grabber included, or the grabber options are not fully supported by MythTV). | ||
− | === | + | === Obtain xml file of tv guide === |
Here in Belgium, I use [http://pytvgrab.sourceforge.net pytvgrab] to get my tv guide and output to an xml file: | Here in Belgium, I use [http://pytvgrab.sourceforge.net pytvgrab] to get my tv guide and output to an xml file: | ||
Line 102: | Line 87: | ||
</nowiki></pre> | </nowiki></pre> | ||
− | + | === Find out the source id of your card === | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | === | ||
This is normally '1' if you have only one input card, but it is best to check it out because I have found if I have run mythtv setup more than once it can end up being something other than 1. To check, you need to look at the database: | This is normally '1' if you have only one input card, but it is best to check it out because I have found if I have run mythtv setup more than once it can end up being something other than 1. To check, you need to look at the database: | ||
Line 129: | Line 102: | ||
Remember the source id | Remember the source id | ||
− | === | + | === Run mythfilldatabase with the --file flag === |
− | The --file argument allows to directly import | + | The --file argument allows to directly import XMLTV files. This is useful if you are using programs like [http://nxtvepg.sourceforge.net/ nxtvepg] to grab your EPG data. |
− | + | Note that Schedules Direct members should not use the <code>--file</code> argument with mythfilldatabase. They should instead use --dd-file with data obtained by running <code>tv_grab_na_dd</code> using the <code>--dd-data</code> argument. | |
− | |||
− | |||
− | < | ||
− | |||
− | </ | ||
'''From 0.21 on:''' | '''From 0.21 on:''' | ||
Line 147: | Line 115: | ||
</nowiki></pre> | </nowiki></pre> | ||
− | + | '''From 0.25 on:''' | |
− | + | From version 0.25, the arguments of this command changed: | |
− | + | <pre><nowiki> | |
− | + | $ mythfilldatabase --file --sourceid <sourceid> --xmlfile belgium.xml | |
− | + | </nowiki></pre> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | The first time you will need to use the --manual flag, but this is better explained on the [[XMLTV]] page. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | = Troubleshooting = | |
− | |||
− | === | + | === mythfilldatabase causes the system to hang=== |
This is probably an I/O saturation issue. mythfilldatabase and [[MySQL]] can cause hard disk or ATA bus saturation, causing [[Mythbackend]] to starve. Read more about [[Troubleshooting:Mythfilldatabase_IO_bottleneck]]. | This is probably an I/O saturation issue. mythfilldatabase and [[MySQL]] can cause hard disk or ATA bus saturation, causing [[Mythbackend]] to starve. Read more about [[Troubleshooting:Mythfilldatabase_IO_bottleneck]]. | ||
− | |||
− | + | [[Category:MythTV_Software]] | |
− |
Revision as of 20:46, 2 January 2013
Cleanup: This article or section may require cleanup. Discuss the issue on the talk page
Note: The correct title of this article is mythfilldatabase. It appears incorrectly here due to technical restrictions.
mythfilldatabase fills the Myth database program table with upcoming shows.
Automatic use of mythfilldatabase
Normally mythfilldatabase is run automatically by mythbackend every 24 hours. For most people allowing mythfilldatabase to run automatically will be sufficient, however in areas with no XMLTV grabber or an unusual channel setup it may be run manually.
Manual use of mythfilldatabase
To run an extra time out of sequence (for example, because your subscription had run out, and you just renewed it), use no command line options:
mythfilldatabase
Command line options
$ mythfilldatabase --help mythfilldatabase version: fixes/0.25 [v0.25-100-gb5b4c48] www.mythtv.org Misc. Options: --dd-file Bypass grabber, and read SD data from file --lineupid DataDirect lineup of input xml file --offset Day offset of input xml file --xmlfile XML file to import manually --dd-grab-all refresh full data using DataDirect --file Bypass grabbers and define sourceid and file --xmlfile XML file to import manually --manual Run interactive configuration --no-mark-repeats do not mark repeats --preset Use channel preset values instead of numbers -h OR --help OR --usage Display this help printout, or give detailed information of selected option. --version Display version information. --sourceid Operate on single source --update Run non-destructive updates --xawchannels Read channels from xawtvrc file --xawtvrcfile xawtvrc file to import channels from Channel List Handling Options: --do-channel-updates update channels using datadirect --do-not-filter-new-channels don't filter ATSC channels for addition --only-update-channels only update channel lineup --remove-new-channels disable new channels on datadirect web interface Filtering Options: --dont-refresh-tba don't refresh "To be announced" programs --max-days force number of days to update --refresh Provide a day or range of days to refresh. Can be used repeatedly. Channel Icon Handling Options: --export-icon-map export icon map to file --import-icon-map import icon map to file --reset-icon-map resets icon maps --update-icon-map updates icon map icons Logging Options: --loglevel Set the logging level. All log messages at lower levels will be discarded. In descending order: emerg, alert, crit, err, warning, notice, info, debug defaults to info --logpath Writes logging messages to a file in the directory logpath with filenames in the format: applicationName.date.pid.log. This is typically used in combination with --daemon, and if used in combination with --pidfile, this can be used with log rotators, using the HUP call to inform MythTV to reload the file --nodblog Disable database logging. -q OR --quiet Don't log to the console (-q). Don't log anywhere (-q -q) --syslog Set the syslog logging facility. Set to "none" to disable, defaults to none. -v OR --verbose Specify log filtering. Use '-v help' for level info.
External XMLTV
If you are in a country where mythfilldatabase will not work the normal way you will need to use the --file flag (e.g. XMLTV does not have a grabber included, or the grabber options are not fully supported by MythTV).
Obtain xml file of tv guide
Here in Belgium, I use pytvgrab to get my tv guide and output to an xml file:
$ tv_grab_be_tvb --configure (you only need this the first time) $ tv_grab_be_tvb -o belgium.xml
Find out the source id of your card
This is normally '1' if you have only one input card, but it is best to check it out because I have found if I have run mythtv setup more than once it can end up being something other than 1. To check, you need to look at the database:
$ mysql -u root mythconverg mysql> select * from cardinput\G cardinputid cardid sourceid=4 etc.
Remember the source id
Run mythfilldatabase with the --file flag
The --file argument allows to directly import XMLTV files. This is useful if you are using programs like nxtvepg to grab your EPG data.
Note that Schedules Direct members should not use the --file
argument with mythfilldatabase. They should instead use --dd-file with data obtained by running tv_grab_na_dd
using the --dd-data
argument.
From 0.21 on:
From version 0.21 on the arguments of this command changed. The offset argument has been removed and the command changed to:
$ mythfilldatabase --file <sourceid> belgium.xml
From 0.25 on:
From version 0.25, the arguments of this command changed:
$ mythfilldatabase --file --sourceid <sourceid> --xmlfile belgium.xml
The first time you will need to use the --manual flag, but this is better explained on the XMLTV page.
Troubleshooting
mythfilldatabase causes the system to hang
This is probably an I/O saturation issue. mythfilldatabase and MySQL can cause hard disk or ATA bus saturation, causing Mythbackend to starve. Read more about Troubleshooting:Mythfilldatabase_IO_bottleneck.