feat(torrents): support new share limit parameters

Author: martylukyy

documentation/docs/advanced/compatibility.md

@@ -26,6 +26,7 @@ qui automatically detects the features available on each qBittorrent instance an
 | **Path Autocomplete** | 5.0.0+ (Web API 2.11.2+) | Autocomplete suggestions for path inputs when adding torrents or creating .torrent files |
 | **External IP Reporting (IPv4/IPv6)** | 5.1.0+ (Web API 2.11.3+) | Exposes `last_external_address_v4` / `_v6` fields |
 | **Tracker Health Status** | 5.1.0+ (Web API 2.11.4+) | Automatically detects unregistered torrents and tracker issues |
+| **Share Limit Action & Mode** | 5.2.0+ (Web API 2.15.3+) | Per-torrent action when share limits are reached (stop, remove, remove with content, enable super seeding) and matching mode (any vs all) |
 
 :::note
 Hybrid and v2 torrent creation requires a qBittorrent build that links against libtorrent v2. Builds compiled with libtorrent 1.x ignore the `format` parameter.

documentation/docs/features/automations.md

@@ -436,6 +436,30 @@ Set ratio limit and/or seeding time limit. Each field supports these modes:
 
 Torrents stop seeding when any enabled limit is reached.
 
+#### Share Limit Action & Mode (qBittorrent 5.2+)
+
+On qBittorrent 5.2 and newer (Web API 2.15.3+), two additional per-torrent settings are available:
+
+**When limits are reached** controls what happens when a torrent's share limits are hit:
+
+| Option                  | Value | Description                                 |
+| ----------------------- | ----- | ------------------------------------------- |
+| Default (use global)    | -1    | Follow qBittorrent's global setting         |
+| Stop torrent            | 0     | Pause the torrent                           |
+| Remove torrent          | 1     | Remove from client, keep files              |
+| Enable super seeding    | 2     | Switch to super seeding mode                |
+| Remove with content     | 3     | Remove from client and delete files         |
+
+**Limits matching mode** controls whether the action triggers when *any* limit is reached or only when *all* limits are reached:
+
+| Option                  | Value | Description                                 |
+| ----------------------- | ----- | ------------------------------------------- |
+| Default (use global)    | -1    | Follow qBittorrent's global setting         |
+| Match any limit         | 0     | Trigger when any single limit is reached    |
+| Match all limits        | 1     | Trigger only when all limits are reached    |
+
+These fields appear in both the torrent share limit dialog and the automation workflow editor when the connected qBittorrent instance supports them. On older instances, the fields are hidden and only the classic ratio/seeding time limits are sent.
+
 ### Pause
 
 Pause matching torrents. Only pauses if not already stopped.

go.mod

@@ -11,7 +11,7 @@ require (
 	github.com/andybalholm/brotli v1.2.1
 	github.com/autobrr/autobrr v1.77.0
 	github.com/autobrr/go-mediainfo v0.3.1
-	github.com/autobrr/go-qbittorrent v1.15.1-0.20260506110806-0f6206131e7a
+	github.com/autobrr/go-qbittorrent v1.15.1-0.20260511072703-cba7da3ac836
 	github.com/avast/retry-go v3.0.0+incompatible
 	github.com/cespare/xxhash/v2 v2.3.0
 	github.com/coreos/go-oidc/v3 v3.18.0

go.sum

@@ -61,8 +61,8 @@ github.com/autobrr/autobrr v1.77.0 h1:0SNa9g2mk5Qe92vHOt0eJJz7VHB515R/BZyy1fCzik
 github.com/autobrr/autobrr v1.77.0/go.mod h1:GstQT2UumxQE54ECtjl5jwdzenaGFzvWxVNEVoLWH4E=
 github.com/autobrr/go-mediainfo v0.3.1 h1:4gT1qoIKp4e+9X7PA/YO53lEkylY+GubFhCl8u8o1R4=
 github.com/autobrr/go-mediainfo v0.3.1/go.mod h1:xVXgHDAYYpIeGQCQCdTBpoiY/O3tojJfflK+rrbzclQ=
-github.com/autobrr/go-qbittorrent v1.15.1-0.20260506110806-0f6206131e7a h1:bWzZDGbwP72DxYSP9+ab68bmEYxf2FKV3LsklFrNt2s=
-github.com/autobrr/go-qbittorrent v1.15.1-0.20260506110806-0f6206131e7a/go.mod h1:W/24JQyQI+u5KntK1qzkBC/7amOTBPpV+q5e3C+kCkY=
+github.com/autobrr/go-qbittorrent v1.15.1-0.20260511072703-cba7da3ac836 h1:sgOAVRXsaMnL9f8kaQgFNQPU0xQCE0MzH9qUuN46qec=
+github.com/autobrr/go-qbittorrent v1.15.1-0.20260511072703-cba7da3ac836/go.mod h1:W/24JQyQI+u5KntK1qzkBC/7amOTBPpV+q5e3C+kCkY=
 github.com/autobrr/rls v0.8.0 h1:Odz78o5nfrO4hsQ17qiuyKYtiG97+Cs5nrD9TFk8/lI=
 github.com/autobrr/rls v0.8.0/go.mod h1:11YJWgNe5H+UQrfFaNGjnkEy0OEsMFnmV4IL2tRKpPk=
 github.com/avast/retry-go v3.0.0+incompatible h1:4SOWQ7Qs+oroOTQOYnAHqelpCO0biHSxpiH9JdtuBj0=

internal/api/handlers/capabilities.go

@@ -25,6 +25,7 @@ type InstanceCapabilitiesResponse struct {
 	SupportsPathAutocomplete    bool   `json:"supportsPathAutocomplete"`
 	SupportsFreeSpacePathSource bool   `json:"supportsFreeSpacePathSource"`
 	SupportsSetRSSFeedURL       bool   `json:"supportsSetRSSFeedURL"`
+	SupportsShareLimits         bool   `json:"supportsShareLimits"`
 	WebAPIVersion               string `json:"webAPIVersion,omitempty"`
 }
 
@@ -45,6 +46,7 @@ func NewInstanceCapabilitiesResponse(client *internalqbittorrent.Client) Instanc
 		SupportsPathAutocomplete:    client.SupportsPathAutocomplete(),
 		SupportsFreeSpacePathSource: runtime.GOOS != osWindows,
 		SupportsSetRSSFeedURL:       client.SupportsSetRSSFeedURL(),
+		SupportsShareLimits:         client.SupportsShareLimits(),
 	}
 
 	if version := client.GetWebAPIVersion(); version != "" {

internal/api/handlers/torrents.go

@@ -1064,6 +1064,8 @@ type BulkActionRequest struct {
 	RatioLimit               float64                    `json:"ratioLimit,omitempty"`               // For setShareLimit action
 	SeedingTimeLimit         int64                      `json:"seedingTimeLimit,omitempty"`         // For setShareLimit action
 	InactiveSeedingTimeLimit int64                      `json:"inactiveSeedingTimeLimit,omitempty"` // For setShareLimit action
+	ShareLimitAction         string                     `json:"shareLimitAction,omitempty"`         // For setShareLimit action (qBittorrent 5.2+)
+	ShareLimitsMode          string                     `json:"shareLimitsMode,omitempty"`          // For setShareLimit action (qBittorrent 5.2+)
 	UploadLimit              int64                      `json:"uploadLimit,omitempty"`              // For setUploadLimit action (KB/s)
 	DownloadLimit            int64                      `json:"downloadLimit,omitempty"`            // For setDownloadLimit action (KB/s)
 	Location                 string                     `json:"location,omitempty"`                 // For setLocation action
@@ -1584,7 +1586,7 @@ func (h *TorrentsHandler) executeBulkActionForInstance(ctx context.Context, inst
 	case "forceStart":
 		return h.syncManager.SetForceStart(ctx, instanceID, hashes, req.Enable)
 	case "setShareLimit":
-		return h.syncManager.SetTorrentShareLimit(ctx, instanceID, hashes, req.RatioLimit, req.SeedingTimeLimit, req.InactiveSeedingTimeLimit)
+		return h.syncManager.SetTorrentShareLimit(ctx, instanceID, hashes, req.RatioLimit, req.SeedingTimeLimit, req.InactiveSeedingTimeLimit, req.ShareLimitAction, req.ShareLimitsMode)
 	case "setUploadLimit":
 		return h.syncManager.SetTorrentUploadLimit(ctx, instanceID, hashes, req.UploadLimit)
 	case "setDownloadLimit":

internal/models/automation.go

@@ -884,6 +884,8 @@ type ShareLimitsAction struct {
 	Enabled            bool           `json:"enabled"`
 	RatioLimit         *float64       `json:"ratioLimit,omitempty"`
 	SeedingTimeMinutes *int64         `json:"seedingTimeMinutes,omitempty"`
+	ShareLimitAction   *string        `json:"shareLimitAction,omitempty"`
+	ShareLimitsMode    *string        `json:"shareLimitsMode,omitempty"`
 	Condition          *RuleCondition `json:"condition,omitempty"`
 }
 

internal/qbittorrent/client.go

@@ -31,6 +31,7 @@ var (
 	torrentTmpPathMinVersion   = semver.MustParse("2.8.4")
 	pathAutocompleteMinVersion = semver.MustParse("2.11.2")
 	rssSetFeedURLMinVersion    = semver.MustParse("2.9.1")
+	shareLimitsMinVersion      = semver.MustParse("2.15.3")
 )
 
 type Client struct {
@@ -50,6 +51,7 @@ type Client struct {
 	supportsPathAutocomplete bool
 	trackerIncludeSupported  bool
 	supportsSetRSSFeedURL    bool
+	supportsShareLimits      bool
 	lastHealthCheck          time.Time
 	isHealthy                bool
 	syncManager              *qbt.SyncManager
@@ -268,6 +270,7 @@ func (c *Client) applyCapabilitiesLocked(version string) {
 	c.supportsTorrentTmpPath = !v.LessThan(torrentTmpPathMinVersion)
 	c.supportsPathAutocomplete = !v.LessThan(pathAutocompleteMinVersion)
 	c.supportsSetRSSFeedURL = !v.LessThan(rssSetFeedURLMinVersion)
+	c.supportsShareLimits = !v.LessThan(shareLimitsMinVersion)
 }
 
 // UpdateWithPeersData triggers a sync on the peer manager to keep it warm after intercepting peer data
@@ -384,6 +387,12 @@ func (c *Client) SupportsSetRSSFeedURL() bool {
 	return c.supportsSetRSSFeedURL
 }
 
+func (c *Client) SupportsShareLimits() bool {
+	c.mu.RLock()
+	defer c.mu.RUnlock()
+	return c.supportsShareLimits
+}
+
 func (c *Client) GetWebAPIVersion() string {
 	c.mu.RLock()
 	defer c.mu.RUnlock()

internal/qbittorrent/sync_manager.go

@@ -5636,8 +5636,9 @@ func (sm *SyncManager) GetActiveTrackers(ctx context.Context, instanceID int) (m
 	return trackerMap, nil
 }
 
-// SetTorrentShareLimit sets share limits (ratio, seeding time) for torrents
-func (sm *SyncManager) SetTorrentShareLimit(ctx context.Context, instanceID int, hashes []string, ratioLimit float64, seedingTimeLimit, inactiveSeedingTimeLimit int64) error {
+// SetTorrentShareLimit sets share limits (ratio, seeding time, action, mode) for torrents.
+// shareLimitAction and shareLimitsMode are only sent when the instance supports them (webAPI >= 2.15.3).
+func (sm *SyncManager) SetTorrentShareLimit(ctx context.Context, instanceID int, hashes []string, ratioLimit float64, seedingTimeLimit, inactiveSeedingTimeLimit int64, shareLimitAction, shareLimitsMode string) error {
 	// Get client and sync manager
 	client, _, err := sm.getClientAndSyncManager(ctx, instanceID)
 	if err != nil {
@@ -5649,7 +5650,14 @@ func (sm *SyncManager) SetTorrentShareLimit(ctx context.Context, instanceID int,
 		return err
 	}
 
-	if err := client.SetTorrentShareLimitCtx(ctx, hashes, ratioLimit, seedingTimeLimit, inactiveSeedingTimeLimit); err != nil {
+	action := shareLimitAction
+	mode := shareLimitsMode
+	if !client.SupportsShareLimits() {
+		action = ""
+		mode = ""
+	}
+
+	if err := client.SetTorrentShareLimitCtx(ctx, hashes, ratioLimit, seedingTimeLimit, inactiveSeedingTimeLimit, action, mode); err != nil {
 		return fmt.Errorf("failed to set torrent share limit: %w", err)
 	}
 

internal/services/automations/processor.go

@@ -33,10 +33,12 @@ type torrentDesiredState struct {
 	downloadRule     ruleRef
 
 	// Share limits (last rule wins)
-	ratioLimit     *float64
-	seedingMinutes *int64
-	ratioRule      ruleRef
-	seedingRule    ruleRef
+	ratioLimit       *float64
+	seedingMinutes   *int64
+	shareLimitAction string
+	shareLimitsMode  string
+	ratioRule        ruleRef
+	seedingRule      ruleRef
 
 	// Pause (OR - any rule can trigger)
 	shouldPause bool
@@ -304,6 +306,12 @@ func processRuleForTorrent(rule *models.Automation, torrent qbt.Torrent, state *
 				state.seedingMinutes = conditions.ShareLimits.SeedingTimeMinutes
 				state.seedingRule = ruleRef{id: rule.ID, name: rule.Name}
 			}
+			if conditions.ShareLimits.ShareLimitAction != nil {
+				state.shareLimitAction = *conditions.ShareLimits.ShareLimitAction
+			}
+			if conditions.ShareLimits.ShareLimitsMode != nil {
+				state.shareLimitsMode = *conditions.ShareLimits.ShareLimitsMode
+			}
 		} else if stats != nil {
 			stats.ShareConditionNotMet++
 		}