Skip to content

[newsflasharr] add Newsflasharr, a central notification service - #209

Merged
sethwv merged 2 commits into
Dispatcharr:mainfrom
PiratesIRC:add-newsflasharr
Aug 2, 2026
Merged

[newsflasharr] add Newsflasharr, a central notification service#209
sethwv merged 2 commits into
Dispatcharr:mainfrom
PiratesIRC:add-newsflasharr

Conversation

@PiratesIRC

Copy link
Copy Markdown
Contributor

About this submission

New plugin: Newsflasharr, a central notification service for Dispatcharr plugins.

A calling plugin drops a small event into a file queue and returns. Newsflasharr routes it to Discord, a generic webhook, ntfy, Apprise, email, or a banner drawn over live video, applying deduplication, storm throttling, quiet hours and per-channel retry. The intent is that plugin authors stop re-implementing webhook code and the operator configures delivery once, in one place.

It is read-only on Dispatcharr: it writes nothing outside its own /data/newsflasharr/ directory, and it never creates or edits an output profile, a channel or a stream.

Externally hosted, so this pull request adds only plugin.json, README.md and logo.png. The archive is served from the plugin's own GitHub release, first release 1.26.2141913. The source_url uses a bare tag with no v prefix, matching how that repository tags. I checked the resolved download returns HTTP 200 and the expected 190,457 byte archive before opening this.

Source and full documentation: https://github.com/PiratesIRC/Dispatcharr-Newsflasharr-Plugin

One thing worth flagging for anyone testing it: the container must be restarted after installing. The worker that delivers events starts when the plugin is constructed, so without a restart the plugin loads and appears healthy while nothing is delivered. The README in this folder says so, as does the plugin's own documentation.

Pre-submission checklist

If this is a new plugin:

  • Plugin folder is named lowercase-kebab-case
  • plugin.json contains all required fields (name, version, description, author or maintainers, license)
  • My GitHub username is in author or maintainers
  • license is a valid OSI-approved SPDX identifier (e.g. MIT, Apache-2.0)
  • I have tested the plugin against a running Dispatcharr instance

If this is an update to an existing plugin:

  • version in plugin.json is incremented (unless this is a metadata-only change - see Versioning)
  • I am listed in author or maintainers of the existing plugin

Newsflasharr lets other Dispatcharr plugins hand off all notification
delivery to one place. A calling plugin drops a small event into a file
queue and returns; Newsflasharr routes it to Discord, a generic webhook,
ntfy, Apprise, email, or a banner drawn over live video, applying
deduplication, storm throttling, quiet hours and per-channel retry.

Externally hosted, so this adds only the manifest, a README and a logo.
The archive is served from the plugin's own GitHub release.

Licensed MIT. Source and documentation:
https://github.com/PiratesIRC/Dispatcharr-Newsflasharr-Plugin
@dispatcharr-plugins-bot dispatcharr-plugins-bot Bot added the New Plugin A new plugin being contributed to the repository. label Aug 2, 2026
@dispatcharr-plugins-bot

This comment has been minimized.

CodeQL on the previous submission flagged py/overly-permissive-file: the
plugin's action output files were written world-readable, and two of them
print provider hostnames derived from the operator's own configuration.

Fixed upstream by leaving those files at the 0600 they are created with. The
wider mode was cosmetic and the narrower one had already been measured not to
break anything.
@dispatcharr-plugins-bot

Copy link
Copy Markdown

Plugin Validation Results

Modified plugins: 1

Plugin: newsflasharr

Central notification service: other plugins drop events, Newsflasharr routes them to Discord, a webhook, ntfy, Apprise, email, or an on-screen banner over live TV, with deduplication, storm throttling, quiet hours and per-channel retry.

Source Repository

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

View release 1.26.2142011 on GitHub


🎉 All validation checks passed!

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


Other plugins by PiratesIRC in this repository (6)
Plugin Slug Version
Channel Mapparr channel-mapparr 1.26.1791324
EPG Janitor epg-janitor 1.26.1791309
Event Channel Managarr event-channel-managarr 1.26.1711720
IPTV Checker iptv-checker 1.26.1741204
Lineuparr lineuparr 1.26.1791747
Stream-Mapparr stream-mapparr 1.26.2072208

@sethwv
sethwv merged commit b8a8998 into Dispatcharr:main Aug 2, 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