Skip to content

[dustarr] Add Dustarr, a read-only channel usage reporter - #258

Merged
sethwv merged 2 commits into
Dispatcharr:mainfrom
PiratesIRC:dustarr-1.26.2362242
Aug 26, 2026
Merged

[dustarr] Add Dustarr, a read-only channel usage reporter#258
sethwv merged 2 commits into
Dispatcharr:mainfrom
PiratesIRC:dustarr-1.26.2362242

Conversation

@PiratesIRC

Copy link
Copy Markdown
Contributor

Adds Dustarr, a read-only channel usage reporter, as an external listing.

What it does

Dustarr records which channels are actually watched and reports the ones that are not, so an operator can turn off the dead weight in a lineup. A leader-elected collector samples the live-proxy state every 15 seconds and turns client counts into watch sessions. A session counts as a watch only after two minutes, so channel-surfing does not inflate the numbers; shorter sessions are recorded separately as tunes, which is what separates channels nobody wants from channels that are simply broken.

It produces a self-contained HTML report and a CSV export, written to /config/dustarr/. Nothing in the report is fetched from the internet.

It does not write to Dispatcharr

The plugin reads Redis and the channel list, and writes its own report files. Nothing else. That is enforced by a test that reads the syntax tree of every shipped module on every CI run and fails the build on any write-shaped ORM call it can prove, on subprocess and its relatives, and on any stream probe. It also makes no network requests of any kind, so it never consumes a provider connection.

Listing details

Checks run before opening this

  • Folder name is lowercase-kebab-case: dustarr
  • Version is valid semver
  • license is MIT, an OSI-approved SPDX identifier
  • The pull request author appears in both author and maintainers
  • source_url is HTTPS and contains a {version} placeholder
  • repo_url is set, as external listings require
  • The resolved release URL returns HTTP 200 and 121,429 bytes

The upstream release asset was verified by downloading it back and byte-comparing it against the archive built from the tag.

New external listing. Dustarr records which channels are actually watched and
reports the ones that are not, so an operator can turn off the dead weight in a
lineup. It never writes to Dispatcharr's database and never contacts a provider.

External mode: the listing holds plugin.json, logo.png and README.md, and the
registry fetches the archive from the plugin's own GitHub release.

Verified before opening: the folder name is lowercase-kebab-case, the version is
valid semver, the licence is MIT, the pull request author is in author and
maintainers, source_url is HTTPS with a {version} placeholder, repo_url is set,
and the resolved release URL returns HTTP 200 at 121,429 bytes.
@dispatcharr-plugins-bot dispatcharr-plugins-bot Bot added the New Plugin A new plugin being contributed to the repository. label Aug 25, 2026
@dispatcharr-plugins-bot

This comment has been minimized.

@PiratesIRC

Copy link
Copy Markdown
Contributor Author

@sethwv is there something i need to do to get this merged?

@sethwv

sethwv commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

@sethwv is there something i need to do to get this merged?

New plugins are not auto merged, and we have not had a chance to review yet. I'll try to get to this today.

@PiratesIRC

Copy link
Copy Markdown
Contributor Author

Oh, I did not know. No rush then. thx for the help!

discord_thread points at the plugin's introduction thread on the Dispatcharr
Discord, which did not exist when this pull request was opened.

No version bump: discord_thread is one of the metadata-only fields the
validation workflow exempts, and the release artifact is unchanged.
@dispatcharr-plugins-bot

Copy link
Copy Markdown

Plugin Validation Results

Modified plugins: 1

Plugin: dustarr

Records which channels are actually watched and reports the ones that are not, so you can turn off the dead weight in your lineup. Read only: it never changes a channel and never contacts your provider.

Source Repository

Check Status Details
Required fields All required fields present
Release artifact Artifact reachable at resolved URL
Maintainers PiratesIRC, PiratesIRC
License MIT - MIT License
Permission New plugin - PiratesIRC listed in author/maintainers
Version 1.26.2362242
Version bump New plugin

View release 1.26.2362242 on GitHub


🎉 All validation checks passed!

This PR modifies 1 plugin(s) and all checks have passed.


Other plugins by PiratesIRC in this repository (7)
Plugin Slug Version
Channel Mapparr channel-mapparr 1.26.2291823
EPG Janitor epg-janitor 1.26.2281111
Event Channel Managarr event-channel-managarr 1.26.2351639
IPTV Checker iptv-checker 1.26.2201040
Lineuparr lineuparr 1.26.2291211
Newsflasharr newsflasharr 1.26.2241159
Stream-Mapparr stream-mapparr 1.26.2241602

@sethwv
sethwv merged commit cc538fa into Dispatcharr:main Aug 26, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

New Plugin A new plugin being contributed to the repository.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants