Changes between Version 73 and Version 74 of FAQ


Ignore:
Timestamp:
09/30/13 18:44:07 (3 years ago)
Author:
max
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • FAQ

    v73 v74  
    2222The [wiki:shepherd_logic] wiki page contains a more complete technical description of the various stages of Shepherd and how it works. 
    2323 
     24By default, Shepherd prints the EPG to STDOUT and to the file ''~/.shepherd/output.xmltv''. 
    2425 
    2526=== How can I get help or ask a few questions? === 
     
    7980=== Is there a log file somewhere? === 
    8081Yes, in the ''log/'' subdirectory of your Shepherd installation (usually ''~/.shepherd/log/''). 
    81  
    82  
    83 === What is autorefresh? === 
    84 When it's been more than 4 hours but less than 22 hours since the last run, Shepherd will switch into autorefresh mode, gathering data for the current day only. It will output the result via STDOUT, as usual, and create the file ~/.shepherd/refresh.xmltv. This allows Shepherd to catch last-minute schedule changes. It tends to complete very quickly (for Shepherd), since even the slower grabbers are usually able to quickly verify if there have been any time or title changes since they last ran. 
    85  
    86 If you don't wish Shepherd to enter autorefresh mode, send the --noautorefresh option. 
    87  
    88 Shepherd will '''not''' enter autorefresh mode if you specify a number of --days, since this would require overriding your preference. But if you are happy for Shepherd to override it during autorefreshes only, send --allowautorefresh. 
    89  
    90 Autorefresh does not touch the default output.xmltv file, so functions such as '''--refill-mythtv''' will use your last full successful run, not any subsequent autorefresh. You may wish to override this if you want to be able to rely on output.xmltv always containing the latest data, regardless of whether it's a single day's data or a week's. If so, use '''--output'''. For example, to always output into output.xmltv, even autorefreshes: 
    91 {{{ 
    92 tv_grab_au --output ~/.shepherd/output.xmltv 
    93 }}} 
    94 In that case, you would probably want to set it as a default option, i.e.: 
    95 {{{ 
    96 tv_grab_au --component-set shepherd:output=output.xmltv 
    97 }}} 
    98 Or to refill MythTV will the latest autorefresh data, rather than the latest full run: 
    99 {{{ 
    100 tv_grab_au --refill-mythtv --output ~/.shepherd/refresh.xmltv 
    101 }}} 
    10282 
    10383 
     
    272252{{{ 
    273253tv_grab_au --grabwith oztivo,sbsnews_website 
     254}}} 
     255 
     256 
     257=== What is autorefresh? === 
     258When it's been more than 4 hours but less than 22 hours since the last run, Shepherd will switch into autorefresh mode, gathering data for the current day only. It will output the result via STDOUT, as usual, and create the file ~/.shepherd/refresh.xmltv. This allows Shepherd to catch last-minute schedule changes. It tends to complete very quickly (for Shepherd), since even the slower grabbers are usually able to quickly verify if there have been any time or title changes since they last ran. 
     259 
     260If you don't wish Shepherd to enter autorefresh mode, send the --noautorefresh option. 
     261 
     262Shepherd will '''not''' enter autorefresh mode if you specify a number of --days, since this would require overriding your preference. But if you are happy for Shepherd to override it during autorefreshes only, send --allowautorefresh. 
     263 
     264Autorefresh does not touch the default output.xmltv file, so functions such as '''--refill-mythtv''' will use your last full successful run, not any subsequent autorefresh. You may wish to override this if you want to be able to rely on output.xmltv always containing the latest data, regardless of whether it's a single day's data or a week's. If so, use '''--output'''. For example, to always output into output.xmltv, even autorefreshes: 
     265{{{ 
     266tv_grab_au --output ~/.shepherd/output.xmltv 
     267}}} 
     268In that case, you would probably want to set it as a default option, i.e.: 
     269{{{ 
     270tv_grab_au --component-set shepherd:output=output.xmltv 
     271}}} 
     272Or to refill MythTV will the latest autorefresh data, rather than the latest full run: 
     273{{{ 
     274tv_grab_au --refill-mythtv --output ~/.shepherd/refresh.xmltv 
    274275}}} 
    275276