qBittorrent does not need a system-wide dark-mode switch to use a dark interface. You can load a community .qbtheme file through qBittorrent’s custom UI theme setting, then restart the client to apply it.
What qBittorrent dark mode means
On Linux, qBittorrent’s dark appearance comes from a custom Qt user-interface theme that qBittorrent documents as an unofficial community theme.
This distinction matters when a theme looks wrong after a qBittorrent update. Test another theme or check the theme repository before assuming that the torrent client itself is broken.
Download a .qbtheme file
Choose a theme from qBittorrent’s community theme list, then use the repository linked for that theme rather than an unrelated mirror.
Dracula is one option with a downloadable client theme named dracula.qbtheme.
curl -fL https://raw.githubusercontent.com/dracula/qbittorrent/master/dracula.qbtheme -o dracula.qbtheme
I ran that download URL during this refresh and confirmed that it returns a Qt binary resource file, which is the format qBittorrent expects. Save the file anywhere you can find in the file picker, because you do not need to copy it into a hidden .themes directory.
Apply the custom UI theme
- Open qBittorrent.
- Choose Tools, then Options.
- Open Behavior and find the Interface section.
- Enable Use custom UI Theme.
- Select the .qbtheme file you downloaded.
- Restart qBittorrent.
The restart is required. qBittorrent’s own custom-theme instructions say that a .qbtheme file takes effect only after restarting the application.
Choose a theme that suits your desktop
A .qbtheme file changes qBittorrent’s application interface, not every part of your Linux desktop. Window decorations, title bars, and file-picker colors can still follow GNOME, KDE Plasma, Xfce, or your active system theme.
The official qBittorrent theme list includes dark options such as Dracula, Solarized Dark, Gruvbox Dark, and community projects with their own visual styles. Pick a theme from that list, then use the repository’s download instructions and issue tracker when you need help with that specific theme.
Troubleshoot a theme that does not apply
First, confirm that you selected a file ending in .qbtheme and restarted qBittorrent. A ZIP archive or a repository folder is not a theme file, so qBittorrent cannot load it as the UI theme.
Next, disable Use custom UI Theme, restart qBittorrent, and enable it again with a different .qbtheme file. If the second theme works, report the issue to the first theme’s repository because qBittorrent describes these themes as community-supported.
If qBittorrent cannot start after a theme change and you cannot reach its settings, move the selected .qbtheme file out of its saved location or use your distribution’s qBittorrent support channel for its configuration-reset procedure.
Custom UI themes and the Web UI are separate
The setting above styles qBittorrent’s desktop client. It does not style the browser-based Web UI that you open from another device.
Use an alternative Web UI only when you want to change the browser interface. For example, Dracula publishes a separate Web UI directory and qBittorrent places that option under Tools, Options, Web UI.
Keep the theme file and source together
Keep the selected .qbtheme file in a folder you control, such as Downloads or a personal Themes folder, and save the repository URL with it. That makes replacing an incompatible theme straightforward after a client update.
Does qBittorrent have a built-in dark mode on Linux?
qBittorrent can use a dark interface through a custom .qbtheme file. The project documents custom UI themes as community themes, so the dark appearance comes from the selected theme file rather than a system-wide switch.
Where do I enable a qBittorrent dark theme?
Open qBittorrent, then choose Tools, Options, Behavior, and Interface. Enable Use custom UI Theme, select a .qbtheme file, and restart qBittorrent.
Why is my qBittorrent theme not applying?
Check that you selected a .qbtheme file rather than a ZIP archive or folder, then restart qBittorrent. If another theme works, use the first theme repository’s issue tracker because community themes are supported by their own projects.