Skip to content

[clapparr]: Add Clapparr - NFO sidecars, posters and thumbnails for DVR recordings - #252

Merged
sethwv merged 1 commit into
Dispatcharr:mainfrom
v8eta:add-clapparr
Aug 22, 2026
Merged

[clapparr]: Add Clapparr - NFO sidecars, posters and thumbnails for DVR recordings#252
sethwv merged 1 commit into
Dispatcharr:mainfrom
v8eta:add-clapparr

Conversation

@v8eta

@v8eta v8eta commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

New plugin: Clapparr

The metadata slate for your DVR. Writes Kodi/Plex NFO sidecars, posters and episode thumbnails for DVR recordings, from metadata Dispatcharr already holds on the Recording — so they present with real titles, summaries and artwork instead of Episode 08-18. Runs on the recording_end event (deferred until the remux completes, since the event fires before file_path exists), with manual Generate / Regenerate / Preview actions.

External plugin per CONTRIBUTING:

  • Source repo (public, MIT): https://github.com/v8eta/clapparr
  • source_url template resolves to the release asset, e.g. v1.3.0 ZIP — verified downloadable unauthenticated, archive contains a single top-level clapparr/ folder so the importer derives the key correctly.
  • Zero dependencies: Python stdlib only, plus the host app's own modules per Plugins.md guidance (apps.channels.models, django.db.close_old_connections). Thumbnails shell out to the ffmpeg already in the Dispatcharr image and fail soft without it. Verified to import cleanly in bare Python inside the stock container.
  • 47 offline tests ship in the plugin folder (test_fuzzy_match.py, test_webhook.py, test_ownership_plex.py).
  • Secret-bearing fields use input_type: "password"; the optional webhook strips URL credentials into an Authorization header before the request is built, so they cannot surface in logs or exceptions.
  • Event-handler discipline per Plugins.md: the recording_end action returns immediately and defers to a thread that calls close_old_connections() in its own finally.

Developed and tested against Plex (PMS 1.43.1+ NFO agent); the sidecars are standard Kodi-format NFOs. Tested-on scope, EPG-data requirements and an AI-assistance disclosure are stated in the README.

Happy to adjust anything to fit the registry's conventions.

External plugin. Writes Kodi/Plex NFO sidecars, posters and episode
thumbnails from metadata Dispatcharr already holds on the Recording, so
DVR recordings present with real titles, summaries and artwork instead
of "Episode 08-18". Zero dependencies (Python stdlib plus the host
app's own modules); source_url resolves to the versioned release ZIP at
github.com/v8eta/clapparr, MIT licensed.
@dispatcharr-plugins-bot dispatcharr-plugins-bot Bot added the New Plugin A new plugin being contributed to the repository. label Aug 20, 2026
@dispatcharr-plugins-bot

This comment has been minimized.

@v8eta v8eta changed the title Add Clapparr — NFO sidecars, posters and thumbnails for DVR recordings [clapparr]: Add Clapparr - NFO sidecars, posters and thumbnails for DVR recordings Aug 20, 2026
@dispatcharr-plugins-bot

Copy link
Copy Markdown

Plugin Validation Results

Modified plugins: 1

Plugin: clapparr

The metadata slate for your DVR: writes Kodi/Plex NFO sidecars, posters and episode thumbnails so recordings present with real titles, summaries and artwork instead of 'Episode 08-18'.

Source Repository

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

View release v1.3.0 on GitHub


🎉 All validation checks passed!

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

@sethwv
sethwv merged commit 41752af into Dispatcharr:main Aug 22, 2026
18 of 20 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