mirrors/qBittorrent
1
0
Fork 0
mirror of https://github.com/qbittorrent/qBittorrent.git synced 2024-10-22 02:36:15 +03:00
Code Issues Projects Releases Packages Wiki Activity

More details

Prince Gupta 2020-04-28 21:44:59 +05:30
parent 7976e28b21
commit a132ccaf9c
1 changed files with 39 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

40
How-to-use-custom-UI-themes.md

@ -11,4 +11,42 @@ After you have downloaded your chosen `.qbtheme` theme file, using it is quite e
1. Enable `Menu->Tools->Options->Behavior->Interface->Use custom UI Theme` and select the `.qbtheme` file
2. Restart QBittorrent for the `.qbtheme` to take effect.
![example theme setup](https://user-images.githubusercontent.com/36061843/77887653-cef5f680-721f-11ea-88ab-d7b33c190f9b.png)
![example theme setup](https://user-images.githubusercontent.com/36061843/77887653-cef5f680-721f-11ea-88ab-d7b33c190f9b.png)
# What are .qbttheme files?
These are theme bundles for qBittorrent. This should contain all files required to support theming in qBittorrent and are packed using [Qt's Resource Compiler](https://doc.qt.io/qt-5/rcc.html). QBittorrent accesses files inside `.qbttheme` using [Qt's Resource System](https://doc.qt.io/qt-5/resources.html), currently, QBittorrent only searches `stylesheet.qss` inside `.qbttheme` file.
# How to create your own theme bundles?
You can check out this Python script([here](https://github.com/jagannatharjun/qbt-theme/blob/master/Builds/make-resource.py)) for the easy creation of .qbttheme file. QBitTorrent mounts `.qbttheme` file in `:uitheme` prefix, so every file should be referenced accordingly inside `stylesheet.qss`. QBittorrent loads `stylesheet.qss` to support theming. `stylesheet.qss` is basically a [Qt's style sheet](https://doc.qt.io/qt-5/stylesheet.html). You can read more about stylesheet's syntax [here](https://doc.qt.io/Qt-5/stylesheet-syntax.html) and a reference can be found [here](https://doc.qt.io/qt-5/stylesheet.html)
# Special Cases
For changing Transfer List row colors which are based on concerned torrent state, one can add the following to their `stylesheet.qss`.
```css
TransferListWidget
{
qproperty-downloadingStateForeground: limegreen;
qproperty-forcedDownloadingStateForeground: limegreen;
qproperty-downloadingMetadataStateForeground: limegreen;
qproperty-allocatingStateForeground: #cccccc;
qproperty-stalledDownloadingStateForeground: #cccccc;
qproperty-stalledUploadingStateForeground: #cccccc;
qproperty-uploadingStateForeground: #63b8ff;
qproperty-forcedUploadingStateForeground: #63b8ff;
qproperty-pausedDownloadingStateForeground: #fa8090;
qproperty-pausedUploadingStateForeground: #4f94cd;
qproperty-errorStateForeground: red;
qproperty-missingFilesStateForeground: red;
qproperty-queuedDownloadingStateForeground: #00cdcd;
qproperty-queuedUploadingStateForeground: #00cdcd;
qproperty-checkingDownloadingStateForeground: #00cdcd;
qproperty-checkingUploadingStateForeground: #00cdcd;
qproperty-checkingResumeDataStateForeground: #00cdcd;
qproperty-movingStateForeground: #00cdcd;
qproperty-unknownStateForeground: red;
}
```