Building Transmission

If you are searching for a HOWTO, covering a specific desitribution or device (NAS, router, ...), have a look at the Running Transmission on a headless machine page

Getting the Source

Source code for official releases can be found on our ​download page.

Automated source code tarballs including the newest code ​are now available, too!

If you want to check out the source code yourself from svn, open a terminal window and type:

$ svn co svn://svn.m0k.org/Transmission/trunk Transmission

On Mac OSX

Transmission has an Xcode project file (Transmission.xcodeproj) for building in Xcode. Make sure you have this software:

• Mac OS X 10.5 or newer
• Mac OS X 10.5 SDK
• Xcode 3.1.1 or newer

(Found on your OSX installation disk, or from the ​Apple Developer website)

If building from source is too daunting for you, check out the ​nightly builds.
(Note: These are untested snapshots. Use them with care.)

On Unix

Prerequisites

Ubuntu users: The packages you need are: build-essential automake autoconf libtool pkg-config libcurl4-openssl-dev intltool libxml2-dev libgtk2.0-dev libnotify-dev libglib2.0-dev. After you install those you can skip this section.

If this is your first time compiling on Unix, you'll need a few basic tools:

• gcc
• libtool
• gettext 0.14.1 or newer
• intltool 0.23 or newer

If you're planning to build from SVN:

• automake 1.9 or newer
• autoconf 2.54 or newer

Once you've got the basics out of the way, here are the libraries that Transmission needs to have in order to build:

• OpenSSL 0.9.8 or newer, preferably ssl or gnutls support.
• libcurl 7.16.3 or newer
• GTK+ 2.6 or newer (only needed by the GTK+ gui)
• libnotify 0.4.4 (optional, and only needed by the GTK+ gui)
• DBUS 0.70 (optional, and only needed by the GTK+ gui)

RPM users: you'll also need to install the corresponding -devel packages.

Building from a tarball

$ tar xvjf transmission-1.40.tar.bz2
$ cd transmission-1.40
$ ./configure -q && make -s
$ su (if necessary for the next line)
$ make install

Building from an SVN snapshot

First Time

$ svn co svn://svn.m0k.org/Transmission/trunk Transmission
$ cd Transmission
$ ./autogen.sh && make -s
$ su (if necessary for the next line)
$ make install

Updating

$ cd Transmission
$ make clean
$ svn up
$ make -s
$ su (if necessary for the next line)
$ make install

Switches

The transmission ./configure (or ./autogen.sh) script allows you to switch on/off certain parts. To use these, you'll either use --enable-* or --disable-*. eg. To disable the GTK client: --disable-gtk.

The switches that are available are:

• gtk = enables GTK+ client (default)
• daemon = enables transmission-daemon and *-remote client (default)
• cli = enables cli client (default)
• libnotify = enables lib notify (default)
• nls = enables native language support (default)
• mac = enables Mac client (default, if possible)
• wx = enables wxWidgets client (unsupported)
• beos = enables beos client (unsupported)

Note: --disable-nls removes the dependancy on gettext and intltool. It's designed for, and should only be used on, embedded devices. If you do have GTK+ installed on your box, you must also specify --disable-gtk.

---

Comments