Plugins
Lineuparr
Version: 1.26.2901915 |
Author: PiratesIRC | Last Updated: Oct 17 2026, 21:57 UTC |
Mirror real-world provider channel lineups by creating channel groups, channels, and fuzzy-matching IPTV streams to them.
Downloads
Latest Release
- Download:
lineuparr-latest.zip - Built: Oct 17 2026, 21:58 UTC
- Source Commit:
0d24250
Checksums:
MD5: aefc7a6f74fe96bb8f5ace95a562bc7a
SHA256: cdf7c4c633184d102a56d00492f56db9baf520eb8a5fd40dd12cfa70a6fbc710
All Versions
| Version | Download | Built | Commit | MD5 | SHA256 |
|---|---|---|---|---|---|
1.26.2901915 |
Download | Oct 17 2026, 21:58 UTC | 0d24250 |
aefc7a6f74fe96bb8f5ace95a562bc7a | cdf7c4c633184d102a56d00492f56db9baf520eb8a5fd40dd12cfa70a6fbc710 |
1.26.2881058 |
Download | Oct 15 2026, 11:03 UTC | b119e7e |
113800ec1a7977440f1afc369c87c6e9 | 39aed56384f4ed9066c25bffee8b817043faeec2c07f29393be6d7e73f54d38c |
1.26.2880000 |
Download | Oct 15 2026, 00:05 UTC | c759363 |
7b364e8569368a89e8e08ac9f1807c7a | aabf797562a6abaf14108d4fb4cd54a4dc01928f2050bd1d36b0cc441bc58082 |
1.26.2831530 |
Download | Oct 10 2026, 15:35 UTC | f27d830 |
a9fe3029612716ab733bad530b0c1d84 | b815f05d269679e95d31c6f9570a91bdc91503a6887d05365e2f33e272df4d04 |
1.26.2821835 |
Download | Oct 09 2026, 18:41 UTC | e66282c |
dece7f089b66f4cbbb1a64e3c1b2a294 | 83eb0d6cd801a15b8e30cc90f3cf6fe59ac98e800c5a8f5f1c37807135ea227f |
1.26.2561550 |
Download | Sep 13 2026, 16:03 UTC | e56e990 |
48b855f675156903fe8421e7d80ccbf6 | e46ceda0cd9e14154a912dd642dfaa5dc406a5a6bff8882238098785929c0f42 |
1.26.2481702 |
Download | Sep 05 2026, 17:43 UTC | 73d6175 |
532b59b37f580ced08de2a65933fa649 | ac627e4897183392e56761aa4d26a2598382297e4df8873259a27cc0ffbe2fa8 |
1.26.2421451 |
Download | Aug 30 2026, 14:59 UTC | 476de89 |
197c71fa2b92b46c7b3998dc47000219 | aa2e8a1a77efb2739802d5428c83a8067beead44ed48f96a546ccc91cf636741 |
1.26.2291211 |
Download | Aug 17 2026, 12:18 UTC | d8d31a9 |
c9feb41615487ac7c26d59e56a372828 | c3d73602e91c065a5aac7db7901556909ea08b54a4f515bedd46533aaff1ecf3 |
1.26.2271740 |
Download | Aug 15 2026, 18:21 UTC | 51dc15c |
04eb22929a7c6441063d47ca45800fae | 17e25884accec92b05c396f7f8a2e3ee8c3f5db2df0b850c2fc075eb4b67c436 |
Source: Browse Plugin
Metadata: View full manifest
Plugin README
Mirror real-world TV provider lineups with automatic stream matching, EPG, and logos
[!TIP] New to Dispatcharr plugins? Start with the Dispatcharr Plugin Workflow guide. It explains what each plugin and tool does, where they overlap, and what order to use them in.
Warning: Backup Your Database
Before installing or using this plugin, it is highly recommended that you create a backup of your Dispatcharr database. This plugin creates and modifies channel groups, channels, and stream assignments, and unless you turn on Preserve Existing Streams it also replaces a channel’s whole stream list and deletes channels that end a run with no streams.
Click here for instructions on how to back up your database.
What it does
You pick a real provider lineup, such as Sky TV or DIRECTV Premier, and the plugin builds those channel groups and channels in Dispatcharr and attaches your own streams to them by name.
- Builds the lineup. Channel groups and channels that mirror the provider’s package, keeping the provider’s channel numbers.
- Matches your streams to it. A four stage pipeline: alias, exact, substring, then fuzzy token sort, with US broadcast callsign anchoring and length scaled thresholds to keep false positives down. Four sensitivity presets from Relaxed to Exact.
- Rejects streams from the wrong country. A lineup keeps only same country or untagged streams. Detection covers the tag formats real providers use, including parenthesized, colon separated, box bar separated, bare space, and country glued to a quality tag. When a stream name carries no country at all, the provider group it came from is read instead, which is what catches a provider that labels streams by platform rather than by country.
- Knows about regional variants, so an East, West or Pacific channel reaches the matching regional stream.
- Assigns EPG data and logos. Programme guides from any configured EPG source, and logos from EPG icons, the Logo Manager, or the tv-logos repository.
- Orders streams by quality, 4K before UHD before FHD before HD before SD, using the name or IPTV Checker metadata.
- Previews before it commits. A dry run writes a CSV of what would match and how confidently, so you can read it first.
- Reports what it did. A shareable HTML page and CSV per run, optionally emailed through the Newsflasharr plugin.
- Replaces by default, appends on request. A stream match normally replaces each channel’s whole stream list and then deletes channels left with no streams. Turn on Preserve Existing Streams and it appends instead, skipping duplicates and deleting nothing, so a second M3U source can be layered on safely.
- Colours its buttons by consequence. Red can remove a stream or a channel and always asks first, orange writes but removes nothing, blue only reads and reports.
- Runs inside Dispatcharr with direct database access, so no API credentials are needed.
The Channels Created badge above is this installation’s own running total, recorded by the plugin each time Sync Channels Only or Full Sync finishes. It counts creations performed rather than channels that still exist, so a channel later removed by the unmatched-channel cleanup does not subtract from it and the number never falls. It is a floor: it started when the counter shipped, and earlier runs were not recorded because nothing in the database distinguishes a channel this plugin made from one made by hand.
Over 200 built-in channel aliases, plus your own in JSON. Every setting and action is covered in the user guide.
Included Lineups
| File | Provider | Country | Channels |
|---|---|---|---|
US_DirecTV-Premier_lineup.json |
DIRECTV Premier | US | ~350 |
US_DISH-Top250_lineup.json |
DISH Top 250 | US | ~215 |
US_Verizon-FIOS_lineup.json |
Verizon FiOS | US | ~200 |
US_Verizon-FIOS-All-11743_lineup.json |
Verizon FiOS, every channel available at ZIP 11743 | US | ~508 |
US_Optimum_lineup.json |
Optimum (Southern Westchester) | US | ~340 |
US_Spectrum-Tampa-Bay-All_lineup.json |
Spectrum Tampa Bay, all channels | US | ~410 |
US_Spectrum-Tampa-Bay-No-Spanish_lineup.json |
Spectrum Tampa Bay, Spanish channels excluded | US | ~320 |
US_Spectrum-Tampa-Bay-Spanish-Only_lineup.json |
Spectrum Tampa Bay, Spanish channels only | US | ~85 |
US_Combined_lineup.json |
US Combined (DIRECTV + DISH + Verizon) | US | ~465 |
UK_Freeview_lineup.json |
Freeview | UK | ~160 |
UK_SkyTV_lineup.json |
Sky TV | UK | ~175 |
UK_SkyTV_ENG_full_lineup.json |
Sky TV (Full LineUp) | UK | ~315 |
UK_SkyTV_ENG_simple_lineup.json |
Sky TV (Simple LineUp) | UK | ~295 |
UK_Combined_lineup.json |
UK Combined (Freeview + Sky TV Full) | UK | ~395 |
ES_Movistar_lineup.json |
Movistar+ | ES | ~170 |
FR_CanalPlus_lineup.json |
Canal+ | FR | ~275 |
FR_CanalPlus_TNT_lineup.json |
Canal+ (with TNT) | FR | ~275 |
AU_Foxtel_lineup.json |
Foxtel Platinum Plus | AU | ~140 |
CA_Telus-Optik_lineup.json |
Telus Optik | CA | ~130 |
NL_ODIDO_lineup.json |
ODIDO | NL | ~155 |
NL_KPN_lineup.json |
KPN Interactive TV, television and radio | NL | ~290 |
QA_beIN-MENA_lineup.json |
beIN MENA (Middle East and North Africa) | QA | ~168 |
TZ_Azam-TV_lineup.json |
Azam TV | TZ | ~146 |
TZ_DStv-Premium_lineup.json |
DStv Premium | TZ | ~192 |
TZ_Combined_lineup.json |
TZ Combined (Azam TV + DStv Premium) | TZ | ~310 |
DO_Altice_lineup.json |
Altice | DO | ~224 |
DO_Claro_lineup.json |
Claro | DO | ~261 |
DO_Combined_lineup.json |
DO Combined (Altice + Claro) | DO | ~309 |
PE_Claro_lineup.json |
Claro Peru | PE | ~201 |
The beIN MENA lineup is regional rather than single country, so its country filtering is partial. Its filename country code is QA, which rejects streams tagged for a country outside the region: an Australian, Belgian or French beIN feed will not attach to one of its channels. Streams tagged for another Middle East or North Africa country, and streams tagged AR for Arabic, are treated as untagged and are kept, which is deliberate because those are the tags the region’s own feeds carry.
These are community-compiled channel lists based on publicly available provider lineup information. You can write your own: see the lineup file format.
The Verizon FiOS ZIP 11743 lineup is the one to look at if you are writing your own: 434 of its channels carry their own alias lists, which is the per-channel aliases array described in that format guide. The three Spectrum Tampa Bay lineups use the same array on every channel.
Requirements
- Dispatcharr v0.20.0 or newer
- At least one M3U source configured with streams
- EPG sources configured, optional, for EPG matching
No API credentials are needed. The plugin runs inside Dispatcharr with direct database access.
Install
- Log in to Dispatcharr’s web interface.
- Go to Plugins.
- Click Import Plugin and upload
Lineuparr.zip. - Enable the plugin.
Then pick a lineup file and an M3U source, save, and run Validate Settings followed by Preview Stream Match. The user guide walks through it.
Updating
Remove the old plugin from the Plugins page, restart Dispatcharr (docker restart dispatcharr), then import the new zip and enable it. Your settings are kept, but check them after upgrading.
Documentation
| Page | What is in it |
|---|---|
| User guide | Every setting, every action, match sensitivity, country matching, custom aliases, adding a second provider, keeping channels up to date, requesting a new lineup, reports and emailing, file locations, troubleshooting, and how the matching pipeline works. |
| Lineup file format | Writing your own lineup: the JSON shape, the filename rule, per-channel aliases, and marking foreign channels. |
Contributing
Reporting issues
- Include your Dispatcharr version.
- Provide relevant container logs:
docker logs dispatcharr | grep "Lineuparr". - Run Preview Stream Match and attach the CSV export. This is the most useful thing you can share. Check that no stream URLs are in the CSV before sharing it, because they can carry your provider credentials.
- Say which Match Sensitivity setting and lineup file you used.
Submitting lineup databases
Community-contributed lineups are welcome. The JSON shape and the filename rule are in the lineup file format. Open a pull request with the file, or an issue giving the provider name, country, channel list and where the listing came from.
If you would like a provider added but cannot build the file yourself, open a Lineup Request issue with the provider name, country, and a link to their channel listing page.
Bumping the plugin version
Version format is 1.26.{DDD}{HHMM}, a three digit day of year plus a four digit UTC time. Both Lineuparr/plugin.json and PluginConfig.PLUGIN_VERSION in Lineuparr/plugin.py must stay in step, so use the helper rather than editing them by hand:
python scripts/bump_version.py # auto from the current UTC time
python scripts/bump_version.py --set 1.26.1031200 # explicit
Disclaimer
Lineuparr provides no television content of any kind. It supplies no channels, no playlists, no streams, no electronic programme guide data and no provider accounts, and it contains no list of where to obtain any of those. The lineup files it ships are lists of channel names and channel numbers, compiled from publicly available provider channel listings. They contain no stream addresses, no credentials and no provider account details.
The plugin never contacts a media provider. It never opens, fetches, decodes, records, restreams or redistributes any stream. It reads the stream names, EPG entries and channels that Dispatcharr already holds for the sources you configured, matches them by name against a lineup you chose, and writes the results back into Dispatcharr. The only network requests it makes on its own are to the tv-logos repository on GitHub, when you ask it to assign channel logos.
You are responsible for what you connect Dispatcharr to. Whether a particular provider, subscription, playlist or stream is lawful for you to use depends on your agreement with that provider and on the law where you live. Use only sources you are authorised to use. Nothing in this project is intended to enable, encourage or assist access to content you have no right to access.
All product names, channel names, trademarks and registered trademarks mentioned in this project or appearing in its lineup files are the property of their respective owners. This project is an independent, community-built plugin. It is not affiliated with, endorsed by, or sponsored by any television network, broadcaster, streaming service or IPTV provider, and it is not affiliated with the Dispatcharr project beyond being a plugin written for it.
The software is provided as-is, without warranty of any kind, as set out in the licence. This section describes the design of the software and the author’s intent. It is not legal advice. If you need to know whether your own use is lawful, ask someone qualified in your jurisdiction.
Anonymous usage counts
The Channels Created and Active Installs badges count every install that leaves the “Share anonymous usage counts” setting (on by default) ticked and runs at least one action or sync. When an action or sync finishes, at most once an hour, or ten minutes after the last report when a sync has just created channels, the plugin sends this plugin’s Channels Created total and a random id for this plugin on this install to the plugin author’s counter at plugin-stats.dpas.workers.dev. The server stores that id with the total and the date of the last report. The connection shows the server your public IP address; the server uses it only to limit abuse and does not store it in its database, though when an install first registers it keeps a salted one-way hash of it (of its /64 block for IPv6) for up to three days. Cloudflare, which hosts the server, keeps its own request logs. No names, channels, streams, providers or settings are sent. The figures are self-reported by installs and capped by the server, not verified. Untick the setting to stop sending; this install’s figures are deleted from the server the next time an action or sync finishes after you untick.
License
MIT. See LICENSE.