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

# transmission-gtk(1)

a bittorrent client

## NAME

**transmission-gtk** – a bittorrent client

## SYNOPSIS

**transmission-gtk** **-**?

**transmission-gtk** \[**-pqm**\] \[*torrent-file* *...*\]

## DESCRIPTION

**transmission-gtk** 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

- **-**? **--help**

  Show help options

- **-p** **--paused**

  Start with all torrents paused

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

  Start minimized in notification area

- **-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.

Multiple .torrent files may be added at startup by appending them on the command line. If **transmission-gtk** 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-gtk**, since any client sharing the config dir will do.

## ENVIRONMENT

- TRANSMISSION\_HOME

  Sets the default config-dir.

- http\_proxy

  libcurl uses this environment variable when performing tracker announces. If set, this overrides the GNOME proxy preferences.

## FILES

- \~/.config/transmission

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

## AUTHORS

**transmission-gtk** 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/