mirror of
https://github.com/qbittorrent/qBittorrent.git
synced 2026-03-02 22:57:32 -05:00
Windows 10 1903+ Dark "App" Mode (Native Support) #13443
Labels
No labels
Accessibility
AppImage
Bounty
Build system
CI
Can't reproduce
Code cleanup
Confirmed bug
Confirmed bug
Core
Crash
Data loss
Discussion
Docker
Documentation
Duplicate
Feature
Feature request
Feature request
Feature request
Filters
Flatpak
GUI
Has workaround
I2P
Invalid
Libtorrent
Look and feel
Meta
NSIS
Network
Not an issue
OS: *BSD
OS: Linux
OS: Windows
OS: macOS
PPA
Performance
Project management
Proxy/VPN
Qt bugs
Qt6 compat
RSS
Search engine
Security
Temp folder
Themes
Translations
Triggers
Waiting diagnosis
Waiting info
Waiting upstream
Waiting web implementation
Watched folders
WebAPI
WebUI
autoCloseOldIssue
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
starred/qBittorrent#13443
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @aka-0x4C3DD on GitHub (May 22, 2022).
Suggestion
Dark Mode for qBittorrent.
Use case
For people with eye defects, it won't serve as a flash bang.
Extra info/examples/attachments
No response
@adem4ik commented on GitHub (May 23, 2022):
I guess it is needed only for Windows' systems, as macOS and Linux already support it out of box.
@AlexSnowLeo commented on GitHub (May 24, 2022):
Hey @aka-0x4C3DD
I'm also a fan of the dark theme on Windows. Maybe this will help you.
https://github.com/maboroshin/qBittorrentDarktheme
qBittorrent will look like this for example:
@abcfy2 commented on GitHub (May 29, 2022):
I don't think Linux support dark mode for Qt out of box. I tried both KDE and XFCE desktop environment, though I set a dark theme globally, qbittorrent will choose a light mode:
@adem4ik commented on GitHub (May 29, 2022):
@abcfy2 The problem must be on your side. Your screen shows unofficial qB build called "Enhanced Edition". I guess your should report the problem to its devs: https://github.com/c0re100/qBittorrent-Enhanced-Edition
With official client I have dark mode working on my Manjaro KDE for a long time:

@abcfy2 commented on GitHub (May 29, 2022):
I also tried official AppImage, but still no luck:
@abcfy2 commented on GitHub (May 29, 2022):
And I installed
qbittorrentviasudo pacman -S qbittorrent, still this issue:@KousikAdhikary commented on GitHub (Jun 4, 2022):
Yes an official Dark Theme for Windows will be much appreciated.
@Amandaville commented on GitHub (Oct 24, 2022):
Dark mode and themes are not working on MX Linux XFCE
@ghost commented on GitHub (Nov 27, 2022):
I wouldn't say no to auto dark mode option aside with a dark theme.
@jupiter104 commented on GitHub (Dec 4, 2022):
We need this urgently. 99% of my friends use dark mode. I don't know why qbt comes with light mode by default.
@maboroshin commented on GitHub (Dec 13, 2022):
qBittorrent have basic dark theme. What files we need to edit to change this Native Theme?
Color issues are common with light themes. Don't use extreme colors #000000 or #FFFFFFFF, 255 or 0. #11111111, #FAFAFAFA would be better. The same is for icon colors. Since icons are svc, it is easy to change the color as a string.
Also we would like to change the theme without restarting qBittorrent.
Current 4.5.0 Native Dark Theme:

I saw previous issue https://github.com/qbittorrent/qBittorrent/pull/13952#issuecomment-743341836
With the following statement, qBittorrent switches between light and dark themes according to the system settings without restarting qBittorrent.
I think Qt can be buggy with color overrides. But difficult to read text seems to be limited to the options dialog at this theme: https://github.com/qbittorrent/qBittorrent/pull/13952#issuecomment-1008637439
qt.conf(This file placed in the same folder asqbittorrent.exe) :@Hlsgs commented on GitHub (May 29, 2023):
Prior to version 4.5.3, one could get a rudimetary dark mode in Windows by adding the
QT_QPA_PLATFORM=windows:darkmode=2environment variable or using the corresponding command line parameter to start the application. This is no longer the case, presumably because of the update to Qt v6.5.1.However, this big Qt upgrade being done merits reopening this neverending discussion, considering the improvements to dark mode handling that came with v6.5. I'm hoping this would also mitigate the dreaded issue of the white flashing main window when restoring qBT from the system tray. It's been mentioned around.
Coming at this myself from the visual impairment perspective, I would like to add a request(for which I will create a separate issue, if instructed): it would be great if both the default light and the presumptive native dark mode had the option to not color the text of torrents according to their status, but rather rely solely on their icons for that.
@xavier2k6 commented on GitHub (May 29, 2023):
@Hlsgs If you read through Dark Mode on Windows 11 with Qt 6.5 you will notice below:
@glassez You might also be interested in above quote from Qt.
So, there have been changes from how Qt used to provide a sort of dark mode prior to Qt 6.5...it was meant to have been reverted/fixed in Qt 6.5.1 but doesn't seem to be. (We still need to use
fusionstyle)If you or anyone else would like to experiment with how "Dark Mode Support on Windows" is progressing & how the text colors etc. can now be changed in transfer list by user - download the
4.6.0alpha1Qt6 Build & you can use below command via command prompt:qbittorrent -style fusion@glassez commented on GitHub (May 29, 2023):
IIRC,
qbittorrent -style fusionis enough with Qt 6.5.x@xavier2k6 commented on GitHub (May 29, 2023):
So it seems....
qbittorrent -style fusion -platform windows:darkmode=1seems to also only provide light mode whereas before it would give a dark mode but keep title bar window light?!Anyway, will adjust https://github.com/qbittorrent/qBittorrent/issues/17081#issuecomment-1567352582
@maboroshin commented on GitHub (May 29, 2023):
This may be outdated information. As of 2022, the color of the Windows title bar was changed through the OS settings (Win10) or other app (MicaForEveryone for Win11).
Detail: https://github.com/maboroshin/qBittorrentDarktheme/issues/19#issuecomment-1087499340
@Hlsgs commented on GitHub (May 29, 2023):
@xavier2k6
Thank you for all the great info. Didn't know about using the
fusionstyle and was unaware of all the work that's getting done in 4.6.0 regarding colors. Just tested fusion in both 4.5.3 and 4.6.0 and it's basically all that I was asking about. Awesome!Couple of questions:
@glassez commented on GitHub (May 29, 2023):
In v4.6 I intend to raise minimum supported Qt version to 6.5 on Windows and use Fusion style by default (at least on Windows 11, unsure about Windows 10).
@xavier2k6 commented on GitHub (May 29, 2023):
@glassez has already addressed the default style option, but just to give a little more context:
From the Qt Blog (Above):
https://www.qt.io/blog/dark-mode-on-windows-11-with-qt-6.5#:~:text=The%20Fusion%20style%20is%20our%20preferred%20style%20for%20Windows%2011.%20It%20looks%20good%20with%20dark%20and%20light%20palette
None that I have observed & I've used fusion style for a long time....it also addresses some checkbox issues etc......now there are caveats with "Dark Mode Support" still & these will be resolved over time.
@Hlsgs commented on GitHub (May 29, 2023):
Are there any issues specifically with fusion on Windows 10? If not, and seeing as you're also dropping support for older Windows versions(good riddance), I don't see why you would bother with supporting anything but fusion going forward on both W10 and W11.
@xavier2k6 commented on GitHub (May 29, 2023):
Again none observed & as I've pointed out numerous times in other tickets...it has other benefits!
Qt have been suggesting/recommending
fusioneven since Qt5 especially forHigh DPI Supportas I mentioned in https://github.com/qbittorrent/qBittorrent/issues/13603#issuecomment-768308736High DPI Support in Qt
ref:
https://doc.qt.io/qt-5/highdpi.html#:~:text=Windows%20desktop%20style%20currently%20has%20some%20limitations%20with%20certain%20scale%20factors.%20In%20these%20cases,%20consider%20using%20the%20Fusion%20style%20instead
@Hlsgs commented on GitHub (May 29, 2023):
Thank you for all the great info. Just one more quick question: can fusion be enabled via
qt.confor does it have to be the command parameter?@xavier2k6 commented on GitHub (May 29, 2023):
I haven't really looked in to that, sorry.
Here's an example benefit IMO of going from
Qt default(left screenshot) tofusion(right screenshot)(Notice the
checkboxes& thekeyboard shortcuts)@xavier2k6 commented on GitHub (May 31, 2023):
@Hlsgs Not only does
fusionstyle present things properly or make the whole look & feel of qBittorrent better like I pointed out in https://github.com/qbittorrent/qBittorrent/issues/17081#issuecomment-1567470921 but it will also address another issue like "Use alternating row colors" not being displayed correctly (at least on windows 10)Here's some more info on Qt Styles -> https://doc.qt.io/qt-6/gallery.html
@glassez Has also now created a Use Fusion style on Windows 10+ PR so it will be the default in a future release...
@Hlsgs commented on GitHub (May 31, 2023):
@xavier2k6 Tried it and I agree. Very good to see it as default for Windows 10 as well going forward. I, however, will have to continue using a theme until 4.6.0 is out with support for removing colors from torrents' text. Many of the colors are illegible for me in dark mode and light mode is out of the question. Btw, do you think a checkbox in options to remove color from torrents with all statuses for 4.5.x as a stop-gap solution would be something the developers would consider?
Thank you again for the all the info!
@xavier2k6 commented on GitHub (May 31, 2023):
Not at the moment anyway.
@Lucatir commented on GitHub (Jun 29, 2023):
My comment might come a bit out of the left field, but if you, or anyone reading this, is on Windows 11 22H1 or newer, you might want to give the Fluent theme a try:
The preview image showcases both a dark and a light theme, so no worries that it mixes them in the UI. It will definitely be in a single color scheme of one's choice. 😂
Here's the link:
https://github.com/witalihirsch/qBitTorrent-fluent-theme/
PS: If one wants it to look exactly like the preview image (besides the splitting of dark and light), one also needs to use the application called "Mica everywhere". Without it, it won't probably look as good. More details at the link above.
Apologies if I derailed this issue topic a bit and apologies for any unwanted emails you'll get as a notification from my necro bump. 🙏
@Solarunit commented on GitHub (Aug 16, 2023):
Another vote for the internal built-in dark theme, I hope it would be a true dark theme, not an ugly grey one.
Depending on various Linux DEs in some cases it's impossible to apply a system dark theme to qbittorrent and internal dark theme is missing in the qbittorrent settings.
@masterwishx commented on GitHub (Sep 17, 2023):
is builded dark mode avalible in docker from webui ?
@xavier2k6 commented on GitHub (Oct 23, 2023):
I don't believe so, there's currently no dark mode support in WebUI.
There's a feature request open though in #18886
@masterwishx commented on GitHub (Oct 23, 2023):
Will be cool to have it in webui, using dark reader for now
@Kas152 commented on GitHub (Nov 1, 2023):
Maybe too much to ask, but a good darkmode would be great to have for sure. And then specifically an automated one that switches with the windows (11) theme. Could that be done? I'm unsing version 4.6 of qbittorrent. All this hassle to install a diffirent theme is a bit much for me. Just an automated native light/dark theme would be great!
@mzso commented on GitHub (Nov 7, 2023):
@Solarunit
Dark grey IS dark. Besides having black backgrounds is also rather harsh on the eyes.
@mzso commented on GitHub (Nov 7, 2023):
People mention "-style fusion" in this thread. Are there any others that can be tried out?
@mzso commented on GitHub (Nov 7, 2023):
@maboroshin
Putting this in qt.conf doesn't do anything here. Is this not supposed to work anymore?
(I also tried adding style=fusion to this section as well.)
@glassez commented on GitHub (Nov 7, 2023):
Windows Vista style, used on Windows by default, doesn't support dark mode. When you enable
darkmode=2(via command line, environment variable orqt.conf) Qt handles Windows dark mode by automatically change style to "legacy" Windows. This doesn't seem to work anymore, starting with Qt 6.5, so you need to manially activate some style that supports dark mode. In a future version, we are testing Fusion style to be used by default.@masterwishx commented on GitHub (Nov 7, 2023):
Also for WebUI ?
@glassez commented on GitHub (Nov 7, 2023):
No. It has nothing to do with WebUI.
Maybe something like #19847 will be finished after all...
@Kas152 commented on GitHub (Nov 7, 2023):
That would be awesome 👍🏻. Just a simple, effective and automated dark mode, native to qbittorrent. So that you only have to tick a box to either enable or disable the automatic dark mode.
@xavier2k6 commented on GitHub (Nov 7, 2023):
Dark Mode Requirements:
1903+IIRC)Example:
Should you wish to enable
Dark Mode& run Official qBittorrent 4.6.0 (Qt 6.4.3)command promptcd C:\Program Files\qBittorrentin this command prompt or where "qBittorrent" is installed.qbittorrent -style fusion -platform windows:darkmode=2(Command used for any qBittorrent based builds of Qt 5.15.x or <=Qt 6.4 Series)
Or
qbittorrent -style fusionfor any Official qBittorrentQt 6.5 Seriesbased build(Qt are using the equivalent
darkmode=2switch asdefaultas of Qt 6.5 Series.)(
-style fusionis a Qt recommended style command)NONE of these commands nor the need to run qBittorrent through
command promptor with associated shortcuts will be necessary in a future release withDark Mode on Windows SupportAre there caveats to current
Dark Modesupport? - YesAre these caveats being worked on by the qBittorrent team? - Yes & No, some caveats are introduced by upstream Qt & require them to fix eg. QTBUG-112879
Why is
Windows 10 1903+required whenmin supported platformof Qt 5 is Windows 10 21H2 & Qt 6.x is Windows 10 1809+?https://doc.qt.io/qt-6/qguiapplication.html#platform-specific-arguments
@mzso commented on GitHub (Nov 7, 2023):
@xavier2k6 Why don't these work when I add them to the qt.conf file? The file is there to begin with. And it seems like this is the sort of thing it was meant for.
@xavier2k6 commented on GitHub (Nov 7, 2023):
only darkmode switch can be used in
qt.confas long as it's set right but it's best to stick with my approach above.@Kas152 commented on GitHub (Nov 8, 2023):
This is a perfect example why I plead for an automated, no nonsense, dark mode. So that everyone can use it and not only the ones who are computer knowledgeable.
@mzso commented on GitHub (Nov 8, 2023):
@Kas152 I guess they only want to release it if it's polished/bug-free.
By the way. Editing the qt.conf also works, as I found.
You need to uncomment and change the extant WindowsArguments line. (or create a new one) Such as:
WindowsArguments = darkmode=2I guess changing style does not matter, since no-one mentioned any other than "fusion", that can be used.
@xavier2k6 commented on GitHub (Nov 8, 2023):
It does matter....read https://github.com/qbittorrent/qBittorrent/issues/17081#issuecomment-1800271828 especially
Platform-Specific Argumentslink in relation to dark mode switches!!Also see screenshots from https://github.com/qbittorrent/qBittorrent/issues/17081#issuecomment-1567470921
It is also recommended for proper High DPI Support
https://doc.qt.io/qt-5/highdpi.html#:~:text=Windows%20desktop%20style%20currently%20has%20some%20limitations%20with%20certain%20scale%20factors.%20In%20these%20cases,%20consider%20using%20the%20Fusion%20style%20instead
Also read https://www.qt.io/blog/dark-mode-on-windows-11-with-qt-6.5
I've mentioned this countless times in different various tickets etc.
Styles that are available:
Windows style(legacy)Windows Vista style(default)Fusion styleThere's other styles but they're for
macOS@Kas152 It will me automated when implemented in an official release & we use Qt 6.5+
Qt 6.6.1 will bring a required fix from QTBUG-112879
Although Qt 6.5.4 will also have that fix, we will not be able to use it for at least a year due to it being a LTS Commercial Release
@mzso commented on GitHub (Nov 8, 2023):
@xavier2k6
I see what you mean. The main thing is the alternating rows, that only works with fusion.
Though with QB 4.6 using fusion on Win10 I don't see such bug, or any others. So dark theme might as well have been enabled.
@Solarunit commented on GitHub (Nov 8, 2023):
@mzso
What kind of dark grey we are talking about? Is there official dark theme? Can you share some screenshots?
My point was that there are many apps that comes with dark theme option, but that dark theme is very ugly, because they are using light grey colors.
@xavier2k6 commented on GitHub (Nov 8, 2023):
That's because qBittorrent 4.6.0 uses Qt 6.4.3.... the bug was introduced in Qt 6.5 Series, we used it in a release or two but we had to revert because of caveats found & Qt 6.5.x caused crashes on macOS.
All good things to those who wait.......
@luzpaz commented on GitHub (Nov 8, 2023):
@xavier2k6 are we marking this a qt bug and watiing for upstream ?
@xavier2k6 commented on GitHub (Nov 8, 2023):
I don't think there's a need...TBH, but I won't object either.
@Solarunit commented on GitHub (Nov 8, 2023):
@PriitUring
I see. I prefer much more darker themes.
@xavier2k6 commented on GitHub (Nov 8, 2023):
@mzso please also review your open issues & close if no longer relevant....
@mzso commented on GitHub (Nov 8, 2023):
@xavier2k6
Forgive me, but I still don't see an issue. If 6.4.3 works everywhere, and is in fact what's used, dark theme can be deployed with it. And sometime in the future when 6.5.* is fixed switch to that if/when it's needed.
I don't think I have any for the theme.
@xavier2k6 commented on GitHub (Nov 8, 2023):
You need the workarounds/commands etc. for dark mode to be enabled currently which I've already explained.
In
masterwe have made theFusionstyle the default instead ofWindows Vistastyle, our CI builds use Qt 6.5 & will be updated to Qt 6.6.1 if the current dark mode bug is resolved.@xavier2k6 commented on GitHub (Nov 8, 2023):
I don't think the
fusionstyle will be backported.....next official 4.6.x may or may not use a Qt 6.6+ version. (I would think unlikely)Qt 6.5+ have changed how the
accentcolor on Windows is used....so it will affect the likes of the ProgressBar, alternate rows etc.@Sobanim commented on GitHub (Dec 9, 2023):
I really miss the automatic dark mode. During the day I have light themes everywhere, and when the sun sets everything turns into dark themes
@Symbai commented on GitHub (Dec 30, 2023):
So I just installed 4.6.2. I got Windows 11 with dark mode enabled. I start qbittorrent and its all white. Is there any progress or is "do this, go there, edit that, run this command" still the official "solution"?
How hard can it be to just add a combobox to settings to switch between dark and light mode? All apps have this nowadays. So strange that qbittorrent is struggling with this for so many years. I guess none of the developers are windows users.
@xavier2k6 commented on GitHub (Dec 31, 2023):
Running with command is currently the suggested solution for any "Release" version.
As stated previously there are known bugs in Qt that got fixed in Qt 6.6.1, there are other changes required or at least to be discussed between the team.
fusion stylewas made default for Windows 10+ inmasterwhich will be included in a future release.Qt now also have created a Windows 11 style as of Qt 6.7 Beta 1, (to the best of my knowledge - no team member has tested this yet. (I know I haven't))
What does this mean for us, we may need to cater for both OS Styles...
fusionstyle.windows11style@glassez commented on GitHub (Dec 31, 2023):
Just adding a combo box is not so hard. It's quite another thing to get it to do the job, i.e. add full-fledged support for the dark mode. And here not everything depends only on us. Do not forget that the native dark mode in Windows appeared not so long ago. Its Qt support is constantly being improved, but it still has some disadvantages. We also try to follow them to the extent of our limited capabilities.
None of (active) developers use dark mode to have a personal interest in it.
@xavier2k6 commented on GitHub (May 25, 2024):
See progress:
EDIT: Removed outdated video & uploaded new one which shows
WebUI&GUI- Dark "App" Mode (Native Support)https://github.com/qbittorrent/qBittorrent/assets/42386382/219586bf-2806-45b1-a48c-4c23087062d7
@Sobanim commented on GitHub (May 25, 2024):
How did you do it?
When will this be in the new version of the program?
@xavier2k6 commented on GitHub (Jun 8, 2024):
I didn't really do anything except make suggestions according to Qt's blogs/documentation & provided testing to other team members who made the necessary changes/implemented the requirements etc.
If you require more verbose details then please feel free to ask & will try my best to answer them/point you in the right dirction.
Information is in this ticket. (fusion style/Qt 6.5 "dark mode" etc.)
v5 - Officially, current Beta (publicly available) & soon to be released "Release Candidate" will have this support, there is still some small caveats that need to be worked out for WebUI (I need to make tickets, so these can be followed up/worked on)
@maboroshin commented on GitHub (Aug 1, 2024):
I have created as a new isssue : https://github.com/qbittorrent/qBittorrent/issues/21433
The color of the built-in icons for auto dark theme needs to be adjusted. Because of the 255 red and other unadjusted colors remain in use. (This means that even light themes need to be adjusted) Please adjust the colors to a highly visible color that is not excessively bright. I have previously created a Javascript for Windows that converts color values in SVGs.
key points
@qBittUser commented on GitHub (Sep 30, 2024):
This should be closed, because stable v5.0.0 has been released with native dark support.
Ideas to improve should be discussed in the Discussions page and to suggest extra options there should be a new Feature Request.
@xavier2k6 commented on GitHub (Sep 30, 2024):
This ticket along with others in relation to fixes brought about by using
fusionstyle will be closed in due course.@maboroshin commented on GitHub (Sep 30, 2024):
Improve colors for new icons https://github.com/qbittorrent/qBittorrent/issues/21433
@masterwishx commented on GitHub (Sep 30, 2024):
Thanks for Dark theme for webUI in v5.0
Still Some Text is white on white in torrent panel where Name, Size etc:
@xavier2k6 commented on GitHub (Sep 30, 2024):
@masterwishx trying clearing cache.
I believe this issue was already fixed, haven't checked if it was backported.
There are still some caveats for WebUI/Dark mode & you can subscribe to:
@masterwishx commented on GitHub (Sep 30, 2024):
Thanks it seems was some cache issue ... now its fine
@xavier2k6 commented on GitHub (May 24, 2025):
ANNOUNCEMENT!
For anybody coming across this "Feature Request" & would like/love to see a potential implementation in the future!
Here are some options available to you:
Please select/click the 👍 &/or ❤
reactionsin the original/opening post of this ticket.Please feel free (If you have the "skillset") to create a "Pull Request" implementing what's being requested in this ticket.
(new/existing contributors/developers are always welcome)
DO:
DO NOT:
(These will be disregarded/hidden as "spam/abuse/off-topic" etc. as they don't provide anything constructive.)
@xavier2k6 commented on GitHub (Jun 9, 2025):
Closing as 5.1.0 allows for users to choose the style - fusion/windows11/vista etc. as well as choose the color scheme auto/light/dark etc.
Anything else that is not in 5.1.0, but mentioned here.......follow/subscribe to the relevant ticket/pull request
@Solarunit commented on GitHub (Jun 9, 2025):
What about Linux version?
@xavier2k6 commented on GitHub (Jun 9, 2025):
What about it? linux/macOS already followed system as far as I'm aware...