qBittorrent/INSTALL

qBittorrent - A BitTorrent client in C++ / Qt
------------------------------------------

1) Install these dependencies:

  - Boost >= 1.71

  - libtorrent-rasterbar 1.2.19 - 1.2.x || 2.0.9 - 2.0.x
      * By Arvid Norberg, https://www.libtorrent.org/
      * Be careful: another library (the one used by rTorrent) uses a similar name

  - OpenSSL >= 1.1.1

  - Qt 5.15.2 - 5.x || 6.2.0 - 6.x

  - zlib >= 1.2.11

  - pkg-config *
      * Compile-time only on *nix systems

  - Python >= 3.7.0
      * Optional, run-time only
      * Used by the bundled search engine

Dependency version numbers are bumped every once in a while to keep the range of properly tested configurations manageable, even if not strictly required to build.
You may be able to build with older versions of (some of) the dependencies other than the minimum versions specified in the build scripts, but support for such builds is not provided - you are on your own.
Please ensure you are building with an officially supported configuration when reporting bugs.

2a) Compile and install qBittorrent with Qt graphical interface

  $ ./configure
  $ make && make install
  $ qbittorrent

  will install and execute qBittorrent.

2b) Compile and install qBittorrent without Qt graphical interface

  $ ./configure --disable-gui
  $ make && make install
  $ qbittorrent-nox

  will install and execute qBittorrent.

DOCUMENTATION:
Please note that there is a "Compilation" section at https://wiki.qbittorrent.org.

------------------------------------------
sledgehammer999 <sledgehammer999@qbittorrent.org>
Update INSTALL file Closes #9385. 2018-08-28 09:15:20 +03:00			`qBittorrent - A BitTorrent client in C++ / Qt`
- Moved everything to trunk to create a stable branch 2006-09-30 20:02:39 +04:00			`------------------------------------------`

Update INSTALL dependencies 2019-03-02 07:58:37 +03:00			`1) Install these dependencies:`
- Moved everything to trunk to create a stable branch 2006-09-30 20:02:39 +04:00
Bump boost requirement to 1.71 This is a prerequisite for using boost stacktrace. Note that this is not the first version that introduces boost stacktrace but the version that should be stable enough. PR #16986. 2022-05-06 06:20:34 +03:00			`- Boost >= 1.71`
- Moved everything to trunk to create a stable branch 2006-09-30 20:02:39 +04:00
Raise minimum libtorrent versions PR #19011. 2023-05-25 06:31:28 +03:00			`- libtorrent-rasterbar 1.2.19 - 1.2.x \|\| 2.0.9 - 2.0.x`
Detect incompatible libtorrent v2 versions in build systems Although the detection is working, the error message in autotools is not perfect, i.e. it would only mention valid range for libtorrent v1 and it shouldn't be a problem since v2 support isn't fully ready yet. 2021-07-29 09:15:59 +03:00			`* By Arvid Norberg, https://www.libtorrent.org/`
Update INSTALL dependencies 2019-03-02 07:58:37 +03:00			`* Be careful: another library (the one used by rTorrent) uses a similar name`
- Moved everything to trunk to create a stable branch 2006-09-30 20:02:39 +04:00
Update minimum depedency versions 2020-12-04 15:16:04 +03:00			`- OpenSSL >= 1.1.1`
- Moved everything to trunk to create a stable branch 2006-09-30 20:02:39 +04:00
Add Qt6 version to INSTALL file PR #16054. 2022-01-13 07:39:15 +03:00			`- Qt 5.15.2 - 5.x \|\| 6.2.0 - 6.x`
- Configure file now checks for pkg-config executable since it is required to detect libtorrent-rasterbar 2010-01-20 01:55:49 +03:00
Update minimum depedency versions 2020-12-04 15:16:04 +03:00			`- zlib >= 1.2.11`
- Moved everything to trunk to create a stable branch 2006-09-30 20:02:39 +04:00
Adopt a subset of semantic versioning notation https://github.com/npm/node-semver#ranges https://semver.npmjs.com/ 2021-07-29 09:48:28 +03:00			`- pkg-config *`
Detect incompatible libtorrent v2 versions in build systems Although the detection is working, the error message in autotools is not perfect, i.e. it would only mention valid range for libtorrent v1 and it shouldn't be a problem since v2 support isn't fully ready yet. 2021-07-29 09:15:59 +03:00			`* Compile-time only on *nix systems`
- Moved everything to trunk to create a stable branch 2006-09-30 20:02:39 +04:00
Bump python version minimum requirement PR #18996. 2023-05-22 07:37:02 +03:00			`- Python >= 3.7.0`
Detect incompatible libtorrent v2 versions in build systems Although the detection is working, the error message in autotools is not perfect, i.e. it would only mention valid range for libtorrent v1 and it shouldn't be a problem since v2 support isn't fully ready yet. 2021-07-29 09:15:59 +03:00			`* Optional, run-time only`
			`* Used by the bundled search engine`
- Updated Changelog and INSTALL file 2010-01-03 01:29:36 +03:00
Update minimum depedency versions 2020-12-04 15:16:04 +03:00			`Dependency version numbers are bumped every once in a while to keep the range of properly tested configurations manageable, even if not strictly required to build.`
			`You may be able to build with older versions of (some of) the dependencies other than the minimum versions specified in the build scripts, but support for such builds is not provided - you are on your own.`
			`Please ensure you are building with an officially supported configuration when reporting bugs.`

Update INSTALL dependencies 2019-03-02 07:58:37 +03:00			`2a) Compile and install qBittorrent with Qt graphical interface`
- Updated Changelog and INSTALL file 2010-01-03 01:29:36 +03:00
Update INSTALL dependencies 2019-03-02 07:58:37 +03:00			`$ ./configure`
- Updated Changelog and INSTALL file 2010-01-03 01:29:36 +03:00			`$ make && make install`
Update INSTALL dependencies 2019-03-02 07:58:37 +03:00			`$ qbittorrent`
- Updated Changelog and INSTALL file 2010-01-03 01:29:36 +03:00
Update INSTALL file Closes #9385. 2018-08-28 09:15:20 +03:00			`will install and execute qBittorrent.`
- Updated Changelog and INSTALL file 2010-01-03 01:29:36 +03:00
Update INSTALL dependencies 2019-03-02 07:58:37 +03:00			`2b) Compile and install qBittorrent without Qt graphical interface`
- Updated Changelog and INSTALL file 2010-01-03 01:29:36 +03:00
Update INSTALL dependencies 2019-03-02 07:58:37 +03:00			`$ ./configure --disable-gui`
			`$ make && make install`
			`$ qbittorrent-nox`
- Added a line in INSTALL to advise gnome users to install qt4-qtconfig package 2007-02-19 16:51:17 +03:00
Update INSTALL dependencies 2019-03-02 07:58:37 +03:00			`will install and execute qBittorrent.`
- Added geoip-database as an optional dependency in INSTALL file 2009-12-07 23:57:59 +03:00
- added doc url in INSTALL file 2007-07-24 10:20:32 +04:00			`DOCUMENTATION:`
Switch URLs to https PR #18876. 2023-04-23 10:09:58 +03:00			`Please note that there is a "Compilation" section at https://wiki.qbittorrent.org.`
- Moved everything to trunk to create a stable branch 2006-09-30 20:02:39 +04:00
			`------------------------------------------`
Update INSTALL file Closes #9385. 2018-08-28 09:15:20 +03:00			`sledgehammer999 <sledgehammer999@qbittorrent.org>`