TRANSMISSION-CLI(1)

💖 TRANSMISSION-CLI(1) — the group chat manual 💖

okay bestie, gather round, because today we're talking about transmission-cli, a bittorrent client from the General Commands Manual section of your local man pages. she's lightweight, she's command-line, she has scripting capabilities, and honestly? she ate. 🍓

---

✨ NAME ✨

transmission-cli — a bittorrent client 🦋

---

✨ SYNOPSIS ✨

like, here's the vibe of how you call her:

transmission-cli -h
transmission-cli [-b | -B] [-d number | -D] [-er | -ep | -et]
                 [-f script] [-g directory] [-h] [-m | -M] [-p port]
                 [--tos tos] [-u number | -U] [-v] [-w directory]
                 torrent-file

---

✨ DESCRIPTION ✨

so. the transmission-cli program is a lightweight, command-line BitTorrent client with scripting capabilities. that's the whole main character energy of it, no notes. 👑

the options are as follows, and yes we're going through every single one, because we don't skip:

• -b --blocklist — turns peer blocklists ON. transmission understands the bluetack blocklist file format. wanna add new blocklists? just copy them into the config-dir's blocklists subdirectory, easy. 💅
• -B --no-blocklist — turns blocklists OFF. that's it, that's the whole thing. ✨
• -d --downlimit number — sets the maximum download speed, measured in KB/s.
• -D --no-downlimit — don't limit the download speed. let her run free. 🌈
• -er --encryption-required — encrypt ALL peer connections. full lock-in. 🔥
• -ep --encryption-preferred — prefer encrypted peer connections, but like, no pressure.
• -et --encryption-tolerated — prefer unencrypted peer connections. she's chill like that. 🌸
• -f --finish script — set a script to run when the torrent finishes. a little celebration script, if you will. 🎀
• -g --config-dir directory — where to look for configuration files. this one is lowkey iconic because you can use it to swap between using the cli, daemon, gtk, and qt clients. see https://github.com/transmission/transmission/blob/main/docs/Configuration-Files.md for more information.
• -h --help — prints a short usage summary. the classic "help me bestie" move. 🫶
• -m --portmap — enable portmapping via NAT-PMP or UPnP. ✨
• -M --no-portmap — disable portmapping. bye bestie 👋
• -p --port port — set the port to listen for incoming peers. (Default: 51413)
• --tos tos — use a ToS or DSCP name to set the peer socket service type for local router-based traffic shaping. valid values are a decimal value 0-255, or any of these DSCP strings:

“af11”, “af12”, “af13”, “af21”, “af22”, “af23”, “af31”, “af32”, “af33”, “af41”, “af42”, “af43”, “cs0”, “cs1”, “cs2”, “cs3”, “cs4”, “cs5”, “cs6”, “cs7”, “ef”, “le”

⚠️ heads up: these ToS keys are deprecated and will be removed in the future: “default”, “lowcost”, “lowdelay,”, “reliability”, “throughput” — so like, don't get attached, fr fr. 💀

• -u --uplimit number — sets the maximum upload speed, in KB/s.
• -U --no-uplimit — don't limit the upload speed. generous queen. 👑
• -v --verify — verify the torrent's downloaded data. trust but verify, periodt.
• -w --download-dir directory — where to save downloaded data. 🦋

---

✨ SIGNALS ✨

in addition to these options, sending transmission-cli a SIGHUP signal will contact the tracker for more peers. it's giving "hey, do you have more friends for me" energy and honestly, relatable. 😭

---

✨ ENVIRONMENT ✨

• TRANSMISSION_HOME — sets the default config-dir.
• http_proxy — libcurl uses this environment variable when performing tracker announces. 🧚

---

✨ FILES ✨

• ~/.config/transmission — directory where transmission-cli keeps torrent information for future seeding and resume operations. her lil memory box 💜

---

✨ AUTHORS ✨

the transmission-cli program was written by Eric Petit, Josh Elsasser, Charles Kerr, Mitchell Livingston, and Mike Gelfand. legends only. 💅✨

---

✨ SEE ALSO ✨

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

https://transmissionbt.com/ 🌐

---

and that's the whole page bestie!! this one's from the Debian edition, dated July 21, 2008 — vintage but still slaying. no cap. 💖🦋✨

okay ily, go download something legal, bye!! 🎀