Timers and Timer Rules

###HDHomeRun DVR Service Recording Rules and Limitations The HDHomeRun DVR Service provides DVR functionality via a mechanism called Recording Rules. There are two basic types of Recording Rules:

• Series Rules - Flag a specific series to be recorded
• Date/Time Only Rules - Flag an individual episode of a series to be recorded

All DVR Service Recording Rules must be associated with a specific series; there is no means to schedule a recording based on just a date and time (Kodi: Manual Timer). This requirement limits how Recording Rules can be added, a front end application like Kodi must be able to match all Recording Rule requests to a specific series.

The DVR Service is able to provide information about an individual series, up to 2 weeks into the future, that lists all episodes of the series that will be aired and flags which episodes match an existing Recording Rule.  The DVR Service does not, however, normalize those flags against the rules that will be applied by the HDHomeRun RECORD storage engine.  As an example if the RECORD engine has already recorded an episode of a series by default it will not record it again. There is currently no way for a client application like Kodi to discern what the RECORD engine actually intends to do.  This limitation is frustrating as the front end can only report on episodes that might be recorded.

###Existing Recording Rules This PVR Client exposes existing DVR Service Recording Rules as Kodi Timer Rules. There are two types of Timer Rules:

• Record Series Rule - Timer Rule based on a DVR Service Series Rule
• Record Once Rule - Timer Rule based on a DVR Service Date/Time Only Rule

Record Series Rules are editable; you can set a specific channel, set if only new or recent episodes should record, and apply start and end padding time to each recording. You can also delete Record Series Rules.

Record Once Rules cannot be edited or directly deleted, they can only be viewed.  To remove a Record Once rule, the scheduled episode must be deleted instead.  This limitation is partially due to how Kodi handles Timer Rules in that there is no means to display a date/time selector but also due to the DVR service requirement that a series be associated with all Recording Rules -- even if Kodi allowed the date/time selector there would still need to be a way to associate the updated date/time with a series.

TODO: THIS PAGE IS INCOMPLETE