From 9df2852299ca11c9aac181d81d451eedc6fce86e Mon Sep 17 00:00:00 2001
From: Deivid Soto <hello@torrentclaw.com>
Date: Sun, 14 Jun 2026 16:26:46 +0200
Subject: [PATCH] docs: document preferred_methods ordered download-method list

---
 README.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 75c9c62..593e104 100644
--- a/README.md
+++ b/README.md
@@ -463,7 +463,14 @@ name = "My PC"
 
 [downloads]
 dir = "~/Media"
-preferred_method = "auto"        # auto | torrent | debrid | usenet
+# Ordered download-method preference. The web honours this list, so anything NOT
+# listed is disabled — e.g. ["debrid"] means debrid-only and never falls back to
+# torrent; ["debrid","usenet"] tries debrid then usenet. Omit (or use ["auto"])
+# to let the server decide (default: auto / torrent-first). Debrid/usenet must be
+# configured in your TorrentClaw account — the agent only fetches links the web
+# resolves. Requires unarr >= 1.1.5-beta.
+preferred_methods = ["auto"]     # e.g. ["debrid"], ["debrid","usenet"], or ["auto"]
+# preferred_method = "auto"      # legacy single value (still supported; superseded by preferred_methods)
 max_concurrent = 3
 max_download_speed = "0"         # e.g. "10MB", "500KB", "0" = unlimited
 max_upload_speed = "0"