feat(crossseed): add custom category option for cross-seeds (#907)

Author: s0up4200

README.md

@@ -367,11 +367,9 @@ Downloaded backups can be imported into any qui instance. Useful for migrating t
 qui includes intelligent cross-seeding capabilities that help you automatically find and add matching torrents across different trackers. This allows you to seed the same content on multiple trackers.
 
 > [!NOTE]
-> qui adds cross-seeded torrents by inheriting the **Automatic Torrent Management (AutoTMM)** state from the matched torrent. If the matched torrent uses AutoTMM, the cross-seed will too; if the matched torrent has a custom save path (AutoTMM disabled), the cross-seed will use the same explicit path. This reuses existing files directly without creating hardlinks (unless [hardlink mode](#hardlink-mode-optional) is enabled).
+> For detailed information about category behavior, save paths, AutoTMM handling, hardlink mode, and best practices, see the [Cross-Seeding Guide](docs/CROSS_SEEDING.md).
 >
-> For detailed information about category behavior, save paths, hardlink mode, and best practices, see the [Cross-Seeding Guide](docs/CROSS_SEEDING.md).
->
-> If you see a cross-seed skipped with “extra files share pieces with content”, see the explanation and options in the guide.
+> If you see a cross-seed skipped with "extra files share pieces with content", see the explanation and options in the guide.
 
 ### Prerequisites
 
@@ -419,16 +417,6 @@ Right-click any torrent in the list to access cross-seed actions:
 - **Search Cross-Seeds** - Query indexers for matching torrents on other trackers
 - **Filter Cross-Seeds** - Show torrents in your library that share content with the selected torrent (useful for identifying existing cross-seeds)
 
-### How qui Differs from cross-seed
-
-qui takes a different approach than the [cross-seed](https://github.com/cross-seed/cross-seed) project:
-
-| Aspect | cross-seed | qui |
-|--------|-----------|-----|
-| **File handling** | Creates hardlinks/symlinks to a separate directory | Reuse mode (default) + optional hardlink mode |
-| **AutoTMM** | Disabled (uses explicit save paths) | Inherits from matched torrent (unless "Use indexer name as category" is enabled) |
-| **Category** | Uses dedicated `linkCategory` (e.g., "cross-seed-link") | Uses matched torrent's category with `.cross` suffix (configurable) |
-
 ### Rules
 
 Configure matching behavior in the **Rules** tab on the Cross-Seed page.
@@ -441,8 +429,11 @@ Configure matching behavior in the **Rules** tab on the Cross-Seed page.
 
 #### Categories
 
-- **Add .cross category suffix** (default: enabled) - Appends `.cross` to cross-seed categories (e.g., `movies` → `movies.cross`). This prevents Sonarr/Radarr from importing cross-seeded files as duplicates, since *arr apps typically monitor specific categories. Disable this for full Automatic Torrent Management (AutoTMM) support where cross-seeds should use identical categories and save paths as the source torrent.
-- **Use indexer name as category** - Set the qBittorrent category to the indexer name instead of inheriting from the matched torrent. Uses explicit save paths, so AutoTMM is always disabled for these cross-seeds regardless of the source torrent's AutoTMM state (see [how qui differs from cross-seed](#how-qui-differs-from-cross-seed)). Mutually exclusive with `.cross` suffix.
+Choose one of three mutually exclusive category modes:
+
+- **Add .cross category suffix** (default) - Appends `.cross` to cross-seed categories (e.g., `movies` → `movies.cross`). Prevents Sonarr/Radarr from importing cross-seeded files as duplicates. AutoTMM is inherited from the matched torrent.
+- **Use indexer name as category** - Sets category to the indexer name (e.g., `TorrentDB`). AutoTMM is always disabled; uses explicit save paths.
+- **Custom category** - Uses a fixed category name for all cross-seeds (e.g., `cross-seed`). AutoTMM is always disabled; uses explicit save paths.
 
 #### Source Tagging
 

docs/CROSS_SEEDING.md

@@ -191,7 +191,9 @@ The piece-boundary safety check (if enabled) applies here too: if extra files sh
 
 ## Category Behavior
 
-### The .cross Suffix
+Cross-seeds can be assigned a category using one of three modes:
+
+### 1. Category Suffix (default)
 
 When enabled, cross-seeded torrents get a `.cross` suffix on their category:
 - Original torrent: `tv` category
@@ -201,15 +203,29 @@ When enabled, cross-seeded torrents get a `.cross` suffix on their category:
 
 The `.cross` category is created automatically with the same save path as the base category.
 
+### 2. Indexer Name as Category
+
+Uses the indexer name (from the search source) as the category. Useful for organizing cross-seeds by tracker.
+
+### 3. Custom Category
+
+Uses a user-specified static category name for all cross-seeds. No suffix is applied—the exact category name you enter is used.
+
 ### autoTMM (Auto Torrent Management)
 
-Cross-seeds inherit the autoTMM setting from the matched torrent:
+autoTMM behavior depends on which category mode is active:
+
+| Category Mode | autoTMM Behavior |
+|---------------|------------------|
+| **Suffix** (`.cross`) | Inherited from matched torrent |
+| **Indexer name** | Always disabled (explicit save paths) |
+| **Custom** | Always disabled (explicit save paths) |
+
+When autoTMM is inherited (suffix mode):
 - If matched torrent uses autoTMM, cross-seed uses autoTMM
 - If matched torrent has manual path, cross-seed uses same manual path
 
-This ensures files are always saved to the correct location.
-
-**Note:** When "Use indexer name as category" is enabled, autoTMM is always disabled for cross-seeds (explicit save paths are used instead).
+When autoTMM is disabled (indexer/custom modes), cross-seeds always use explicit save paths derived from the matched torrent's location.
 
 ## Save Path Determination
 
@@ -284,9 +300,9 @@ The incoming torrent has files not present in your matched torrent, and those fi
 
 ### autoTMM unexpectedly enabled/disabled
 
-- This mirrors the matched torrent's setting (intentional)
+- In suffix mode, autoTMM mirrors the matched torrent's setting (intentional)
+- In indexer name or custom category mode, autoTMM is always disabled
 - Check the original torrent's autoTMM status in qBittorrent
-- Note: "Use indexer name as category" always disables autoTMM
 
 ## ARR Integration (Sonarr/Radarr)
 

internal/database/migrations/046_add_cross_seed_custom_category.sql

@@ -0,0 +1,6 @@
+-- Add custom category option for cross-seeds
+-- When use_custom_category is TRUE, cross-seeds use the exact custom_category value
+-- without any automatic suffixing
+
+ALTER TABLE cross_seed_settings ADD COLUMN use_custom_category BOOLEAN NOT NULL DEFAULT 0;
+ALTER TABLE cross_seed_settings ADD COLUMN custom_category TEXT DEFAULT '';

internal/models/crossseed.go

@@ -59,6 +59,10 @@ type CrossSeedAutomationSettings struct {
 	// Category isolation: add .cross suffix to prevent *arr import loops
 	UseCrossCategorySuffix bool `json:"useCrossCategorySuffix"` // Add .cross suffix to categories (e.g., movies → movies.cross)
 
+	// Custom category: use exact user-specified category without any suffixing
+	UseCustomCategory bool   `json:"useCustomCategory"` // Use custom category instead of suffix or indexer name
+	CustomCategory    string `json:"customCategory"`    // Custom category name when UseCustomCategory is true
+
 	// Skip auto-resume settings per source mode.
 	// When enabled, torrents remain paused after hash check instead of auto-resuming.
 	SkipAutoResumeRSS            bool `json:"skipAutoResumeRss"`            // Skip auto-resume for RSS automation results
@@ -115,6 +119,9 @@ func DefaultCrossSeedAutomationSettings() *CrossSeedAutomationSettings {
 		InheritSourceTags:    false, // Don't copy source torrent tags by default
 		// Category isolation - default to true for backwards compatibility
 		UseCrossCategorySuffix: true,
+		// Custom category - default to false (use suffix mode by default)
+		UseCustomCategory: false,
+		CustomCategory:    "",
 		// Skip auto-resume - default to false to preserve existing behavior
 		SkipAutoResumeRSS:            false,
 		SkipAutoResumeSeededSearch:   false,
@@ -299,6 +306,7 @@ func (s *CrossSeedStore) GetSettings(ctx context.Context) (*CrossSeedAutomationS
 		       use_category_from_indexer, run_external_program_id,
 		       rss_automation_tags, seeded_search_tags, completion_search_tags,
 		       webhook_tags, inherit_source_tags, use_cross_category_suffix,
+		       use_custom_category, custom_category,
 		       skip_auto_resume_rss, skip_auto_resume_seeded_search,
 		       skip_auto_resume_completion, skip_auto_resume_webhook,
 		       skip_recheck, skip_piece_boundary_safety_check,
@@ -349,6 +357,8 @@ func (s *CrossSeedStore) GetSettings(ctx context.Context) (*CrossSeedAutomationS
 		&webhookTags,
 		&settings.InheritSourceTags,
 		&settings.UseCrossCategorySuffix,
+		&settings.UseCustomCategory,
+		&settings.CustomCategory,
 		&settings.SkipAutoResumeRSS,
 		&settings.SkipAutoResumeSeededSearch,
 		&settings.SkipAutoResumeCompletion,
@@ -526,12 +536,13 @@ func (s *CrossSeedStore) UpsertSettings(ctx context.Context, settings *CrossSeed
 			use_category_from_indexer, run_external_program_id,
 			rss_automation_tags, seeded_search_tags, completion_search_tags,
 			webhook_tags, inherit_source_tags, use_cross_category_suffix,
+			use_custom_category, custom_category,
 			skip_auto_resume_rss, skip_auto_resume_seeded_search,
 			skip_auto_resume_completion, skip_auto_resume_webhook,
 			skip_recheck, skip_piece_boundary_safety_check,
 			use_hardlinks, hardlink_base_dir, hardlink_dir_preset
 		) VALUES (
-			?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?
+			?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?
 		)
 		ON CONFLICT(id) DO UPDATE SET
 			enabled = excluded.enabled,
@@ -560,6 +571,8 @@ func (s *CrossSeedStore) UpsertSettings(ctx context.Context, settings *CrossSeed
 			webhook_tags = excluded.webhook_tags,
 			inherit_source_tags = excluded.inherit_source_tags,
 			use_cross_category_suffix = excluded.use_cross_category_suffix,
+			use_custom_category = excluded.use_custom_category,
+			custom_category = excluded.custom_category,
 			skip_auto_resume_rss = excluded.skip_auto_resume_rss,
 			skip_auto_resume_seeded_search = excluded.skip_auto_resume_seeded_search,
 			skip_auto_resume_completion = excluded.skip_auto_resume_completion,
@@ -615,6 +628,8 @@ func (s *CrossSeedStore) UpsertSettings(ctx context.Context, settings *CrossSeed
 		webhookTags,
 		settings.InheritSourceTags,
 		settings.UseCrossCategorySuffix,
+		settings.UseCustomCategory,
+		settings.CustomCategory,
 		settings.SkipAutoResumeRSS,
 		settings.SkipAutoResumeSeededSearch,
 		settings.SkipAutoResumeCompletion,

internal/services/crossseed/auto_tmm_test.go

@@ -12,6 +12,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 		crossCategory          string
 		matchedAutoManaged     bool
 		useCategoryFromIndexer bool
+		useCustomCategory      bool
 		actualCategorySavePath string
 		matchedSavePath        string
 		wantEnabled            bool
@@ -22,6 +23,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "tv.cross",
 			matchedAutoManaged:     true,
 			useCategoryFromIndexer: false,
+			useCustomCategory:      false,
 			actualCategorySavePath: "/downloads/tv",
 			matchedSavePath:        "/downloads/tv",
 			wantEnabled:            true,
@@ -32,6 +34,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "",
 			matchedAutoManaged:     true,
 			useCategoryFromIndexer: false,
+			useCustomCategory:      false,
 			actualCategorySavePath: "/downloads/tv",
 			matchedSavePath:        "/downloads/tv",
 			wantEnabled:            false,
@@ -42,6 +45,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "tv.cross",
 			matchedAutoManaged:     false,
 			useCategoryFromIndexer: false,
+			useCustomCategory:      false,
 			actualCategorySavePath: "/downloads/tv",
 			matchedSavePath:        "/downloads/tv",
 			wantEnabled:            false,
@@ -52,6 +56,18 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "tv.cross",
 			matchedAutoManaged:     true,
 			useCategoryFromIndexer: true,
+			useCustomCategory:      false,
+			actualCategorySavePath: "/downloads/tv",
+			matchedSavePath:        "/downloads/tv",
+			wantEnabled:            false,
+			wantPathsMatch:         true,
+		},
+		{
+			name:                   "using custom category - disabled",
+			crossCategory:          "cross-seed",
+			matchedAutoManaged:     true,
+			useCategoryFromIndexer: false,
+			useCustomCategory:      true,
 			actualCategorySavePath: "/downloads/tv",
 			matchedSavePath:        "/downloads/tv",
 			wantEnabled:            false,
@@ -62,6 +78,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "tv.cross",
 			matchedAutoManaged:     true,
 			useCategoryFromIndexer: false,
+			useCustomCategory:      false,
 			actualCategorySavePath: "/downloads/tv",
 			matchedSavePath:        "/downloads/movies",
 			wantEnabled:            true,
@@ -72,6 +89,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "tv.cross",
 			matchedAutoManaged:     true,
 			useCategoryFromIndexer: false,
+			useCustomCategory:      false,
 			actualCategorySavePath: "",
 			matchedSavePath:        "/downloads/tv",
 			wantEnabled:            true,
@@ -82,6 +100,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "tv.cross",
 			matchedAutoManaged:     true,
 			useCategoryFromIndexer: false,
+			useCustomCategory:      false,
 			actualCategorySavePath: "/downloads/tv",
 			matchedSavePath:        "",
 			wantEnabled:            true,
@@ -92,6 +111,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "tv.cross",
 			matchedAutoManaged:     true,
 			useCategoryFromIndexer: false,
+			useCustomCategory:      false,
 			actualCategorySavePath: "",
 			matchedSavePath:        "",
 			wantEnabled:            true,
@@ -102,6 +122,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "tv.cross",
 			matchedAutoManaged:     true,
 			useCategoryFromIndexer: false,
+			useCustomCategory:      false,
 			actualCategorySavePath: "/downloads/tv/",
 			matchedSavePath:        "/downloads/tv",
 			wantEnabled:            true,
@@ -112,6 +133,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "tv.cross",
 			matchedAutoManaged:     true,
 			useCategoryFromIndexer: false,
+			useCustomCategory:      false,
 			actualCategorySavePath: "C:\\downloads\\tv",
 			matchedSavePath:        "C:/downloads/tv",
 			wantEnabled:            true,
@@ -122,6 +144,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 			crossCategory:          "",
 			matchedAutoManaged:     false,
 			useCategoryFromIndexer: true,
+			useCustomCategory:      false,
 			actualCategorySavePath: "",
 			matchedSavePath:        "",
 			wantEnabled:            false,
@@ -135,6 +158,7 @@ func TestShouldEnableAutoTMM(t *testing.T) {
 				tt.crossCategory,
 				tt.matchedAutoManaged,
 				tt.useCategoryFromIndexer,
+				tt.useCustomCategory,
 				tt.actualCategorySavePath,
 				tt.matchedSavePath,
 			)

internal/services/crossseed/service.go

@@ -2958,10 +2958,11 @@ func (s *Service) processCrossSeedCandidate(
 		options["contentLayout"] = "Original"
 	}
 
-	// Check if UseCategoryFromIndexer is enabled (affects TMM decision)
-	var useCategoryFromIndexer bool
+	// Check if UseCategoryFromIndexer or UseCustomCategory is enabled (affects TMM decision)
+	var useCategoryFromIndexer, useCustomCategory bool
 	if settings, err := s.GetAutomationSettings(ctx); err == nil && settings != nil {
 		useCategoryFromIndexer = settings.UseCategoryFromIndexer
+		useCustomCategory = settings.UseCustomCategory
 	}
 
 	// Determine save path strategy:
@@ -3015,7 +3016,7 @@ func (s *Service) processCrossSeedCandidate(
 		}
 
 		// Evaluate whether autoTMM should be enabled
-		tmmDecision := shouldEnableAutoTMM(crossCategory, matchedTorrent.AutoManaged, useCategoryFromIndexer, actualCategorySavePath, props.SavePath)
+		tmmDecision := shouldEnableAutoTMM(crossCategory, matchedTorrent.AutoManaged, useCategoryFromIndexer, useCustomCategory, actualCategorySavePath, props.SavePath)
 		if forceManualSavePath {
 			tmmDecision.Enabled = false
 		}
@@ -3025,6 +3026,7 @@ func (s *Service) processCrossSeedCandidate(
 			Str("crossCategory", tmmDecision.CrossCategory).
 			Bool("matchedAutoManaged", tmmDecision.MatchedAutoManaged).
 			Bool("useIndexerCategory", tmmDecision.UseIndexerCategory).
+			Bool("useCustomCategory", tmmDecision.UseCustomCategory).
 			Str("categorySavePath", tmmDecision.CategorySavePath).
 			Str("matchedSavePath", tmmDecision.MatchedSavePath).
 			Bool("pathsMatch", tmmDecision.PathsMatch).
@@ -7148,6 +7150,7 @@ type autoTMMDecision struct {
 	CrossCategory      string
 	MatchedAutoManaged bool
 	UseIndexerCategory bool
+	UseCustomCategory  bool
 	CategorySavePath   string
 	MatchedSavePath    string
 	PathsMatch         bool
@@ -7157,29 +7160,31 @@ type autoTMMDecision struct {
 // autoTMM can only be enabled when:
 // - A cross-seed category was successfully created (crossCategory != "")
 // - The matched torrent uses autoTMM
-// - Not using indexer categories (which may have different paths)
+// - Not using indexer categories or custom categories (which may have different paths)
 //
 // We trust qBittorrent's implicit path calculation when categories don't have explicit
 // save paths configured. If the matched torrent is using autoTMM successfully, the
 // cross-seed should inherit that setting.
 //
 // Returns the decision struct for logging and whether autoTMM should be enabled.
-func shouldEnableAutoTMM(crossCategory string, matchedAutoManaged bool, useCategoryFromIndexer bool, actualCategorySavePath string, matchedSavePath string) autoTMMDecision {
+func shouldEnableAutoTMM(crossCategory string, matchedAutoManaged bool, useCategoryFromIndexer bool, useCustomCategory bool, actualCategorySavePath string, matchedSavePath string) autoTMMDecision {
 	// Check if explicit category save path matches the matched torrent's path (informational).
 	pathsMatch := actualCategorySavePath != "" && matchedSavePath != "" &&
 		normalizePath(actualCategorySavePath) == normalizePath(matchedSavePath)
 
-	// Enable autoTMM if the matched torrent uses autoTMM and we're not using indexer categories.
+	// Enable autoTMM if the matched torrent uses autoTMM and we're not using indexer or custom categories.
 	// When a category has no explicit save path, qBittorrent uses an implicit path:
 	// <default_save_path>/<category_name>. Since the matched torrent is already using
 	// autoTMM successfully at its current path, the cross-seed should too.
-	enabled := crossCategory != "" && matchedAutoManaged && !useCategoryFromIndexer
+	// Custom categories disable autoTMM like indexer categories for safety.
+	enabled := crossCategory != "" && matchedAutoManaged && !useCategoryFromIndexer && !useCustomCategory
 
 	return autoTMMDecision{
 		Enabled:            enabled,
 		CrossCategory:      crossCategory,
 		MatchedAutoManaged: matchedAutoManaged,
 		UseIndexerCategory: useCategoryFromIndexer,
+		UseCustomCategory:  useCustomCategory,
 		CategorySavePath:   actualCategorySavePath,
 		MatchedSavePath:    matchedSavePath,
 		PathsMatch:         pathsMatch,
@@ -7317,6 +7322,11 @@ func (s *Service) determineCrossSeedCategory(ctx context.Context, req *CrossSeed
 		settings, _ = s.GetAutomationSettings(ctx)
 	}
 
+	// Custom category takes priority - use exact category without any suffix
+	if settings != nil && settings.UseCustomCategory && settings.CustomCategory != "" {
+		return settings.CustomCategory, settings.CustomCategory
+	}
+
 	// Helper to apply .cross suffix only if enabled in settings
 	applySuffix := func(cat string) string {
 		if settings != nil && !settings.UseCrossCategorySuffix {

web/package.json

@@ -32,6 +32,7 @@
     "@radix-ui/react-label": "^2.1.8",
     "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-progress": "^1.1.8",
+    "@radix-ui/react-radio-group": "^1.3.8",
     "@radix-ui/react-scroll-area": "^1.2.10",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-separator": "^1.1.8",