mirror of
https://github.com/Dispatcharr/Dispatcharr.git
synced 2026-01-23 10:45:27 +00:00
This enhancement introduces a powerful custom dummy EPG system that allows users to generate EPG programs on-demand by parsing channel or stream names using configurable regex patterns.
Key Features:
- Custom Pattern Matching: Define regex patterns to extract information from channel/stream names (teams, leagues, times, dates, etc.)
- Flexible Name Source: Choose to parse either the channel name or a specific stream name (by index)
- Timezone-Aware Scheduling: Automatic DST handling using pytz timezone names (e.g., 'US/Eastern', 'Europe/London')
- Time Format Support: Parse both 12-hour (AM/PM) and 24-hour time formats
- Date Parsing: Extract dates from names with flexible month/day/year patterns
- Custom Templates: Format EPG titles and descriptions using captured groups with {placeholder} syntax
- Upcoming/Ended Customization: Define custom titles and descriptions for programs before and after scheduled events
- Live Preview: Test patterns and templates in real-time with sample input
- Smart Program Generation: Automatically creates "Upcoming" and "Ended" programs around scheduled events
Use Cases:
- Sports channels with event details in stream names (e.g., "NHL 01: Bruins VS Leafs @ 8:00PM ET")
- Movie channels with genre/title/year information
- Racing events with driver/track/series details
- Any scenario where EPG data is embedded in channel/stream naming conventions
Technical Implementation:
- Backend: Pattern matching engine with timezone conversion and program scheduling logic
- Frontend: Interactive form with validation, pattern testing, and visual group preview
- Name Source Options: Parse from channel name or selectable stream index (1-based)
- Fallback Behavior: Uses standard dummy EPG if patterns don't match
- Custom Properties: Stores all configuration in EPGSource.custom_properties JSON field
Configuration Options:
- Title Pattern: Extract primary information (required)
- Time Pattern: Extract hour/minute/AM-PM (optional)
- Date Pattern: Extract month/day/year (optional)
- Timezone: Event timezone with automatic DST support
- Program Duration: Length of generated programs in minutes
- Title Template: Format EPG title using captured groups
- Description Template: Format EPG description using captured groups
- Upcoming Title Template: Custom title for programs before event starts (optional)
- Upcoming Description Template: Custom description for programs before event starts (optional)
- Ended Title Template: Custom title for programs after event ends (optional)
- Ended Description Template: Custom description for programs after event ends (optional)
- Name Source: Channel name or stream name
- Stream Index: Which stream to use when parsing stream names (1, 2, 3, etc.)
Closes #293
|
||
|---|---|---|
| .. | ||
| 0001_initial.py | ||
| 0002_epgsource_file_path.py | ||
| 0003_alter_epgdata_tvg_id.py | ||
| 0004_epgdata_epg_source_alter_epgdata_tvg_id.py | ||
| 0005_programdata_custom_properties_and_more.py | ||
| 0006_epgsource_refresh_interval_epgsource_refresh_task.py | ||
| 0007_epgsource_status_epgsource_last_error.py | ||
| 0007_populate_periodic_tasks.py | ||
| 0008_epgsource_created_at_epgsource_updated_at.py | ||
| 0009_alter_epgsource_created_at_and_more.py | ||
| 0010_merge_20250503_2147.py | ||
| 0011_update_epgsource_fields.py | ||
| 0012_alter_epgsource_status.py | ||
| 0013_alter_epgsource_refresh_interval.py | ||
| 0014_epgsource_extracted_file_path.py | ||
| 0015_alter_programdata_custom_properties.py | ||
| 0016_epgdata_icon_url.py | ||
| 0017_alter_epgsource_url.py | ||
| 0018_epgsource_custom_properties_and_more.py | ||
| __init__.py | ||