2016-09-01 22:07:32 +00:00
## About
2006-07-16 19:39:23 +00:00
2016-09-01 22:07:32 +00:00
Transmission is a fast, easy, and free BitTorrent client. It comes in several flavors:
2021-08-07 10:31:28 +00:00
* A native macOS GUI application
2016-09-01 22:07:32 +00:00
* 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
2006-07-16 19:39:23 +00:00
2016-09-03 22:59:50 +00:00
Visit https://transmissionbt.com/ for more information.
2006-07-16 19:39:23 +00:00
2022-02-21 16:40:19 +00:00
## Documentation
[Transmission's documentation ](docs/README.md ) is currently out-of-date, but the team has recently begun a new project to update it and is looking for volunteers. If you're interested, please feel free to submit pull requests!
2017-05-25 18:31:43 +00:00
## 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.
2016-09-01 22:07:32 +00:00
## Building
2007-08-16 15:20:11 +00:00
2016-09-01 22:07:32 +00:00
Transmission has an Xcode project file (Transmission.xcodeproj) for building in Xcode.
2007-08-16 15:20:11 +00:00
2022-04-25 23:18:35 +00:00
For a more detailed description, and dependencies, visit: https://github.com/transmission/transmission/tree/main/docs
2007-08-16 15:20:11 +00:00
2016-09-01 22:07:32 +00:00
### Building a Transmission release from the command line
2008-12-06 17:04:24 +00:00
2022-04-25 23:18:35 +00:00
$ tar xf transmission-3.00.tar.xz
$ cd transmission-3.00
2016-12-26 19:46:07 +00:00
$ mkdir build
2018-07-28 22:38:25 +00:00
$ cd build
2021-08-18 21:18:22 +00:00
$ # Use -DCMAKE_BUILD_TYPE=RelWithDebInfo to build optimized binary.
$ cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo ..
2010-01-14 14:20:49 +00:00
$ make
$ sudo make install
2007-08-16 15:20:11 +00:00
2016-09-01 22:07:32 +00:00
### Building Transmission from the nightly builds
2009-06-20 01:31:34 +00:00
2016-12-26 19:46:07 +00:00
Download a tarball from https://build.transmissionbt.com/job/trunk-linux/ and follow the steps from the previous section.
2009-06-20 01:31:34 +00:00
2016-12-26 19:46:07 +00:00
If you're new to building programs from source code, this is typically easier than building from Git.
2009-06-20 01:31:34 +00:00
2016-12-26 19:46:07 +00:00
### Building Transmission from Git (first time)
2007-08-16 15:20:11 +00:00
2016-12-26 19:46:07 +00:00
$ git clone https://github.com/transmission/transmission Transmission
2007-08-16 15:20:11 +00:00
$ cd Transmission
2022-02-12 17:30:27 +00:00
$ git submodule update --init --recursive
2016-12-26 19:46:07 +00:00
$ mkdir build
$ cd build
2021-08-18 21:18:22 +00:00
$ # Use -DCMAKE_BUILD_TYPE=RelWithDebInfo to build optimized binary.
$ cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo ..
2010-01-14 14:20:49 +00:00
$ make
$ sudo make install
2007-08-17 02:50:55 +00:00
2016-12-26 19:46:07 +00:00
### Building Transmission from Git (updating)
2007-08-20 02:41:32 +00:00
2016-12-26 19:46:07 +00:00
$ cd Transmission/build
2008-12-06 17:04:24 +00:00
$ make clean
2022-04-02 20:58:59 +00:00
$ git submodule foreach --recursive git clean -xfd
2016-12-26 19:46:07 +00:00
$ git pull --rebase --prune
2022-02-12 17:30:27 +00:00
$ git submodule update --recursive
2021-08-18 21:18:22 +00:00
$ # Use -DCMAKE_BUILD_TYPE=RelWithDebInfo to build optimized binary.
$ cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo ..
2010-01-14 14:20:49 +00:00
$ make
$ sudo make install
2019-02-27 23:01:21 +00:00
## Contributing
### Code Style
2021-08-15 22:08:56 +00:00
You would want to setup your editor to make use of the .clang-format file located in the root of this repository and the eslint/prettier rules in web/package.json.
2019-02-27 23:01:21 +00:00
2022-05-26 12:38:20 +00:00
If for some reason you are unwilling or unable to do so, there is a shell script which you can use: `./code_style.sh`
2021-11-06 06:16:51 +00:00
## Sponsors
< table >
< tbody >
< tr >
< td align = "center" > < img alt = "[MacStadium]" src = "https://uploads-ssl.webflow.com/5ac3c046c82724970fc60918/5c019d917bba312af7553b49_MacStadium-developerlogo.png" height = "30" / > < / td >
< td > macOS CI builds are running on a M1 Mac Mini provided by < a href = "https://www.macstadium.com/opensource" > MacStadium< / a > < / td >
< / tr >
< tr >
< td align = "center" > < img alt = "[SignPath]" src = "https://avatars.githubusercontent.com/u/34448643" height = "30" / > < / td >
< td > Free code signing on Windows provided by < a href = "https://signpath.io/" > SignPath.io< / a > , certificate by < a href = "https://signpath.org/" > SignPath Foundation< / a > < / td >
< / tr >
< / tbody >
< / table >