qBittorrent-Enhanced-Edition/README.md

qBittorrent Enhanced Edition
------------------------------------------
[Important Note for user and tracker operators](NOTE.md)
********************************
# Features:
1. Auto Ban Xunlei, QQ, Baidu, Xfplay, DLBT and Offline downloader

2. _Auto Ban Unknown Peer from China_ Option (Default: OFF)

3. Auto Update Public Trackers List (Default: OFF)

4. Auto Ban BitTorrent Media Player Peer Option (Default: OFF)

5. Peer whitelist/blacklist
********************************
### Description:
qBittorrent is a bittorrent client programmed in C++ / Qt that uses
libtorrent (sometimes called libtorrent-rasterbar) by Arvid Norberg.

It aims to be a good alternative to all other bittorrent clients
out there. qBittorrent is fast, stable and provides unicode
support as well as many features.

The free [IP to Country Lite database](https://db-ip.com/db/download/ip-to-country-lite) by [DB-IP](https://db-ip.com/) is used for resolving the countries of peers. The database is licensed under the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).

### Installation:
For installation, follow the instructions from INSTALL file, but simple:

```
./configure
make && make install
qbittorrent
```

will install and execute qBittorrent hopefully without any problem.

## Repository

If you are using a desktop Linux distribution without any special demands, you can use AppImage from release page.

Latest AppImage download: [qBittorrent-Enhanced-Edition-x86_64.AppImage](https://github.com/c0re100/qBittorrent-Enhanced-Edition/releases/latest/download/qBittorrent-Enhanced-Edition-x86_64.AppImage)

#### Arch Linux (Maintainer: [c0re100](https://github.com/c0re100))

[AUR](https://aur.archlinux.org/packages/qbittorrent-enhanced-git/)

[nox AUR](https://aur.archlinux.org/packages/qbittorrent-enhanced-nox-git/)

#### Debian (Maintainer: [Kolcha](https://github.com/Kolcha))

##### Qt5 variants (Debian 11 and above):

[GUI](https://software.opensuse.org//download.html?project=home%3Anikoneko%3Atest&package=qbittorrent-enhanced)

[nox](https://software.opensuse.org//download.html?project=home%3Anikoneko%3Atest&package=qbittorrent-enhanced-nox)

##### Qt6 variants (Debian Testing and above):

[GUI](https://software.opensuse.org//download.html?project=home%3Anikoneko%3Atest&package=qbittorrent-enhanced-qt6)

[nox](https://software.opensuse.org//download.html?project=home%3Anikoneko%3Atest&package=qbittorrent-enhanced-nox-qt6)

The one [repository](https://build.opensuse.org/project/show/home:nikoneko:test) contains all 4 variants listed above, links to specific packages are provided for convenience.

#### openSUSE/RPM-based Linux distro (Maintainer: [PhoenixEmik](https://github.com/PhoenixEmik))

[openSUSE repo](https://build.opensuse.org/package/show/home:PhoenixEmik/qbittorrent-enhanced-edition)

#### Ubuntu (Maintainer: [poplite](https://github.com/poplite))

[PPA](https://launchpad.net/~poplite/+archive/ubuntu/qbittorrent-enhanced)

#### macOS (Homebrew) (Maintainer: [AlexaraWu](https://github.com/AlexaraWu))
```
brew install c0re100-qbittorrent
```

#### Windows

Windows 10 & 11 (Maintainer: [c0re100](https://github.com/c0re100))

```
winget install c0re100.qBittorrent-Enhanced-Edition
```

Chocolatey (Maintainer: [iYato](https://github.com/iYato))

```
choco install qbittorrent-enhanced
```

Scoop (Maintainer: [Chawye Hsu](https://github.com/chawyehsu))

```
scoop bucket add dorado https://github.com/chawyehsu/dorado
scoop install qbittorrent-enhanced
```

### Misc:
For more information please visit:
https://www.qbittorrent.org

or our wiki here:
http://wiki.qbittorrent.org

Use the forum for troubleshooting before reporting bugs:
http://forum.qbittorrent.org

Please report any bug (or feature request) to:
http://bugs.qbittorrent.org

For enhanced features bug(such as Auto Ban, API, Auto Update Tracker lists...), please report to:
https://github.com/c0re100/qBittorrent-Enhanced-Edition/issues
Update README 2022-01-08 02:14:13 +08:00			`qBittorrent Enhanced Edition`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00			`------------------------------------------`
Update README 2022-01-08 02:14:13 +08:00			`[Important Note for user and tracker operators](NOTE.md)`
			`********************************`
			`# Features:`
			`1. Auto Ban Xunlei, QQ, Baidu, Xfplay, DLBT and Offline downloader`

			`2. _Auto Ban Unknown Peer from China_ Option (Default: OFF)`

			`3. Auto Update Public Trackers List (Default: OFF)`

			`4. Auto Ban BitTorrent Media Player Peer Option (Default: OFF)`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00
Update README 2022-01-08 02:14:13 +08:00			`5. Peer whitelist/blacklist`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00			`********************************`
Hookup to Coverity Scan, Closes #2601 2015-03-13 15:01:20 +08:00			`### Description:`
Update README file. 2014-05-04 21:28:29 +08:00			`qBittorrent is a bittorrent client programmed in C++ / Qt that uses`
			`libtorrent (sometimes called libtorrent-rasterbar) by Arvid Norberg.`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00
			`It aims to be a good alternative to all other bittorrent clients`
			`out there. qBittorrent is fast, stable and provides unicode`
- Updated french and dutch translations - Fixed some typos in engineSelect - Made search engine plugin install more reliable - Added some comments 2007-09-01 18:23:39 +08:00			`support as well as many features.`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00
Use IP geolocation database by DB-IP instead of MaxMind Closes #11792 2020-02-15 04:07:19 +08:00			`The free [IP to Country Lite database](https://db-ip.com/db/download/ip-to-country-lite) by [DB-IP](https://db-ip.com/) is used for resolving the countries of peers. The database is licensed under the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).`
- Added GeoIP licensing 2009-11-16 15:15:12 +08:00
Use markdown in README and display travis-ci build status for master branch. Signed-off-by: Mariusz Fik <fisiu@opensuse.org> 2014-02-14 02:48:44 +08:00			`### Installation:`
- Updated french and dutch translations - Fixed some typos in engineSelect - Made search engine plugin install more reliable - Added some comments 2007-09-01 18:23:39 +08:00			`For installation, follow the instructions from INSTALL file, but simple:`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00
Use markdown in README and display travis-ci build status for master branch. Signed-off-by: Mariusz Fik <fisiu@opensuse.org> 2014-02-14 02:48:44 +08:00			```
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00			`./configure`
			`make && make install`
			`qbittorrent`
Use markdown in README and display travis-ci build status for master branch. Signed-off-by: Mariusz Fik <fisiu@opensuse.org> 2014-02-14 02:48:44 +08:00			```
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00
- Updated french and dutch translations - Fixed some typos in engineSelect - Made search engine plugin install more reliable - Added some comments 2007-09-01 18:23:39 +08:00			`will install and execute qBittorrent hopefully without any problem.`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00
Update README 2022-01-08 02:14:13 +08:00			`## Repository`

			`If you are using a desktop Linux distribution without any special demands, you can use AppImage from release page.`

fix zsync Filename entity for AppImage (#332) 2022-02-17 23:47:09 +08:00			`Latest AppImage download: [qBittorrent-Enhanced-Edition-x86_64.AppImage](https://github.com/c0re100/qBittorrent-Enhanced-Edition/releases/latest/download/qBittorrent-Enhanced-Edition-x86_64.AppImage)`
Update README 2022-01-08 02:14:13 +08:00
			`#### Arch Linux (Maintainer: [c0re100](https://github.com/c0re100))`

			`[AUR](https://aur.archlinux.org/packages/qbittorrent-enhanced-git/)`

			`[nox AUR](https://aur.archlinux.org/packages/qbittorrent-enhanced-nox-git/)`

			`#### Debian (Maintainer: [Kolcha](https://github.com/Kolcha))`

updated info about Debian repositories (#412) 2022-08-30 00:48:45 +08:00			`##### Qt5 variants (Debian 11 and above):`
Update README 2022-01-08 02:14:13 +08:00
updated info about Debian repositories (#412) 2022-08-30 00:48:45 +08:00			`[GUI](https://software.opensuse.org//download.html?project=home%3Anikoneko%3Atest&package=qbittorrent-enhanced)`

			`[nox](https://software.opensuse.org//download.html?project=home%3Anikoneko%3Atest&package=qbittorrent-enhanced-nox)`

			`##### Qt6 variants (Debian Testing and above):`

			`[GUI](https://software.opensuse.org//download.html?project=home%3Anikoneko%3Atest&package=qbittorrent-enhanced-qt6)`

			`[nox](https://software.opensuse.org//download.html?project=home%3Anikoneko%3Atest&package=qbittorrent-enhanced-nox-qt6)`

			`The one [repository](https://build.opensuse.org/project/show/home:nikoneko:test) contains all 4 variants listed above, links to specific packages are provided for convenience.`
Update README 2022-01-08 02:14:13 +08:00
			`#### openSUSE/RPM-based Linux distro (Maintainer: [PhoenixEmik](https://github.com/PhoenixEmik))`

			`[openSUSE repo](https://build.opensuse.org/package/show/home:PhoenixEmik/qbittorrent-enhanced-edition)`

			`#### Ubuntu (Maintainer: [poplite](https://github.com/poplite))`

			`[PPA](https://launchpad.net/~poplite/+archive/ubuntu/qbittorrent-enhanced)`

			`#### macOS (Homebrew) (Maintainer: [AlexaraWu](https://github.com/AlexaraWu))`
			```
			`brew install c0re100-qbittorrent`
			```

			`#### Windows`

Update README.md (#433) Added install instructions using the built in Windows 10 & 11 feature https://learn.microsoft.com/en-us/windows/package-manager/package/ It uses the packages that are already being maintained by @c0re100 https://github.com/microsoft/winget-pkgs/tree/master/manifests/c/c0re100/qBittorrent-Enhanced-Edition 2022-11-11 14:10:06 +08:00			`Windows 10 & 11 (Maintainer: [c0re100](https://github.com/c0re100))`

			```
			`winget install c0re100.qBittorrent-Enhanced-Edition`
			```

Update README 2022-01-08 02:14:13 +08:00			`Chocolatey (Maintainer: [iYato](https://github.com/iYato))`

			```
			`choco install qbittorrent-enhanced`
			```

			`Scoop (Maintainer: [Chawye Hsu](https://github.com/chawyehsu))`

			```
			`scoop bucket add dorado https://github.com/chawyehsu/dorado`
			`scoop install qbittorrent-enhanced`
			```
Add public key used for signing source tarballs and binaries. 2016-03-29 03:10:54 +08:00
			`### Misc:`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00			`For more information please visit:`
Use https for www.qbittorrent.org 2017-12-27 07:22:03 +08:00			`https://www.qbittorrent.org`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00
- Added wiki link to README file 2009-11-25 05:27:34 +08:00			`or our wiki here:`
			`http://wiki.qbittorrent.org`

Add forum link in README. Closes #3853. 2015-10-05 03:30:44 +08:00			`Use the forum for troubleshooting before reporting bugs:`
			`http://forum.qbittorrent.org`

- Updated french and dutch translations - Fixed some typos in engineSelect - Made search engine plugin install more reliable - Added some comments 2007-09-01 18:23:39 +08:00			`Please report any bug (or feature request) to:`
- Moved everything to trunk to create a stable branch 2006-10-01 00:02:39 +08:00			`http://bugs.qbittorrent.org`

Update README 2022-01-08 02:14:13 +08:00			`For enhanced features bug(such as Auto Ban, API, Auto Update Tracker lists...), please report to:`
			`https://github.com/c0re100/qBittorrent-Enhanced-Edition/issues`