plugin.json

{
  "name": "EPGeditARR",
  "version": "0.2.07",
  "logo": "logo.png",
  "icon": "logo.png",
  "description": "EPGeditARR cleans, transforms, and organizes your EPG data.\n\nEPG TRANSFORMATION: Strip episode codes, broadcast flags, quality tags, and other noise from program titles and descriptions using regex or find/replace rules. Virtual copies of your sources are kept in sync automatically after every refresh — originals are never touched.\n\nFILL EPG: Generate repeating placeholder schedules for channels with no EPG data so every channel shows something in your TV guide.\n\nSIRIUSXM TOOLS: Match channels to the official SiriusXM API channel database for real descriptions, sort your entire channel group into official lineup order, and automatically defer seasonal holiday channels to the end of the list until they go active. All SiriusXM actions use the dedicated SiriusXM Channel Group setting — completely separate from Fill Groups.\n\nRULE DESIGNER: Build and test rules visually at https://jstevenscl.github.io/epgeditarr/designer.html — pick from preset libraries or write your own, with live before/after preview.",
  "author": "jstevenscl",
  "help_url": "https://jstevenscl.github.io/epgeditarr/designer.html",
  "actions": [
    {
      "id": "setup",
      "label": "Setup Virtual EPGs",
      "button_label": "Setup",
      "description": "Create virtual EPG sources for all enabled sources, run the initial transform, and reassign channels. Run once after enabling sources and configuring rules.",
      "button_variant": "filled",
      "button_color": "green"
    },
    {
      "id": "apply_now",
      "label": "Apply Rules Now",
      "button_label": "Apply Now",
      "description": "Re-run the transformation on all enabled sources. Use this after changing rules without waiting for the next EPG refresh.",
      "button_variant": "filled",
      "button_color": "blue"
    },
    {
      "id": "preview",
      "label": "Preview Rule Changes",
      "button_label": "Preview",
      "description": "Dry run across all enabled sources — show which programs would change and before/after values. No data is modified.",
      "button_variant": "outline",
      "button_color": "cyan"
    },
    {
      "id": "sample",
      "label": "Sample Source Data",
      "button_label": "Sample Data",
      "description": "Show raw title, sub-title, and description values from each enabled source so you can write accurate rules.",
      "button_variant": "outline",
      "button_color": "cyan"
    },
    {
      "id": "test_rule",
      "label": "Test Rule",
      "button_label": "Test Rule",
      "description": "Apply the Pattern and Replacement from the Rule Tester section to the Test Text and show matches and the transformed result.",
      "button_variant": "outline",
      "button_color": "cyan"
    },
    {
      "id": "scan",
      "label": "Scan for Channels Without EPG",
      "button_label": "Scan",
      "description": "List all channels that have no EPG data assigned, grouped by channel group. Shows which groups are targeted by Fill EPG and SiriusXM actions.",
      "button_variant": "outline",
      "button_color": "cyan"
    },
    {
      "id": "fill_epg",
      "label": "Fill EPG",
      "button_label": "Fill",
      "description": "Generate a repeating placeholder EPG schedule for all channels in the Fill Groups that have no EPG data.",
      "button_variant": "filled",
      "button_color": "violet"
    },
    {
      "id": "sxm_fill_epg",
      "label": "Fill SiriusXM EPG",
      "button_label": "SiriusXM Fill",
      "description": "Assign EPG to all channels in the SiriusXM Channel Group from the community SiriusXM XMLTV source (EPGeditARR: SiriusXM). Sports channels get smart Upcoming / LIVE / Post-game blocks; all other channels get repeating fill blocks with real SiriusXM descriptions. Creates the EPG source automatically if it does not exist. Requires SiriusXM Enrichment to be enabled. ⚠️ Downloads ~200MB of EPG data and may take over 60 seconds — if your browser shows a timeout or gateway error, the fill likely completed anyway. Run 'Show Status' to confirm.",
      "button_variant": "filled",
      "button_color": "violet"
    },
    {
      "id": "sort_epg",
      "label": "Sort Channels",
      "button_label": "Sort",
      "description": "Reorder all channels in your SiriusXM Channel Group to match the SiriusXM official lineup. Assigns sequential channel numbers starting from Sort Start Number. Unmatched channels are placed at the end. Requires SiriusXM Enrichment data.",
      "button_variant": "filled",
      "button_color": "indigo"
    },
    {
      "id": "fill_and_sort",
      "label": "Fill EPG & Sort Channels",
      "button_label": "Fill & Sort",
      "description": "Run SiriusXM Fill EPG and Sort in sequence — generates schedules with real descriptions then reorders all channels in your SiriusXM Channel Group to match SiriusXM's lineup.",
      "button_variant": "filled",
      "button_color": "grape"
    },
    {
      "id": "fill_sort_logos",
      "label": "Fill EPG, Sort & Assign Logos",
      "button_label": "Fill, Sort & Logos",
      "description": "Run SiriusXM Fill EPG, Sort Channels, and Assign Logos in sequence — the full SiriusXM channel setup in one step. Operates on the SiriusXM Channel Group.",
      "button_variant": "filled",
      "button_color": "pink"
    },
    {
      "id": "rename_channels",
      "label": "Rename Channels to Official SiriusXM Names",
      "button_label": "Rename Channels",
      "description": "Rename channels in your SiriusXM Channel Group to their official SiriusXM names from the SiriusXM API channel database. Only matched channels are renamed — unmatched channels are left unchanged. Requires SiriusXM Enrichment to be enabled.",
      "button_variant": "filled",
      "button_color": "teal",
      "confirm": {
        "message": "This will rename matched channels in your SiriusXM Channel Group to their official SiriusXM names. Channel names will change in your TV guide. Continue?"
      }
    },
    {
      "id": "assign_logos",
      "label": "Assign SiriusXM Channel Logos",
      "button_label": "Assign Logos",
      "description": "Assign channel logos to matched SiriusXM channels in your SiriusXM Channel Group using the self-hosted GitHub Pages logo cache. Requires SiriusXM Enrichment to be enabled.",
      "button_variant": "filled",
      "button_color": "orange"
    },
    {
      "id": "refresh_channel_data",
      "label": "Refresh Channel Data",
      "button_label": "Refresh Channel Data",
      "description": "Force an immediate refresh of the SiriusXM channel list from the official API cache, overwriting the local cache.",
      "button_variant": "outline",
      "button_color": "violet"
    },
    {
      "id": "status",
      "label": "Show Status",
      "button_label": "Status",
      "description": "Show all EPG sources, which are enabled, virtual EPG program counts, and configured rules.",
      "button_variant": "outline",
      "button_color": "blue"
    },
    {
      "id": "teardown",
      "label": "Remove Virtual EPGs",
      "button_label": "Teardown",
      "description": "Delete all virtual EPG sources and Fill EPG, and reassign channels back to their original sources.",
      "button_variant": "filled",
      "button_color": "red",
      "confirm": {
        "message": "This will delete all virtual EPGs (including Fill EPG) and reassign channels back to their original sources. Continue?"
      }
    }
  ]
}