diff --git a/customization/dark-theme.md b/customization/dark-theme.md index 91bd5e58..b82ba8a3 100644 --- a/customization/dark-theme.md +++ b/customization/dark-theme.md @@ -4,11 +4,209 @@ title: Dark Theme in Dom0 and DomU permalink: /doc/dark-theme/ --- -Dark KDE in dom0 +Dark Theme in Dom0 +================== + +Dark KDE in Dom0 ---------------- +The following text describes how to change the default light theme to a dark theme. This is just an example, feel free to adjust the appearance to your taste. + +The image below shows the default light theme after installation. +![begin light theme](/attachment/wiki/Dark-Theme/kde-fresh-installed-standard.png) + +This is the result after applying the steps described here. +![end result dark theme](/attachment/wiki/Dark-Theme/kde-end-result.png) + +1 - Change `Workspace Appearance` + + 1. Open the `Workspace Appearance` window + + ~~~ + Qubes Menu -> System Tools -> System Settings -> Workspace Appearance + ~~~ + + ![Workspace Appearance](/attachment/wiki/Dark-Theme/kde-app-appearance-menu-style.png) + + 2. Go to `Desktop Theme` + + ![Desktop Menu](/attachment/wiki/Dark-Theme/kde-appearance-settings-desktop-theme-oxygen.png) + + 3. Select `Oxygen` and `Apply` the change + +2 - (Optional) Remove blue glowing task items + +![blue glowing task bar items](/attachment/wiki/Dark-Theme/kde-taskbar-blue-glowing-border.png) + + 1. Adjust Oxygen `Details` + + ~~~ + Qubes Menu -> System Tools -> System Settings -> Workspace Appearance -> Desktop Theme -> Details (Tab) + ~~~ + + 2. Select `Oxygen` + + 3. Change `Theme Item -> Task Items` from `Oxygen Task Items` to `Air Task Items` + + ![Change Task items look](/attachment/wiki/Dark-Theme/kde-desktop-theme-details.png) + 4. Apply changes + + ![task bar items blue glowing removed](/attachment/wiki/Dark-Theme/kde-taskbar-blue-glowing-removed.png) + +3 - Change `Application Appearance` + + 1. Open the `Application Appearance` window + + ~~~ + Qubes Menu -> System Tools -> System Settings -> Application Appearance + ~~~ + + 2. Go to `Colors` + + ![colors tab](/attachment/wiki/Dark-Theme/kde-app-appearance-menu-colors.png) + + 3. Select `Obsidian Coast` + + ![set to Obsidian Coast](/attachment/wiki/Dark-Theme/kde-app-appearance-menu-colors-set.png) + + 4. Apply Changes + + Qubes VM Manager should now look like the image below. + + ![result black Qubes Manager](/attachment/wiki/Dark-Theme/kde-black-qubes-manager.png) + +**Note:** Chaning the `Window Decorations` from `Plastik for Qubes` will remove the border color and the VM name. The problem with `Plastik for Qubes` is it does not overwrite the background and text color for Minimize, Maximize and Close buttons. The three button are therefor hard to read. + +Dark XCFE in Dom0 +----------------- + +The following text describes how to change the default light theme to a dark theme. This is just an example, feel free to adjust the appearance to your taste. + +The image below shows the default light theme after installation. +![begin light theme](/attachment/wiki/Dark-Theme/xfce-fresh-installed.png) + +This is the result after applying the steps described here. +![end result dark theme](/attachment/wiki/Dark-Theme/xfce-end-result.png) + +1 - Change Appearance + + 1. Open the `Appearance` dialog + + ~~~ + Qubes Menu -> System Tools -> Appearance + ~~~ + + ![appearance dialog](/attachment/wiki/Dark-Theme/xfce-appearance-dialog.png) + + 2. Change Style to `Albatross` + +**Note:** The black appearance theme `Xfce-dusk` makes the VM names in the `Qubes OS Manager` unreadable. + +2 - *(Optional)* Change Window Manager Style + + 1. Open the `Window Manager` dialog + + ~~~ + Qubes Menu -> System Tools -> Appearance + ~~~ + + ![window manager dialog](/attachment/wiki/Dark-Theme/xfce-window-manager-theme.png) + + 2. Change the Theme in the `Style` Tab (e. g. Defcon-IV). All available themes work. +Dark App VM, Template VM, Standalone VM, HVM (Linux Gnome) +========================================================== -Dark Qube (VM) --------------- +Almost all Qubes VM's are based on the Gnome desktop. Therefor the description below is focused on the Gnome Desktop Environment. + +Using `Gnome-Tweak-Tool` +------------------------ + +The advantage of creating a dark themed Template VM is, that each AppVM which is derived from the Template VM will be dark themed by default. + +**Note:** Gnome-Tweak-Tool crashes under Archlinux. A workaround is to assign the AppVM to another TemplateVM (Debian, Fedora) which has Gnome-Tweak-Tool installed. Start the AppVM and configure the settings. Shutdown the machine and switch the template VM back to Archlinux. + +0 - Start VM + +**Note:** In case of App VM start the Template on which the AppVM is based on. + +1 - Install `Gnome-Tweak-Tool` + + 1. Fedora + + ~~~ + sudo dnf install gnome-tweak-tool + ~~~ + + 2. Debian + + ~~~ + sudo apt-get install gnome-tweak-tool + ~~~ + +2 - *(Only AppVM)* Stop template and start AppVM + +3 - Add `Gnome-Tweak-Tool` to the Application Menu + + 1. `Right-click` on VM entry in `Qubes VM Manager` select `Add/remove app shortcuts` + + 2. Select `Tweak Tool` and press the `>` button to add it + + ![Application Dialog](/attachment/wiki/Dark-Theme/dialog-add-gnome-tweak-tool.png) + +4 - Enable `Global Dark Theme` + + 1. *Debian only* + + ~~~ + cd ~/.config/ + mkdir gtk-3.0 + cd gtk-3.0/ + touch settings.ini + ~~~ + + 2. Start `Tweak Tool` from the VM application menu and set the `Global Dark Theme` switch to `on` + + ![Global Dark Theme enabled](/attachment/wiki/Dark-Theme/gnome-tweak-tool.png) + +5 - *(Optional)* Modify Firefox + +**Note:** Firefox uses GTK style settings by default. This can create side effects such as unusable forms or search fields. There are two different ways to avoid this. Either by using a add-on or by overwriting the defaults. + + - use the theme [GTK+ Dark Theme Global Fixes](https://userstyles.org/styles/111694/gtk-dark-theme-global-fixes) and the [Stylish](https://addons.mozilla.org/en-US/firefox/addon/stylish/) addon + + - or add the following line to `/rw/config/rc.local` + + ~~~ + sed -i.bak "s/Exec=firefox %u/Exec=bash -c 'GTK_THEME=Adwaita:light firefox %u'/g" /usr/share/applications/firefox.desktop + ~~~ + +6 - Restart VM or all application + +Manually +-------- + +Manually works for Debian, Fedora and Archlinux. + +0 - Start VM + +**Note:** In case of App VM start the Template on which the AppVM is based on. + +1 - Enable `Global Dark Theme` + +~~~ +cd ~/.config/ +mkdir gtk-3.0 +cd gtk-3.0/ +touch settings.ini +~~~ + +add the following lines to `settings.ini` + +~~~ +[Settings] +gtk-application-prefer-dark-theme=1 +~~~ + +2 - follow step 5 and 6 in: Using `Gnome-Tweak-Tool` diff --git a/doc.md b/doc.md index 4060e4c1..373a8c90 100644 --- a/doc.md +++ b/doc.md @@ -63,6 +63,9 @@ Managing Operating Systems within Qubes * [Templates: Archlinux](/doc/templates/archlinux/) * [Templates: Ubuntu](/doc/templates/ubuntu/) * [Templates: Whonix](/doc/whonix/) + * [Pentesting: BlackArch](/doc/pentesting/blackarch/) + * [Pentesting: Kali](/doc/pentesting/kali/) + * [Pentesting: PTF](/doc/pentesting/ptf/) * [Installing and Using Windows-based AppVMs (Qubes R2 Beta 3 and later)](/doc/windows-appvms/) * [Creating and Using HVM and Windows Domains (Qubes R2+)](/doc/hvm/) * [Advanced options and troubleshooting of Qubes Tools for Windows (R3)](/doc/windows-tools-3/) @@ -139,6 +142,7 @@ Customization Guides * [Installing XFCE in dom0](/doc/xfce/) * [Installing i3 in dom0](/doc/i3/) * [Language Localization](/doc/language-localization/) + * [Dark Theme in Dom0 and DomU](/doc/dark-theme/) Troubleshooting @@ -187,4 +191,3 @@ For Developers * [Qubes OS License](/doc/license/) * [Style Guide](/doc/style-guide/) * [Usability & UX](/doc/usability-ux/) - diff --git a/managing-os/pentesting/kali.md b/managing-os/pentesting/kali.md index 36c95ab1..fe8ed787 100644 --- a/managing-os/pentesting/kali.md +++ b/managing-os/pentesting/kali.md @@ -42,7 +42,7 @@ sudo apt-get dist-upgrade 1. Via Qubes VM Manager - ![Clone Debian Template](/attachment/wiki/Pentesting/Kali/clone-kali.png) + ![Clone Debian Template](/attachment/wiki/Kali/clone-kali.png) 2. Via command line @@ -116,7 +116,7 @@ Katoolin is a script (written in Python) which helps you to install Kali tools. kat > 1 ~~~ - ![Add Kali repositories and Update menu](/attachment/wiki/Pentesting/Kali/katoolin-add-update-repo-menu.png) + ![Add Kali repositories and Update menu](/attachment/wiki/Kali/katoolin-add-update-repo-menu.png) - select 'Add kali linux repositories' @@ -129,7 +129,7 @@ Katoolin is a script (written in Python) which helps you to install Kali tools. What do you want to do ?> 1 ~~~ - ![Add Kali repositories](/attachment/wiki/Pentesting/Kali/katoolin-add-repos-menu.png) + ![Add Kali repositories](/attachment/wiki/Kali/katoolin-add-repos-menu.png) - update Kali repositories diff --git a/managing-os/pentesting/ptf.md b/managing-os/pentesting/ptf.md index 43dd9643..96fd241f 100644 --- a/managing-os/pentesting/ptf.md +++ b/managing-os/pentesting/ptf.md @@ -67,7 +67,7 @@ PTF will put itself into `/usr/local/bin/ptf`. You can use `ptf` from now on. sudo ptf ~~~ - ![PTF start banner](/attachment/wiki/Pentesting/PTF/ptf-banner.png) + ![PTF start banner](/attachment/wiki/PTF/ptf-banner.png) 2. Show available modules (tools)