Plugins
reservoarr
Version: 6.4.0 |
Author: brko7 | Last Updated: Oct 14 2026, 14:48 UTC |
Delay-buffer stream profile that absorbs IPTV CDN gaps so Plex Live TV stops dying
Downloads
Latest Release
- Download:
reservoarr-latest.zip - Built: Oct 14 2026, 14:48 UTC
- Source Commit:
c5aa56b
Checksums:
MD5: 46d46419b3dc05bb88646de5e4bb1b0c
SHA256: 9a60fed3c2fc6ee7f145433d628f98a83ddeb6dbf0401ee066fefbbae31801be
All Versions
| Version | Download | Built | Commit | MD5 | SHA256 |
|---|---|---|---|---|---|
6.4.0 |
Download | Oct 14 2026, 14:48 UTC | c5aa56b |
46d46419b3dc05bb88646de5e4bb1b0c | 9a60fed3c2fc6ee7f145433d628f98a83ddeb6dbf0401ee066fefbbae31801be |
6.3.12 |
Download | Oct 14 2026, 11:14 UTC | 25879af |
284156806e526d160b41fd1113a49220 | 000c539c0a58254cd2b4223ad83305aaec08f946cafba3b555eb18b5b9b39bbe |
6.3.11 |
Download | Oct 14 2026, 10:27 UTC | ad69773 |
4667e1afdc08b41bd41469f117b30fc7 | f33089451f3579af49afb2aded77cf6ad2ba9a030d2a3a16386c015071e43f40 |
6.3.10 |
Download | Oct 12 2026, 19:10 UTC | 4b008ee |
8c66b25e362b3de008a505f888b4ac38 | 5d0978f34ea51e19f5a2a119619d6e20c6f2561a5c8da03cf1befc861ce94780 |
6.3.9 |
Download | Oct 12 2026, 18:13 UTC | 787ce05 |
bb9d4260488cdcbd7ef09c5bfd9cde05 | 866f5dd882eb9d298871234ca362dfcfac37fa811675795dfe4b7da7d056d0e8 |
6.3.8 |
Download | Oct 07 2026, 12:55 UTC | b3756ca |
c984b43f8b6b80d27bfd0a9eecb8eb20 | bc2e5222cea3da65b114dee414befef854e989db6cb4f51e42f06327866a1442 |
6.3.7 |
Download | Sep 19 2026, 17:50 UTC | 82ca657 |
4a778761a475fdb140afa11391682683 | bfb53548e63158cf59babf023059372dfc29f428f27bf7fa5c988e82759e019b |
6.3.6 |
Download | Sep 14 2026, 15:53 UTC | 3424828 |
33f905a48c5e52468dfa2b2143b4d958 | 8b8c234065d7504471b9f8d931875e9afebedd9496433b0819dc1178ea866247 |
6.3.5 |
Download | Sep 14 2026, 08:44 UTC | 546efce |
e8ad994d2fb042202a8b125c3d7ac871 | 54d23d495393da7773a495b5ac40ce08a05ca4a7189b606453354d981295bdb6 |
6.3.4 |
Download | Sep 13 2026, 14:11 UTC | 79abf33 |
c276f9b6b3319e4ca699e8ba35e916c9 | d1c7b3bbfe50c3368f2eca4865bca8dbc564002f5f9162f0d08b5efcbad485e9 |
| Maintainers: brko7 | Source: Browse Plugin |
Metadata: View full manifest
Plugin README
reservoarr
A delay-buffer stream profile that absorbs IPTV CDN gaps so Plex Live TV stops dying. Eagerly drains the upstream into a RAM reservoir, then releases bytes to ffmpeg at the stream’s PCR-derived content rate. Playback runs ~30s behind live, and gaps shorter than the cushion are invisible to the player.
What this is for
- Your IPTV provider’s CDN has prime-time gaps, occasional EOFs, or per-connection corrupt-loops.
- You watch through Plex Live TV (~15s tuner timeout) or any consumer that’s strict about input continuity.
- Symptoms today: channels die mid-stream, won’t tune on first try, A/V desync after a reconnect, short black-frame stutters.
If your provider streams cleanly, you don’t need this.
Install
Dispatcharr → Plugins → Find Plugins → search “reservoarr” → Install. Click Generate Stream Profile in the plugin settings.
Tuning is via RESV_* environment variables on the Dispatcharr container — see the TUNABLES doc. Defaults match production-validated behaviour and fit most providers.
Architecture (one paragraph)
upstream HTTP → RAM reservoir (≤256MB, ~30s target cushion) → byte-rate paced release at the PCR content rate → ffmpeg remux (video copy + dump_extra + -c:a ac3) → Dispatcharr → Plex. Pacing happens in the wrapper, not with ffmpeg -re — the provider’s streams carry occasional corrupt packets with garbage DTS, and -re sleeps on them. PCR is a measurement input; a garbage sample is rejected by a plausibility window. Three watchdogs ride alongside (corrupt-loop, stall, TS-corruption).
Telemetry
/data/scripts/logs/delaybuf.log (configurable, self-rotates at 10 MB):
2026-06-14T10:03:33 [500004175] cushion=27s(pcr) buf=15.5MB out=4.66Mbps in=4.96Mbps crate=4.80Mbps in_total=1843MB reconnects=0 ccerr=0 pcrrej=0 disc=0 sync=0
Full schema in the TELEMETRY doc.
More
- Source, issues, discussions: https://github.com/brko7/reservoarr
- Releases: https://github.com/brko7/reservoarr/releases
- Hard invariants (every one earned by a production failure): https://github.com/brko7/reservoarr/blob/main/docs/INVARIANTS.md
MIT licensed.