Introduction

From qBittorrent v4.1.0 and on, the WebUI architecture was expanded to allow the use of alternate sets of WebUI sources, allowing customization of the WebUI and usage of community developed alternatives.

Procedure

First, you need to download a compatible WebUI. You can find a list of unofficial community-developed WebUIs at List of unofficial alternate WebUIs.

Under Tools->Preferences->WebUI enable Use alternative WebUI.
Choose a location that points to a WebUI-compatible folder location.
Restart qBittorrent or refresh your browser for changes to take effect.

You can also change these settings via the config file. The relevant entries are:

WebUI\AlternativeUIEnabled=true
WebUI\RootFolder=/path/to/some/alternate/webui

If you wish to customize the default one and maybe develop your own, refer to the article on Developing alternate WebUIs.

General

Troubleshooting

External programs

Search plugins

List of unofficial search plugins

Themes

Translation

How to translate qBittorrent

WebUI

WebUI API

State	Version
Current	qBittorrent ≥ v4.1
Previous	qBittorrent v3.2.0 - v4.0.x
Obsolete	qBittorrent < v3.2.0

WebAPI clients

List of unofficial WebAPI clients

Alternate WebUI

Reverse proxy setup for WebUI access

WebUI HTTPS configuration

Linux

Development

Compilation

Common information for CMake

*BSD, Linux

macOS

Windows

Obsolete compilation guides

Go back to home