qBittorrent

qBittorrent is an open source and cross-platform BitTorrent client written in C++, Qt and Python (optional search engine), using libtorrent-rasterbar library.

It is fast, stable and light, supports unicode and provides an integrated search engine. It comes with UPnP port forwarding / NAT-PMP, encryption (Vuze compatible), FAST extension (main‐line) and PeX support (uTorrent compatible).

Installation

There are two packages in official repositories to install qBittorrent with:

• qBittorrent — Qt graphical interface and #Web interface.

https://github.com/qbittorrent/qBittorrent || qbittorrent

• qBittorrent-nox — Without graphical interface (nox -> no X server).

https://github.com/qbittorrent/qBittorrent || qbittorrent-nox

Configuration

A configuration file is created at ~/.config/qBittorrent/qBittorrent.conf upon running the program the first time.

Autostart

If you install qbittorrent-nox, you will get a systemd unit template qbittorrent-nox@.service. QBittorrent will run as a specific user if you enable/start qbittorrent-nox@username.service

QBittorrent will run as the user username. The default download folder will be the user's Downloads directory, but this can be reconfigured later.

ヒント:

• If you are running it as a accessible service create a user called qbittorrent and make it run under it, and make the service restart on exit as the program have exit button.
• To modify the settings (i.e. port) you can add an environment variable (for port it is QBT_WEBUI_PORT) by using a drop-in file for its systemd unit. Run qbittorrent-nox --help to learn more about other environment variables (this information is not stated in the manual).

Search engine

The optional search engine may be enabled through the menu View > Search Engine, which opens the Search tab.

Search plugins

Default trackers can be added/enabled in the Search tab by opening the tracker window with Search plugins... (bottom right) and pressing Check for updates. More unofficial search plugins can be found here.

Web interface

Default location

By default, qBittorrent will listen on all interfaces on port 8080. Thus it is accessible at http://HOST_IP:8080.

ノート: HTTPS is not enabled by default, so https://HOST_IP:8080 is not accessible.

Default username & password

The default username is admin and the default password is adminadmin.

Allow access without username & password

In a home environment, it is often desirable to allow access to the Web UI without having to input a username and password. This can be configured in the Web UI itself after logging in using the default username and password.

Alternatively, to avoid logging in for the first time, add this section to ~/.config/qBittorrent/qBittorrent.conf:

[Preferences]
WebUI\AuthSubnetWhitelist=192.168.1.0/24
WebUI\AuthSubnetWhitelistEnabled=true
WebUI\UseUPnP=false

The above configuration items will:

• Allow clients logging in from 192.168.1.x to access the Web UI without having to enter a username and password.
• Disable UPnP for the Web UI, so that the Web UI will not be accessible from outside the network.

After that, reload qbittorrent-nox@username.service.

Reverse proxy configuration

nginx

Refer to qbittorrent wiki

Themes

Unofficial themes

• How to use custom UI themes
• List of known qBittorrent themes

See also

• qBittorrent official website
• qBittorrent wiki on GitHub
• Wikipedia:qBittorrent