-
-
Notifications
You must be signed in to change notification settings - Fork 4k
Developing alternate WebUIs (WIP)
From qBittorrent v4.1.0 and on, the WebUI architecture was expanded to allow the use of alternate set of HTML files, allowing customization of the WebUI separated from the evolution of the core qBittorrent code.
Also, this mechanism is controlled via configuration options (core UI preferences window or config file), and the WebUI files (html, css, js, ...) are external to the program so it's easier than ever to test and modify the WebUI's functionality, look and feel without need of rebuilding the executable.
In order to increase security, a public
(login process handling) and private
(WebUI functionality) separation of files is implemented (see core WebUI files' segregation as ref: https://github.com/qbittorrent/qBittorrent/tree/master/src/webui/www)
Copy the files:
https://github.com/qbittorrent/qBittorrent/tree/master/src/webui/www to a <new folder>
https://github.com/qbittorrent/qBittorrent/tree/master/src/icons to <new folder>/public
https://github.com/qbittorrent/qBittorrent/tree/master/src/icons to <new folder>/private
Enable AltWebUI on the options and point the entry WebUI\RootFolder
to <new folder>
, then launch qBittorrent.
Access the WebUI as always, modify the files at <new folder>
according to your needs and refresh the browser to see the changes reflected.
- Main WebUI PR: https://github.com/qbittorrent/qBittorrent/pull/7610
- Installing qBittorrent
- Frequently Asked Questions (FAQ)
- qBittorrent options (current and deprecated)
- How to use qBittorrent as a tracker
- How to use portable mode
- Anonymous mode
- How to bind your vpn to prevent ip leaks
State | Version |
---|---|
Current | qBittorrent ≥ v4.1 |
Previous | qBittorrent v3.2.0 - v4.0.x |
Obsolete | qBittorrent < v3.2.0 |
- Let's Encrypt Certificates + Caddy2 Reverse Proxy
- Let's Encrypt certificates + NGINX reverse proxy - Linux
- Let's Encrypt certificates - Linux
- Self-signed SSL certificates - Linux
- Running qBittorrent without X server (WebUI only)
- Running qBittorrent without X server (WebUI only, systemd service set up, Ubuntu 15.04 or newer)
- OpenVPN and qBittorrent without X server
- Coding style
- Contributing
- How to write a search plugin
- Using VSCode for qBittorrent development
- Setup GDB with Qt pretty printers
- How to debug WebUI code