Official Transmission BitTorrent client repository
C Objective-C C++ JavaScript CSS CMake Other
Failed to load latest commit information.
.tx Add Mac client translations to and downsync from Transifex Jan 28, 2017
Transmission.xcodeproj Merge branch '2.9x' May 1, 2018
cli Merge branch '2.9x' Jan 25, 2018
cmake Code style change leftovers Apr 21, 2017
daemon Merge pull request #500 from michaelskree/null-terminate Feb 3, 2018
dist/msi Use `magick convert` instead of `convert` Jan 26, 2018
extras Merge branch '2.9x' Jan 25, 2018
gtk Merge branch '2.9x' Jan 25, 2018
libtransmission Merge branch '2.9x' May 1, 2018
m4 Work around "error: m4_copy: won't overwrite defined macro: glib_DEFU… Jan 16, 2018
macosx Fix CMake-based build on Mac after 2.9x merge May 1, 2018
po gtk: move Tamil translation to the correct language code May 19, 2017
qt Qt: Fix bad downloaded percentage in DetailsDialog Mar 8, 2018
third-party Update DHT library to 0.25 Feb 10, 2018
utils Don't crash if path passed to tr-create doesn't exist Jan 24, 2018
web Merge branch '2.9x' May 1, 2018
.gitignore #5934: Generate REVISION file and use it in case of missing reliable … Apr 24, 2015
.gitmodules Update DHT library to 0.25 Feb 10, 2018
.jsbeautifyrc #6089: Beautified JavaScript (patch by skybon) Mar 10, 2016
AUTHORS Add myself to the list of Transmission authors Jan 14, 2017
CMakeLists.txt Merge branch '2.9x' May 1, 2018
COPYING Update user-facing copyright years Feb 27, 2016
ChangeLog required files Jul 18, 2007 Adjust autotools files to use submodules Jan 1, 2017
NEWS Merge branch '2.9x' May 1, 2018 Add command line interface notes readme section May 25, 2017 (trunk) #3939 " doesn't work correctly on systems where /bi… Jan 23, 2011 Merge branch '2.9x' May 1, 2018 Update all website links to canonical HTTPS version. Oct 31, 2016
uncrustify.cfg Adjust uncrustify config, reformat all but Mac client Apr 20, 2017 Merge branch '2.9x' May 1, 2018


Transmission is a fast, easy, and free BitTorrent client. It comes in several flavors:

  • A native Mac OS X GUI application
  • GTK+ and Qt GUI applications for Linux, BSD, etc.
  • A headless daemon for servers and routers
  • A web UI for remote controlling any of the above

Visit for more information.

Command line interface notes

Transmission is fully supported in transmission-remote, the preferred cli client.

Three standalone tools to examine, create, and edit .torrent files exist: transmission-show, transmission-create, and transmission-edit, respectively.

Prior to development of transmission-remote, the standalone client transmission-cli was created. Limited to a single torrent at a time, transmission-cli is deprecated and exists primarily to support older hardware dependent upon it. In almost all instances, transmission-remote should be used instead.

Different distributions may choose to package any or all of these tools in one or more separate packages.


Transmission has an Xcode project file (Transmission.xcodeproj) for building in Xcode.

For a more detailed description, and dependencies, visit:

Building a Transmission release from the command line

$ tar xf transmission-2.92.tar.xz
$ cd transmission-2.92
$ mkdir build
$ cmake ..
$ make
$ sudo make install

Building Transmission from the nightly builds

Download a tarball from and follow the steps from the previous section.

If you're new to building programs from source code, this is typically easier than building from Git.

Building Transmission from Git (first time)

$ git clone Transmission
$ cd Transmission
$ git submodule update --init
$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install

Building Transmission from Git (updating)

$ cd Transmission/build
$ make clean
$ git pull --rebase --prune
$ git submodule update
$ cmake ..
$ make
$ sudo make install