aerothemeplasma/INSTALL.md

Installation

TABLE OF CONTENTS

1. Prerequisites
2. Plasma components
3. KWin components
4. Miscellaneous components
5. Configuring AeroThemePlasma

Prerequisites

NOTE: Dependencies for other disros besides Arch Linux have been provided by contributors and aren't updated frequently, which may result in incorrect or missing dependencies.

Arch Linux

Required packages:

pacman -S cmake extra-cmake-modules ninja qt6-virtualkeyboard qt6-multimedia qt6-5compat plasma-wayland-protocols plasma5support kvantum base-devel

KSysGuard has been officially deprecated by KDE, however an unofficial port exists for Qt6, which can be installed using the AUR package on Arch-based distros.

Fedora KDE

Required Packages:

dnf install plasma-workspace-devel kvantum qt6-qtmultimedia-devel qt6-qt5compat-devel libplasma-devel qt6-qtbase-devel qt6-qtwayland-devel plasma-activities-devel kf6-kpackage-devel kf6-kglobalaccel-devel qt6-qtsvg-devel wayland-devel plasma-wayland-protocols kf6-ksvg-devel kf6-kcrash-devel kf6-kguiaddons-devel kf6-kcmutils-devel kf6-kio-devel kdecoration-devel kf6-ki18n-devel kf6-knotifications-devel kf6-kirigami-devel kf6-kiconthemes-devel cmake gmp-ecm-devel kf5-plasma-devel libepoxy-devel kwin-devel kf6-karchive kf6-karchive-devel plasma-wayland-protocols-devel qt6-qtbase-private-devel qt6-qtbase-devel kf6-knewstuff-devel kf6-knotifyconfig-devel kf6-attica-devel kf6-krunner-devel kf6-kdbusaddons-devel kf6-sonnet-devel plasma5support-devel plasma-activities-stats-devel polkit-qt6-1-devel

Compiling

To build the components that need to be compiled (KWin effects, Decoration theme, etc.), run compile.sh:

$ chmod +x compile.sh && ./compile.sh

or

$ sh compile.sh

Plasma components

This section relates to the directories found in the plasma folder.

Install scripts

1. Run the following scripts:

$ chmod +x install_plasmoids.sh && ./install_plasmoids.sh
$ chmod +x install_plasma_components.sh && ./install_plasma_components.sh # Requires authorization for SMOD resources and SDDM themes

Manual

1. Move the smod folder to ~/.local/share, or /usr/share/ for a system-wide installation. This will install the resources required by many other components in this project.

2. Move the folders desktoptheme, look-and-feel, plasmoids, layout-templates, shells into ~/.local/share/plasma. If the folder doesn't exist, create it. These folders contain the following:

   • Plasma Style
   • Global Theme (more accurately, just the lock screen)
   • Plasmoids
   • Plasma shell
   • Preset panel layout that can be applied from Edit mode

3. Move sddm-theme-mod to /usr/share/sddm/themes. Optionally, to enable the Vista start screen, set enableStartup=true in theme.conf.user

4. Import and apply the color scheme through System Settings.

KWin components

Install scripts

1. Run the following script:

$ chmod +x install_kwin_components.sh && ./install_kwin_components.sh

Manual

This section relates to the directories found in the kwin folder.

1. Move effects, tabbox, outline, scripts to ~/.local/share/kwin.
2. In System Settings, apply the following settings:

• In Window Behavior -> Titlebar Actions:
  • Mouse wheel: Do nothing
• In Window Behavior -> Task Switcher:
  • Main: Thumbnail Seven, Include "Show Desktop" entry
  • Alternative: Flip Switch, Forward shortcut: Meta+Tab
• In Window Behavior -> KWin Scripts:
  • Enable Minimize All, SMOD Peek
• In Window Behavior -> Desktop Effects, enable the following:
  • Aero Glass Blur
  • Aero Glide
  • Desaturate Unresponsive Applications
  • Fading Popups
  • Login
  • SMOD Glow
  • SMOD Snap
  • Squash
  • SMOD Peek
  • Dim Screen for Administrator Mode
  • Animations for SevenTasks Thumbnails
• In Window Behavior -> Desktop Effects, disable the following:
  • Background Contrast
  • Blur
  • Maximize
  • Sliding Popups
  • Dialog Parent
  • Dim Inactive
  • Logout

Miscellaneous components

Install scripts

1. Run the following script:

$ chmod +x install_misc_components.sh && ./install_misc_components.sh

This section relates to the directories found in the misc folder.

1. Move the Kvantum folder (the one inside the kvantum folder) to ~/.config, then in Kvantum Manager select the theme.
2. Unpack the sound archive and move the folders to ~/.local/share/sounds, then select the sound theme in System Settings.
3. Unpack the icon archive and move the folder to ~/.local/share/icons, then select the icon theme in System Settings.
4. Unpack the cursor archive and move the folder to /usr/share/icons, then follow this guide to install the cursor theme.
5. Move the files located in mimetype into ~/.local/share/mime/packages and then run update-mime-database ~/.local/share/mime to fix DLLs and EXE files sharing the same icons.
6. Segoe UI, Segoe UI Bold, Segoe UI Semibold and Segoe UI Italic are required for this theme and they should be installed as system-wide fonts.

If SDDM fails to pick up on the cursor theme, go to System Settings -> Startup and Shutdown -> Login Screen (SDDM), and click on Apply Plasma Settings to enforce your current cursor theme, and other relevant settings. Do this after installing everything else. If even that fails, change the default cursor theme in /usr/share/icons/default/index.theme to say aero-drop.

Plymouth theme

Optionally, install PlymouthVista which supports Windows 7 boot animations, and features a more detailed setup guide.

Polkit User Account Control modification

WARNING:

Installing random modifications to programs that deal with privilege escalation (giving sudo or root access to users) from unknown or untrustworthy sources is reckless and a giant security risk. Even though this modification to KDE's polkit authentication UI is purely cosmetic (and even hotfixes a longstanding issue), it's generally not recommended to modify sensitive applications such as this. If you don't know what you're doing, or do not trust the modified source code, do not install this particular component of AeroThemePlasma.

1. Navigate to the uac-polkitagent folder, and run install.sh (or install_ninja.sh if you have Ninja installed):

$ chmod +x install.sh && ./install.sh

2. To remove the minimize and maximize buttons from the window, run add_rule.sh which will generate the appropriate KWin rule:

$ chmod +x add_rule.sh && ./add_rule.sh

Configuring AeroThemePlasma

1. Apply the Global Theme after installing everything. Make sure to restart KDE Plasma and KWin as well, by restarting your session.

2. On a fresh KDE install, remove the default panel and add the "AeroThemePlasma Taskbar" panel using Edit mode. You can also manually configure the panel for a finer setup.

3. Right click on the desktop and open "Desktop and Wallpaper", and select "Desktop (Win7)" under Layout, and apply the changes.

4. Disable the following entries in the system tray settings:

   • Power and Battery
   • Networks
   • Keyboard Layout
   • Audio Volume

   And enable the following entries:

   • Battery
   • Network Management
   • Sound Mixer

5. When updating KDE Plasma, usually through a full system upgrade, recompiling KWin effects and the DefaultToolTip component is necessary.

6. In System Settings -> Colors & Themes -> Colors, set "Accent color from color scheme"

7. In System Settings -> Session -> Desktop Session, uncheck the "Ask for confirmation" option.

8. In System Settings -> Keyboard -> Shortcuts, under KWin, disable the "Peek at Desktop" shortcut, and remap the "MinimizeAll" to Meta+D

9. In System Settings -> Colors & Themes -> Cursors -> Configure Launch Feedback, set Cursor feedback to "None"

10. In System Settings -> Fonts, configure the fonts as shown here:

The following steps are optional:

10. To enable full font hinting just for Segoe UI, move the fontconfig folder to ~/.config. This will enable full font hinting for Segoe UI while keeping slight font hinting for other fonts. Additionally, append QML_DISABLE_DISTANCEFIELD=1 into /etc/environment in order for this to be properly applied. While full font hinting makes the font rendering look sharper and somewhat closer to Windows 7's ClearType, on Linux this option causes noticeably faulty kerning. This has been a prominent issue for several years now and while the situation has improved from being unreadable to just being ugly, a complete solution for this doesn't seem to be coming anytime soon.
11. For Wine users it's recommended to install the VistaVG Ultimate msstyles theme.
12. To install custom branding at the Info Center, move kcm-about-distrorc from the branding folder to ~/.config/kdedefaults/, then edit the file's LogoPath entry to point to the absolute path of kcminfo.png.
13. Add the following to ~/.bashrc to get bash to look more like the command prompt on Windows:

PS1='C:${PWD//\//\\\\}> '

echo -e "Microsoft Windows [Version 6.1.7600]\nCopyright (c) 2009 Microsoft Corporation.  All rights reserved.\n"

14. In the terminal emulator of your choice (e.g Konsole), set the font to TerminalVector, size 9pt. Disable smooth font rendering and bold text, reduce the line spacing and margins to 0px, set the cursor shape to underline, and enable cursor blinking.