From 442f2db9b47053a3bae5e4417ec0f4c2c44c3055 Mon Sep 17 00:00:00 2001 From: David Newhall II Date: Wed, 2 Sep 2026 00:50:15 -0700 Subject: [PATCH 1/2] docs: document qBittorrent turtle-mode throttle for remote Plex and Jellyfin Enable it on the website Client Settings after alternative limits are set in qBittorrent. Plex uses WAN sessions; Jellyfin uses playback webhooks. Co-authored-by: Cursor --- docs/pages/client/gui.md | 2 +- docs/pages/integrations/jellyfin.md | 13 +++++++++++++ docs/pages/integrations/plex.md | 9 ++++++++- 3 files changed, 22 insertions(+), 2 deletions(-) diff --git a/docs/pages/client/gui.md b/docs/pages/client/gui.md index 792adcb..fac940d 100644 --- a/docs/pages/client/gui.md +++ b/docs/pages/client/gui.md @@ -37,7 +37,7 @@ The Web UI sidebar is organized into two main sections: - **Configuration** - General settings including API key, bind address, URL base, SSL, logging, and system options. - **Site Tunnel** - Manage the persistent websocket tunnel to notifiarr.com. Select primary and backup tunnels. - **Starr Apps** - Configure Radarr, Sonarr, Lidarr, Readarr, and Prowlarr instances. -- **Download Apps** - Configure Deluge, qBittorrent, rTorrent, SABnzbd, NZBGet, and Transmission. +- **Download Apps** - Configure Deluge, qBittorrent, rTorrent, SABnzbd, NZBGet, and Transmission. Remote-playback turtle mode is toggled from Plex and Jellyfin Client Settings on the website; set the alternative limits in qBittorrent first. - **Media Apps** - Configure Plex and Tautulli. - **Snapshot Apps** - Configure MySQL and Nvidia GPU monitoring for snapshots. - **File Watcher** - Watch log files for lines matching regular expressions. diff --git a/docs/pages/integrations/jellyfin.md b/docs/pages/integrations/jellyfin.md index 7c95721..c877a77 100644 --- a/docs/pages/integrations/jellyfin.md +++ b/docs/pages/integrations/jellyfin.md @@ -39,6 +39,19 @@ Click the **cog icon** to open the configuration options for Jellyfin. 1. Notification content options that you can turn on/off to show in the notifications +### Client Settings + +The same **qBittorrent Speed Limit** block is on Plex and Jellyfin Client Settings so saving either page keeps the other. + +1. `Enabled` - Turn on qBittorrent alternative (turtle) speed limits when remote playback is active. Set the alternative limits in qBittorrent first. +1. `Plex WAN` - Throttle while a Plex movie or episode is playing or paused on WAN (not LAN). +1. `Jellyfin` - Throttle on Jellyfin PlaybackStart and PlaybackStop for movies and episodes. +1. `Cooldown` - How long to wait after remote playback ends before turning alternative speed limits back off. + +Jellyfin webhooks usually do not include LAN vs WAN. If `RemoteEndPoint` is present and is a private IP, throttle is skipped. If the field is missing, throttle still runs. + +Plex uses WAN sessions on the client. Jellyfin uses playback webhooks from the website. Plex and qBit must be on the same Notifiarr client. + ### Notifiarr ![instructions.png](../../assets/screenshots/integrations/jellyfin/instructions.png) diff --git a/docs/pages/integrations/plex.md b/docs/pages/integrations/plex.md index 5e89dfb..31141af 100644 --- a/docs/pages/integrations/plex.md +++ b/docs/pages/integrations/plex.md @@ -52,7 +52,7 @@ Click the **cog icon** to open the integration settings for Plex. 1. `Triggers` - Adjust which webhooks will send notifications to you. 1. `Integration Settings` - Allows the user to further configure the integration. 1. `Extra Settings` - Adjust the extra settings for this integration. -1. `Client Settings` - Allows the user to set the scanning interval. +1. `Client Settings` - Allows the user to set the scanning interval and qBittorrent alternative speed limits. 1. `Custom Icon` - Assign another icon to notifications from this integration. (Subscriber Feature) 1. `Content Lines` - Add a message to the top of notifications for wearable/toast purposes. 1. `Screenshots` - Shows the expected output once all correctly configured. @@ -133,6 +133,13 @@ Additional settings such as automatically unmonitor an episode or movie once a u 1. `Cooldown` - Minimum time between notifications to ensure duplicates are not sent (such as media.play and playback.started) 1. `Interval` - This is how often to send a notification for the Plex Sessions trigger, nothing sends if there is no media playing or paused. ![interval.png](../../assets/screenshots/integrations/plex/interval.png) +1. `qBittorrent Speed Limit` - Turn on qBittorrent alternative (turtle) speed limits when remote playback is active. Set the alternative limits in qBittorrent first. Plex and qBit must be on the same client. + - `Enabled` - Master switch for this feature. + - `Plex WAN` - Throttle while a Plex movie or episode is playing or paused on WAN (not LAN). + - `Jellyfin` - Throttle on Jellyfin PlaybackStart for movies and episodes. + - `Cooldown` - How long to wait after remote playback ends before turning alternative speed limits back off. + +The client only turns turtle mode off if it turned turtle mode on. If alternative limits were already enabled in qBittorrent, they stay on when playback ends. ### Custom Icon From 8d8c521cec850a979fd5aad3817a693134c54fe3 Mon Sep 17 00:00:00 2001 From: David Newhall II Date: Wed, 2 Sep 2026 01:18:34 -0700 Subject: [PATCH 2/2] docs: document Emby qBittorrent turtle-mode throttle Co-authored-by: Cursor --- docs/pages/client/gui.md | 2 +- docs/pages/integrations/emby.md | 14 ++++++++++++++ docs/pages/integrations/jellyfin.md | 5 +++-- docs/pages/integrations/plex.md | 1 + 4 files changed, 19 insertions(+), 3 deletions(-) diff --git a/docs/pages/client/gui.md b/docs/pages/client/gui.md index fac940d..5979c2e 100644 --- a/docs/pages/client/gui.md +++ b/docs/pages/client/gui.md @@ -37,7 +37,7 @@ The Web UI sidebar is organized into two main sections: - **Configuration** - General settings including API key, bind address, URL base, SSL, logging, and system options. - **Site Tunnel** - Manage the persistent websocket tunnel to notifiarr.com. Select primary and backup tunnels. - **Starr Apps** - Configure Radarr, Sonarr, Lidarr, Readarr, and Prowlarr instances. -- **Download Apps** - Configure Deluge, qBittorrent, rTorrent, SABnzbd, NZBGet, and Transmission. Remote-playback turtle mode is toggled from Plex and Jellyfin Client Settings on the website; set the alternative limits in qBittorrent first. +- **Download Apps** - Configure Deluge, qBittorrent, rTorrent, SABnzbd, NZBGet, and Transmission. Remote-playback turtle mode is toggled from Plex, Jellyfin, and Emby Client Settings on the website; set the alternative limits in qBittorrent first. - **Media Apps** - Configure Plex and Tautulli. - **Snapshot Apps** - Configure MySQL and Nvidia GPU monitoring for snapshots. - **File Watcher** - Watch log files for lines matching regular expressions. diff --git a/docs/pages/integrations/emby.md b/docs/pages/integrations/emby.md index 0015136..91fa828 100644 --- a/docs/pages/integrations/emby.md +++ b/docs/pages/integrations/emby.md @@ -49,6 +49,20 @@ Click the **cog icon** to open the configuration options for Emby. - `Unmonitor movies on finish` - Automatically unmonitor a movie after a user finishes watching (Patron feature, requires valid Radarr information in client) - `Unmonitor episodes on finish` - Automatically unmonitor an episode after a user finishes watching (Patron feature, requires valid Sonarr information in client) +### Client Settings + +The same **qBittorrent Speed Limit** block is on Plex, Jellyfin, and Emby Client Settings so saving any of those pages keeps the others. + +1. `Enabled` - Turn on qBittorrent alternative (turtle) speed limits when remote playback is active. Set the alternative limits in qBittorrent first. +1. `Plex WAN` - Throttle while a Plex movie or episode is playing or paused on WAN (not LAN). +1. `Jellyfin` - Throttle on Jellyfin PlaybackStart and PlaybackStop for movies and episodes. +1. `Emby` - Throttle on Emby playback.start, playback.unpause, playback.stop, and playback.scrobble for movies and episodes. Pause does not turn turtle off. +1. `Cooldown` - How long to wait after remote playback ends before turning alternative speed limits back off. + +Emby webhooks include `Session.RemoteEndPoint`. If that IP is private (LAN or Docker), throttle is skipped. If the field is missing, throttle still runs. + +Plex uses WAN sessions on the client. Emby uses playback webhooks from the website. Plex and qBit must be on the same Notifiarr client. + --- ### Instructions diff --git a/docs/pages/integrations/jellyfin.md b/docs/pages/integrations/jellyfin.md index c877a77..702127f 100644 --- a/docs/pages/integrations/jellyfin.md +++ b/docs/pages/integrations/jellyfin.md @@ -41,16 +41,17 @@ Click the **cog icon** to open the configuration options for Jellyfin. ### Client Settings -The same **qBittorrent Speed Limit** block is on Plex and Jellyfin Client Settings so saving either page keeps the other. +The same **qBittorrent Speed Limit** block is on Plex, Jellyfin, and Emby Client Settings so saving any of those pages keeps the others. 1. `Enabled` - Turn on qBittorrent alternative (turtle) speed limits when remote playback is active. Set the alternative limits in qBittorrent first. 1. `Plex WAN` - Throttle while a Plex movie or episode is playing or paused on WAN (not LAN). 1. `Jellyfin` - Throttle on Jellyfin PlaybackStart and PlaybackStop for movies and episodes. +1. `Emby` - Throttle on Emby playback.start, playback.unpause, playback.stop, and playback.scrobble for movies and episodes. Pause does not turn turtle off. 1. `Cooldown` - How long to wait after remote playback ends before turning alternative speed limits back off. Jellyfin webhooks usually do not include LAN vs WAN. If `RemoteEndPoint` is present and is a private IP, throttle is skipped. If the field is missing, throttle still runs. -Plex uses WAN sessions on the client. Jellyfin uses playback webhooks from the website. Plex and qBit must be on the same Notifiarr client. +Plex uses WAN sessions on the client. Jellyfin and Emby use playback webhooks from the website. Plex and qBit must be on the same Notifiarr client. ### Notifiarr diff --git a/docs/pages/integrations/plex.md b/docs/pages/integrations/plex.md index 31141af..8634593 100644 --- a/docs/pages/integrations/plex.md +++ b/docs/pages/integrations/plex.md @@ -137,6 +137,7 @@ Additional settings such as automatically unmonitor an episode or movie once a u - `Enabled` - Master switch for this feature. - `Plex WAN` - Throttle while a Plex movie or episode is playing or paused on WAN (not LAN). - `Jellyfin` - Throttle on Jellyfin PlaybackStart for movies and episodes. + - `Emby` - Throttle on Emby playback.start and playback.stop for movies and episodes. Pause does not turn turtle off. - `Cooldown` - How long to wait after remote playback ends before turning alternative speed limits back off. The client only turns turtle mode off if it turned turtle mode on. If alternative limits were already enabled in qBittorrent, they stay on when playback ends.