TRANSMISSION-REMOTE(1) General Commands Manual TRANSMISSION-REMOTE(1)

transmission-remote — ابزار کنترل از راه دور برای transmission-daemon(1) و transmission(1)

transmission-remote [host:port | host | port] [-a filenames-or-URLs] [-as] [-AS] [-asd number] [-asu number] [-asc] [-ASC] [-b] [-c path | -C] [-d number | -D] [-e size] [-er | -ep | -et] [--exit] [-f] [-F filter] [-g files] [-G files] [-gisl number] [-GISL number] [-gsr ratio] [-GSR] [-h] [-i] [-ic] [-ids] [-if] [-ip] [-isl number] [-ISL number] [-isld] [-it] [-j] [-l] [-m | -M] [-n user:pass] [-ne] [-N netrc] [-o | -O] [-p port] [-Bh] [-Bn] [-Bl] [-ph files] [-pl files] [-pn files] [-pr peers] [-r] [-rad] [-s | -S] [-sr ratio] [-SR] [-srd] [-si] [-st] [-t all | active | id | hash] [-hl] [-HL] [-u number | -U] [-utp | -no-utp] [-v] [-V] [-w download-dir] [-x | -X] [-y | -Y] [-pi]

transmission-remote یک ابزار کنترل از راه دور برای transmission(1) و transmission-daemon(1) است.

به‌طور پیش‌فرض، transmission-remote به نشست transmission در localhost:9091 متصل می‌شود. سایر نشست‌ها را می‌توان با مشخص کردن یک میزبان و/یا درگاه متفاوت کنترل کرد..Sh "گزینه‌ها (OPTIONS)"

--add filenames-or-URLs
افزودن تورنت‌ها به transmission.
--debug
فعال‌سازی حالت اشکال‌زدایی.
--alt-speed
استفاده از محدودیت‌های جایگزین.
--no-alt-speed
عدم استفاده از محدودیت‌های جایگزین.
--alt-speed-downlimit limit
محدود کردن سرعت بارگیری جایگزین به limit کیلوبایت بر ثانیه.
--alt-speed-uplimit limit
محدود کردن سرعت بارگذاری جایگزین به limit کیلوبایت بر ثانیه.
--alt-speed-scheduler
استفاده از زمان‌های روشن/خاموش زمان‌بندی‌شده.
--no-alt-speed-scheduler
عدم استفاده از روزها و زمان‌های روشن/خاموش زمان‌بندی‌شده.
time
time برای شروع استفاده از محدودیت‌های سرعت جایگزین (به قالب hhmm).
time
time برای پایان استفاده از محدودیت‌های سرعت جایگزین (به قالب hhmm).
days
تنظیم تعداد days (روزها) که زمان‌بند سرعت در آن‌ها فعال باشد، با استفاده از فهرستی مانند “2,4-6”.
filename
مشخص کردن یک file برای اجرا در زمان اتمام هر تورنت.
عدم اجرای هیچ اسکریپتی پس از اتمام تورنت.
--incomplete-dir dir
هنگام افزودن تورنت‌های جدید، ذخیره کردن محتوای آن‌ها در directory تا زمانی که تورنت به اتمام برسد.
--no-incomplete-dir
عدم ذخیرهٔ تورنت‌های ناقص در دایرکتوری جداگانه.
--downlimit limit
محدود کردن بیشینهٔ سرعت بارگیری به limit کیلوبایت بر ثانیه (kB/s). اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها اثر می‌گذارد؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
--no-downlimit
غیرفعال‌سازی محدودیت‌های سرعت بارگیری. اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها اثر می‌گذارد؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
--cache size
تنظیم بیشینهٔ اندازهٔ حافظهٔ نهان نشست بر حسب مبی‌بایت (MiB). این حافظهٔ نهان برای کاهش ورودی/خروجی دیسک استفاده می‌شود.
--encryption-required
رمزنگاری تمام اتصالات با همتاها.
--encryption-preferred
ترجیح دادن اتصالات رمزنگاری‌شده با همتاها.
--encryption-tolerated
ترجیح دادن اتصالات رمزنگاری‌نشده با همتاها.
درخواست از Transmission برای بستن و خروج از برنامه.
--files
دریافت فهرست فایل‌ها برای تورنت(های) فعلی.
--get all | file-index | files
علامت‌گذاری فایل(ها) برای بارگیری. all تمام فایل‌های تورنت را برای بارگیری علامت می‌زند، file-index یک فایل تکی را به فهرست بارگیری اضافه می‌کند، و files چندین فایل را به فهرست بارگیری می‌افزاید، مانند “-g1,3-5” برای افزودن فایل‌های شمارهٔ ۱، ۳، ۴ و ۵ به فهرست بارگیری.
--filter filter
فیلتر کردن تورنت‌های انتخاب‌شده. دستورهای بعدی تنها از تورنت‌هایی استفاده خواهند کرد که شرایط فیلتر را برآورده کنند.
i - هم‌اکنون بیکار
u - هم‌اکنون در حال بارگذاری
d - هم‌اکنون در حال بارگیری
n:str - نام تورنت شامل str باشد
l:label - دارای برچسب label باشد
r:ratio - حداقل نسبت بارگذاری
w - دارای برخی فایل‌های ناخواسته باشد
قرار دادن پیشوند “~” قبل از فیلتر، آن را نفی می‌کند. گزینهٔ -F می‌تواند بیش از یک بار مشخص شود و ممکن است پیش از آن -t بیاید. تنها تورنت‌هایی انتخاب می‌شوند که تمام شرایط را برآورده کنند.
--no-get all | file-index | files
علامت‌گذاری فایل(ها) برای بارگیری نشدن.
--global-seedratio ratio
تمام تورنت‌ها، مگر اینکه با تنظیم اختصاصی هر تورنت لغو شود، باید تا یک ratio (نسبت) مشخص اشتراک‌گذاری شوند.
--no-global-seedratio
تمام تورنت‌ها، مگر اینکه با تنظیم اختصاصی هر تورنت لغو شود، باید بدون در نظر گرفتن نسبت اشتراک‌گذاری شوند.
--idle-seeding-limit minutes
اجازه به اشتراک‌گذاری تورنت(های) انتخاب‌شده تا رسیدن به زمان مشخصی از بیکاری.
--default-idle-seeding-limit
استفاده از حد پیش‌فرض idle-seeding-limit برای تورنت انتخاب‌شده.
--no-idle-seeding-limit
اجازه به اشتراک‌گذاری تورنت(های) انتخاب‌شده بدون در نظر گرفتن زمان بیکاری.
--global-idle-seeding-limit minutes
تمام تورنت‌ها، مگر اینکه برای هر تورنت بازنویسی شده باشد، پس از سپری کردن زمان مشخص‌شده در حالت بیکاری باید اشتراک‌گذاری را متوقف کنند.
--no-global-idle-seeding-limit
تمام تورنت‌ها، مگر اینکه برای هر تورنت بازنویسی شده باشد، بدون در نظر گرفتن زمان سپری‌شده در حالت بیکاری باید اشتراک‌گذاری شوند. اجازه به تورنت(های) انتخاب‌شده برای اشتراک‌گذاری بدون در نظر گرفتن مدت بیکاری.
--help
چاپ توضیحات گزینه‌های خط فرمان.
--info
نمایش جزئیات تورنت(های) فعلی.
--info-files
فهرست کردن فایل‌های تورنت مشخص‌شده.
--info-peers
فهرست کردن همتاهای تورنت مشخص‌شده.
--info-pieces
فهرست کردن قطعه‌های تورنت مشخص‌شده.
--info-trackers
فهرست کردن ردیاب‌های تورنت مشخص‌شده.
--json
بازگرداندن پاسخ RPC در قالب JSON.
--session-info
فهرست کردن اطلاعات نشست از کارساز.
--session-stats
فهرست کردن اطلاعات آماری از کارساز.
--list
فهرست کردن تمام تورنت‌ها.
--print-ids
چاپ فهرستی از شناسه(ID)های تورنت مشخص‌شده در قالبی مناسب به عنوان پارامتر برای -t.
--labels label1[,label2[,...]]
تنظیم برچسب‌های تورنت مشخص‌شده.
--portmap
فعال‌سازی نگاشت درگاه از طریق NAT-PMP یا UPnP.
--no-portmap
غیرفعال‌سازی نگاشت درگاه.
--auth username:password
تنظیم username و password برای احراز هویت.
--authenv
تنظیم اطلاعات احراز هویت از متغیر محیطی TR_AUTH که باید در قالب username:password باشد.
--netrc filename
تنظیم اطلاعات احراز هویت از یک netrc file. برای اطلاعات بیشتر netrc(5) را ببینید.
--dht
فعال‌سازی جدول درهم‌سازی توزیع‌شده (DHT).
--no-dht
غیرفعال‌سازی جدول درهم‌سازی توزیع‌شده (DHT).
--port port
تنظیم port برای استفاده هنگام گوش دادن به اتصالات ورودی همتاها.
--bandwidth-high
دادن بالاترین اولویت به این تورنت برای استفاده از پهنای باند موجود.
--bandwidth-normal
اختصاص پهنای باند باقی‌مانده از تورنت‌های با اولویت بالا به این تورنت.
--bandwidth-low
اختصاص پهنای باند باقی‌مانده از تورنت‌های با اولویت بالا و عادی به این تورنت.
--priority-high all | file-index | files
تلاش برای بارگیری فایل(های) مشخص‌شده در اولویت اول. all تمام فایل‌های تورنت را با اولویت عادی علامت‌گذاری می‌کند، file-index اولویت یک فایل تکی را روی عادی تنظیم می‌کند، و files اولویت چندین فایل را روی عادی تنظیم می‌کند، مانند “-pn1,3-5” برای تنظیم اولویت فایل‌های شمارهٔ ۱، ۳، ۴ و ۵ به عادی.
--priority-normal all | file-index | files
تلاش برای بارگیری فایل‌های مشخص‌شده به صورت عادی.
--priority-low all | file-index | files
تلاش برای بارگیری فایل‌های مشخص‌شده در آخرین مرحله.
--peers number
تنظیم بیشینهٔ تعداد همتاها. اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها عمل می‌کند؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
--remove
حذف تورنت(های) فعلی. این کار داده‌های بارگیری‌شده را پاک نمی‌کند.
--remove-and-delete
حذف تورنت(های) فعلی و پاک کردن داده‌های بارگیری‌شدهٔ آن‌ها.
اعلان دوبارهٔ تورنت(های) فعلی به ردیاب. این کار معادل دکمهٔ “درخواست همتاهای بیشتر از ردیاب” در واسط گرافیکی است.
انتقال داده‌های تورنت‌های فعلی از مکان فعلی‌شان به دایرکتوری مشخص‌شده.
newname
تغییر نام فایل‌ها یا پوشهٔ ریشهٔ یک تورنت.
oldname
ارائهٔ مسیر اصلی برای دستور تغییر نام.
اتصال با استفاده از سوکت دامنه یونیکس (Unix domain socket).
مشخص کردن محل جستجوی داده‌های تورنت‌های فعلی برای Transmission.
--seedratio ratio
اجازه به اشتراک‌گذاری تورنت(های) فعلی تا یک ratio (نسبت) مشخص.
--no-seedratio
اجازه به اشتراک‌گذاری تورنت(های) فعلی بدون در نظر گرفتن نسبت.
--seedratio-default
اجازه به تورنت(های) فعلی برای استفاده از تنظیمات سراسری seedratio.
--tracker-add tracker
افزودن یک ردیاب به تورنت.
--tracker-remove trackerId
حذف یک ردیاب از تورنت.
--start
شروع تورنت(های) فعلی.
--stop
متوقف کردن بارگیری یا اشتراک‌گذاری تورنت(های) فعلی.
شروع تورنت‌های اضافه‌شده در حالت مکث.
شروع تورنت‌های اضافه‌شده در حالت فعال (بدون مکث).
--torrent all | active | id | torrent-hash
تنظیم تورنت(های) فعلی برای استفاده توسط گزینه‌های بعدی. عبارت صریح all درخواست‌های بعدی را روی تمام تورنت‌ها اعمال می‌کند؛ عبارت صریح active درخواست‌های بعدی را روی تورنت‌هایی که اخیراً فعال بوده‌اند اعمال می‌کند؛ و تورنت‌های مشخص می‌توانند بر اساس id یا hash انتخاب شوند. برای تنظیم بیش از یک تورنت فعلی، شناسه‌های آن‌ها را در یک فهرست به هم متصل کنید، مانند “-t2,4,6-8” برای اعمال عملیات روی تورنت‌هایی که شناسهٔ آن‌ها ۲، ۴، ۶، ۷ و ۸ است.
حذف فایل‌های تورنت پس از افزودن.
عدم حذف فایل‌های تورنت پس از افزودن.
--honor-session
وادار کردن تورنت(های) فعلی به رعایت محدودیت‌های نشست.
--no-honor-session
وادار کردن تورنت(های) فعلی به عدم رعایت محدودیت‌های نشست.
--uplimit limit
محدود کردن بیشینهٔ سرعت بارگذاری به limit کیلوبایت بر ثانیه (kB/s). اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها اثر می‌گذارد؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
--no-uplimit
غیرفعال‌سازی محدودیت‌های سرعت بارگذاری.
فعال‌سازی uTP برای اتصالات همتاها.
غیرفعال‌سازی uTP برای اتصالات همتاها. اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها اثر می‌گذارد؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
--verify
بررسی صحت تورنت(های) فعلی.
--version
نمایش شمارهٔ نسخه و خروج.
--download-dir directory
در صورت استفاده به همراه --add، پوشهٔ بارگیری تورنت جدید را تنظیم می‌کند؛ در غیر این صورت، پوشهٔ بارگیری پیش‌فرض را تعیین می‌کند..It Fl x Fl -pex فعال‌سازی تبادل همتا (PEX).
--no-pex
غیرفعال‌سازی تبادل همتا (PEX).
--lds
فعال‌سازی کشف محلی همتا (LPD).
--no-lds
غیرفعال‌سازی کشف محلی همتا (LPD).
--peer-info
فهرست کردن همتاهای متصل به تورنت فعلی. در بخش `status` فهرست، علائم اختصاری زیر به کار می‌روند:
D: در حال بارگیری (دانلود) از این همتا
d: در صورت اجازه همتا، از آن بارگیری خواهد شد
E: اتصال رمزنگاری‌شده
H: همتا از طریق DHT پیدا شد
I: همتا یک اتصال ورودی است
K: همتا انسداد ما را برداشته، اما ما تمایلی نداریم
O: رفع انسداد خوش‌بینانه (Optimistic unchoke)
T: همتا از طریق uTP متصل است
U: در حال بارگذاری (آپلود) به همتا
u: در صورت درخواست همتا، به آن بارگذاری خواهد شد
X: همتا از طریق تبادل همتا (PEX) کشف شد
?: ما انسداد این همتا را برداشتیم، اما تمایلی ندارد
به‌روزرسانی فهرست مسدودی از نشانی مشخص‌شده در تنظیمات کلاینت دوردست با کلید blocklist-url .

فهرست کردن تمام تورنت‌ها:

$ transmission-remote -l
فهرست کردن تمام تورنت‌های فعال:
$ transmission-remote -tactive -l
فهرست کردن تمام تورنت‌های دارای برچسب "abc":
$ transmission-remote -F l:abc -l
فهرست کردن تمام تورنت‌های شامل "def" در نام، یا دارای برچسب "abc":
$ transmission-remote -t $( transmission-remote -F n:def -ids )$( transmission-remote -F l:abc -ids ) -l
تغییر نام پوشه ریشه تورنت از "test1/examplefile.txt" به "test2/examplefile.txt":
$ transmission-remote -t1 --path test1 --rename test2
تنظیم محدودیت‌های دانلود و آپلود روی 400 kB/s و 60 kB/s:
$ transmission-remote -d400 -u60
$ transmission-remote --downlimit=400 --uplimit=60
تنظیم محدودیت‌های متناوب دانلود و آپلود روی 100 kB/s و 20 kB/s:
$ transmission-remote -asd100 -asu20
$ transmission-remote --alt-speed-downlimit=100 --alt-speed-uplimit=20
تنظیم زمان‌بند برای استفاده از محدودیت‌های سرعت متناوب در روزهای کاری هفته بین ساعت ۱۰ صبح تا ۱۱ شب:
$ transmission-remote --alt-speed-time-begin=1000
$ transmission-remote --alt-speed-time-end=2300
$ transmission-remote --alt-speed-days=1-5
$ transmission-remote --alt-speed-scheduler
فهرست کردن شناسه‌ها و وضعیت تمام تورنت‌ها:
$ transmission-remote -l
فهرست کردن تمام تورنت‌ها از یک نشست دوردست نیازمند احراز هویت:
$ transmission-remote host:9091 --auth=username:password -l
شروع تمام تورنت‌ها:
$ transmission-remote -tall --start
افزودن دو تورنت:
$ transmission-remote -a one.torrent two.torrent
افزودن تمام تورنت‌های موجود در ~/Desktop:
$ transmission-remote -a ~/Desktop/*torrent
دریافت اطلاعات تفصیلی درباره تورنتی با شناسه '1':
$ transmission-remote -t1 -i
دریافت فهرست فایل‌های یک تورنت:
$ transmission-remote -t1 -f
دانلود تنها فایل‌های دوم و چهارم آن:
$ transmission-remote -t1 -Gall -g2,4
تنظیم اولویت دو فایل اول تمام تورنت‌ها روی بالا (high):
$ transmission-remote -tall -ph1,2
تنظیم اولویت فایل‌های تمام تورنت‌ها روی عادی (normal):
$ transmission-remote -tall -pnall
پروکسی مورد استفاده برای اعلان‌های ترکر http را تنظیم می‌کند.

Charles Kerr, Josh Elsasser, Eric Petit, Mitchell Livingston, و Mike Gelfand.

transmission-create(1), transmission-daemon(1), transmission-edit(1), transmission-gtk(1), transmission-qt(1), transmission-remote(1), transmission-show(1)

https://transmissionbt.com

July 21, 2008 Linux 6.12.113+deb13-amd64