---
name: "transmission-qt"
section: "1"
platform: "linux"
package: "transmission-qt"
version: "4.1.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/transmission-qt"
---

# transmission-qt(1)

a bittorrent client

## NAME

**transmission-qt** – a bittorrent client

## SYNOPSIS

**transmission-qt** **-h**

**transmission-qt**

\[**options**\] \[*torrent-file* *...*\]

## DESCRIPTION

**transmission-qt** is a fast and easy BitTorrent client.

BitTorrent is a peer-to-peer file transfer protocol which uses a metainfo file (usually with the .torrent file extension) and a central tracker to distribute file data amongst a group of peers. For more information on the BitTorrent protocol see http://www.bittorrent.org/

## OPTIONS

- **-h** **--help**

  Show help options

- **-g** **--config-dir** *directory*

  Where to look for configuration files. This can be used 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.

- **-m** **--minimized**

  Start minimized in notification area

- **-p** **--port** *port*

  Port to use when connecting to an existing session

- **-r** **--remote** *host*

  Connect to an existing session at the specified hostname

- **-u** **--username** *username*

  Username to use when connecting to an existing session

- **-v** **--version**

  Show version number and exit

- **-w** **--password** *password*

  Password to use when connecting to an existing session

Multiple .torrent files may be added at startup by appending them on the command line. If **transmission-qt** is already running, the torrents will be added to the running instance.

A client already running on the same config dir takes over the launch. It receives any torrents you named, or comes to the front when you named none. Either way, no second client starts. That client need not be **transmission-qt**, since any client sharing the config dir will do.

## ENVIRONMENT

- TRANSMISSION\_HOME

  Sets the default config-dir.

## FILES

- \~/.config/transmission

  The config-dir used when neither \[TRANSMISSION\_HOME\] nor \[**-g**\] is specified.

## AUTHORS

**transmission-qt** was written by Charles Kerr, Josh Elsasser, Eric Petit, Mitchell Livingston, and Mike Gelfand.

## SEE ALSO

[transmission-create(1)](/transmission-create/1.md), [transmission-daemon(1)](/transmission-daemon/1.md), [transmission-edit(1)](/transmission-edit/1.md), [transmission-gtk(1)](/transmission-gtk/1.md), [transmission-qt(1)](/transmission-qt/1.md), [transmission-remote(1)](/transmission-remote/1.md), [transmission-show(1)](/transmission-show/1.md)

https://transmissionbt.com/