Building Transmission

Getting the Source

Source code for official releases can be found on our ​download page.
If you've got SVN installed and would like to use a fresh code snapshot, 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, however, make sure you have this software:

• Mac OS X 10.5 or newer
• Mac OS X 10.5 SDK
• Xcode 3.0 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.)

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 . 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
• autoconf 2.54 or newer
• libtool
• automake 1.9 or newer
• gettext 0.14.1 or newer
• intltool 0.23 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
• libcurl 7.15.0 or newer
• GTK+ 2.6 or newer (only needed by the GTK+ gui)
• libnotify 0.0.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.32.tar.bz2
$ cd transmission-1.32
$ ./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 )
• libnotify = enables lib notify (default)
• cli = enables cli client (default)
• daemon = enables transmission-daemon and transmission-remote client (default)
• mac = enables Mac client (default, if possible)
• wx = enables wxWidgets client (unsupported)
• beos = enables beos client (unsupported)

---

Comments

jinzo: I think "make clean" before running svn up is a good practice, but I may be wrong

Waldorf: hmm, I got that from the readme... If you're sure, I'll add it. otherwise, ask charles_ first

charles: it's not essential, but it's probably a good idea. It should be added.

theCrank: What about appending a list of HOWTOs, one for each (major...) distribution?

Waldorf: That's a good idea, but I wouldn't append them here. Rather have another page from where to link to the individual distro how-tos. I wouldn't mind adding smaller ones, like those for specific NAS or router devices.

Waldorf: Now I come to think of it, it might be interesting to dump them on the FAQ page.

geirha: You might add on the wiki that you can get pre-built packages for debian/ubuntu at getdeb.net