kirby-deluge/README.md

Kirby Deluge

A plugin for Kirby that provides a bridge between the Deluge BitTorrent Client and the Jellyfin Media Player.

Usage

• Create a new deluge page.
• Fill out the Deluge URL and password along with the speeds desired.
  • Minimums are used when there ARE Jellyfin streams active.
  • Maximums are used when there are NO Jellyfin streams active.
  • Max time at min speed defines a timeout for streams that may be paused or aren't stopped properly.
• Generate and fill out the Jellyfin API key and Jellyfin URL.
• Use the Webhook plugin in Jellyfin to create 2 webhooks:
  • First hook:
    • URL: https://website.url/deluge?s=inc
    • Notification Type: Playback Start
    • Set Item Types and User Filter's.
  • Second hook:
    • URL: https://website.url/deluge?s=dec
    • Notification Type: Playback Stop
    • Match Item Types and User Filter's above.
• Test connecting to Deluge by visiting the page and using the buttons.
• Test connecting to Jellyfin by visiting Jellyfin, starting a stream and checking the page.

License

Kirby Deluge is Copyright 2026, Dreytac.

Kirby Deluge is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License version 3 as published by the Free Software Foundation.

Kirby Deluge is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.