darkine-kde/README.md

<p align="center">
    <a href="https://raw.githubusercontent.com/Rokin05/darkine-kde/master/plasma/look-and-feel/darkine/contents/previews/fullscreenpreview.jpg">
        <img width="100%" src="plasma/look-and-feel/darkine/contents/previews/fullscreenpreview.jpg" alt="Darkine theme - KDE Plasma"/>
    </a>
    <a href="https://raw.githubusercontent.com/Rokin05/darkine-kde/master/sddm/themes/darkine/preview.jpg"><img width="400" src="sddm/themes/darkine/preview.jpg" alt="Darkine - SDDM theme"/></a> <a href="https://raw.githubusercontent.com/Rokin05/darkine-kde/master/wallpapers/Darkine/contents/screenshot.png"> <img width="380" src="wallpapers/Darkine/contents/screenshot.png" alt="Darkine - SDDM theme"/></a>
</p>


## Darkine KDE - Theme for KDE Plasma 5 desktop :

The full theme collection is available on [OpenDesktop.org](https://www.opendesktop.org/c/1304956/) and on KDE Plasma Discover. <br>
You can also use the script below to install the latest version directly from this repo (independently on your distro).

<br>

| Name                      | Git (path)                        | OpenDesktop (tar.gz)                                  | Misc                      |
|:--------------------------|:---------------------------------:|:-----------------------------------------------------:|:--------------------------|
| Plasma Look-and-Feel Pack | [:link:](plasma/look-and-feel)    | [:inbox_tray:](https://www.opendesktop.org/p/1226052) |                           |
| Plasma Desktop Theme      | [:link:](plasma/desktoptheme)     | [:inbox_tray:](https://www.opendesktop.org/p/1226050) |                           |
| Plasma Color Scheme       | [:link:](color-schemes)           | [:inbox_tray:](https://www.opendesktop.org/p/1226045) |                           |
| Aurorae Theme             | [:link:](aurorae)                 | [:inbox_tray:](https://www.opendesktop.org/p/1226049) |                           |
| Kvantum Theme             | [:link:](Kvantum)                 | [:inbox_tray:](https://www.opendesktop.org/p/1226051) |                           |
| GTK Theme                 | [:link:](theme/Darkine)           | [:inbox_tray:](https://www.opendesktop.org/p/1305725) | [Known bug (Firefox)](#-Known-bug)) |
| Icon-pack                 | [:link:](icons)                   | [:inbox_tray:](https://www.opendesktop.org/p/1304954) |                           |
| SDDM Theme                | [:link:](sddm)                    | [:inbox_tray:](https://www.opendesktop.org/p/1226079) |                           |
| Konsole color-scheme      | [:link:](konsole)                 | [:inbox_tray:](https://www.opendesktop.org/p/1305370) |                           |
| Wallpapers                | [:link:](wallpapers/Darkine)      | [:inbox_tray:](https://www.opendesktop.org/p/1305212) |                           |
| Wallpapers (2018)         | [:link:](wallpapers/Darkine-2018) | [:inbox_tray:](https://www.opendesktop.org/p/1226061) |                           |
| Firefox Quantum Theme     | [:link:](extra/firefox)           | [:inbox_tray:](https://www.opendesktop.org/p/1304958) | [Darkine at addons.mozilla.org](https://addons.mozilla.org/addon/darkine) |
<br>

## Installation

#### Install
```
wget -qO- https://raw.githubusercontent.com/Rokin05/darkine-kde/master/install.sh | sh
```

#### Uninstall
```
wget -qO- https://raw.githubusercontent.com/Rokin05/darkine-kde/master/install.sh | uninstall=true sh

```
<br>

#### Note about SDDM theme :
_The SDDM Thème is build from scratch with [QtQuick 2](https://doc.qt.io/qt-5/qtquick-index.html) (Qt 5.7 >=)._<br>
_This is compatible with and without [KDE Plasma](https://kde.org/plasma-desktop) and not depend of KDE Framework._<br>
_You can learn more about it at : [SDDM-Themes (Git)](https://github.com/Rokin05/SDDM-Themes)._

Dependencies (sddm only)
> On KDE Plasma desktop, you normally have nothing more to install, but if one dependency is not present on other environments here are those used :

##### ● Debian / Ubuntu :
```shell
# On Ubuntu, universe repo maybe necessary : 
# add-apt-repository universe
apt-get update 
apt-get install qml-module-qtquick-layouts qml-module-qtquick-controls2 qml-module-qtquick-templates2 qml-module-qtgraphicaleffects
```

##### ● Arch :
```shell
pacman -S qt5-quickcontrols2 qt5-graphicaleffects qt5-svg
```
<br>

## Recommendations

- For better looking please use this pack with [Kvantum engine](https://github.com/tsujan/Kvantum/tree/master/Kvantum). <br>
  Run `kvantummanager --set Darkine` to choose and apply theme.
<br>

#### Fonts :
```
# Arch :
sudo pacman -S adobe-source-code-pro-fonts ttf-roboto

# dnf (Fedora)
sudo dnf install adobe-source-code-pro-fonts google-roboto-fonts

# pkg(8) (FreeBSD)
pkg install sourcecodepro-ttf roboto-fonts-ttf

kwriteconfig5 --file kdeglobals --group General --key fixed "Source Code Pro,9,-1,5,50,0,0,0,0,0,Regular"
kwriteconfig5 --file kdeglobals --group General --key font "Roboto,10,-1,5,50,0,0,0,0,0,Regular"
kwriteconfig5 --file kdeglobals --group General --key menuFont "Roboto,10,-1,5,50,0,0,0,0,0,Regular"
kwriteconfig5 --file kdeglobals --group General --key smallestReadableFont "Roboto,8,-1,5,50,0,0,0,0,0,Regular"
kwriteconfig5 --file kdeglobals --group General --key toolBarFont "Roboto,10,-1,5,50,0,0,0,0,0,Regular"
kwriteconfig5 --file kdeglobals --group WM --key activeFont "Roboto,9,-1,5,50,0,0,0,0,0,Regular"

qdbus org.kde.KWin /KWin reconfigure
kquitapp5 plasmashell && kstart5 plasmashell
```

#### Toolbar icon size :
```
kwriteconfig5 --file kdeglobals --group MainToolbarIcons --key Size "22"
kwriteconfig5 --file kdeglobals --group ToolbarIcons --key Size "22"

qdbus org.kde.KWin /KWin reconfigure
kquitapp5 plasmashell && kstart5 plasmashell
```


<br>

## Known bug

##### ● Firefox / Thunderbird + GTK3 theme :

The rendering is not perfect with dark theme, The main background of the selected tab and the highlighted text in the main menu follow bad or does not follow the colors of the GTK theme so I have tried to deal with that how i can.

To improve that, if you want keep the dark theme you can use the Firefox (WebExtension) theme specially made for it and available on [addons.mozilla.org](https://addons.mozilla.org/addon/darkine).

###### Alternative 1 : you can make Firefox (46+) ignore the GTK theme with the following commands examples :
```
# For KDE Desktop
env GTK_THEME=Breeze:light firefox
env GTK_THEME=Breeze:light thunderbird
# For Gnome Desktop
env GTK_THEME=Adwaita:light firefox
env GTK_THEME=Adwaita:light thunderbird
```
_* Note : The current Firefox (WebExtension) theme style only the main window/tab and keep the menu white. It can be used in addition or without the GTK theme._

###### Alternative 2 : Change the GTK theme for content process only :
To force Firefox to use a light theme (e.g. Adwaita) for web content only :

    1) Open about:config in the address bar.
    2) Create a new widget.content.gtk-theme-override string type entry (right mouse button > New > String).
    3) Set the value to the light theme to use for rendering purposes (e.g. Adwaita:light).
    4) Restart Firefox.


######  HTML Textarea and checkbox :
This is another Firefox bug with GTK Theme, it's possible to fix that with a custom userContent.css file :
```
1) Create userContent.css file in your Firefox profil folder : ~/.mozilla/firefox/<your-profil>/chrome/userContent.css
2) Past the css code :

/* FIX GTK THEME */
textarea, input, select {
    -moz-appearance: none !important;
    background-color: #eee;
    color: #111;
}

3) Restart Firefox.
```
_Ref : [Arch Wiki](https://wiki.archlinux.org/index.php/Firefox/Tweaks)._

<br>

## Licence

Source code of is licensed under GNU GPL version 3.<br>
QML files are MIT licensed and images are CC BY 3.0.

<br>

## Credits

- [Git](https://github.com/KDE/breeze-icons) - KDE Plasma -  _(Breeze)_.
- [Git](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme) - Papirus -  _(PapirusDevelopmentTeam)_.
- [Git](https://github.com/EliverLara/Sweet) - Sweet - _(For the GTK WM icons)_.

<br>

## Donate

The development, the publication and the different tests are done in my free time,<br>
If you like my project, you can send a coffee at : 

<span class="paypal"><a href="https://www.paypal.me/Rokin05" title="Donate to this project using Paypal"><img src="https://www.paypalobjects.com/webstatic/mktg/Logo/pp-logo-100px.png" alt="PayPal donate button" /></a></span>