Fill empty guide (XEPG) slots with dummy 'unknown' entries

[continue]

Summary

This PR implements a new configurable feature to fill empty slots in the EPG/XEPG guide with dummy 'Unknown' program entries, addressing issue #2.

Background

This is a workaround for Plex, which requires guide data to be present for all time slots to allow viewing channels. When EPG data is incomplete or has gaps, channels become unwatchable in Plex.

Changes

• Added new setting: xepg.fill.gaps.with.dummy (default: false)

  • Disabled by default to maintain backward compatibility
  • Can be enabled via settings API or configuration

• Gap Detection Logic: Implemented fillProgramGaps() function that:

  • Sorts programs by start time
  • Detects gaps between programs
  • Fills gaps from current time up to 4 days ahead
  • Handles initial gaps (before first program)
  • Handles gaps between programs
  • Handles trailing gaps (after last program)

• Dummy Entry Generation: Implemented createUnknownPrograms() that:

  • Creates 3-hour time slot entries for gaps
  • Uses format: "Channel Name: Unknown" as title
  • Includes description: "No program information available for this time slot."
  • Optionally includes channel logo (when XepgReplaceMissingImages is enabled)

Configuration

To enable this feature, set the following in your settings:

{
  "xepg.fill.gaps.with.dummy": true
}

Related Issues

Closes #2
Related to xteve-project#161

Testing Notes

• Feature is disabled by default, ensuring no impact on existing installations
• When enabled, gaps in EPG data are automatically filled with dummy entries
• Dummy entries are clearly labeled as "Unknown" to distinguish from real program data
• Time slots are 3 hours by default to minimize the number of dummy entries

Co-authored-by: geoff-thornton github@geoffthornton.me

---

Continue Tasks: ▶️ 1 queued — View all