aerothemeplasma/README.md

# AERO THEME FOR KDE PLASMA

# WARNING: THIS PROJECT IS NOT REGULARLY UPDATED
## This doesn't mean it's abandoned, however. This project is developed in my spare time and updated when I feel it is good enough to be updated. In other words, updates are done when they are done.

## Microsoft® Windows™ is a registered trademark of Microsoft® Corporation. This name is used for referential use only, and does not aim to usurp copyrights from Microsoft. Microsoft Ⓒ 2023 All rights reserved. All resources belong to Microsoft Corporation.


## Credits

*See [DOCUMENTATION.md](./DOCUMENTATION.md)*

Buy me a loaf of bread (Monero): 
`45WrFdAJvAaLTPA27xfqckPGiqphTBnbmELxdBrjpkpW7Bwuc9Rn2TT13QXm7eHZgVJKRPDBbJFLt4Crg9EXLxKp9E9AHJp`

<a href='https://ko-fi.com/M4M2NJ9PJ' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi2.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>

## TABLE OF CONTENTS
1. [Introduction](#introduction)  
2. [Screenshots](#screenshots)
3. [Installation](#installation)  
4. [Documentation](#documentation)
5. [FAQ](#questions)


## Introduction <a name="introduction"></a>

This is a project which aims to recreate the look and feel of Windows 7 as much as possible on KDE Plasma.
It is still in heavy development and testing. This project has been tested on:

 - Arch-based distributions (Arch, Artix, EndeavourOS, etc.), Debian-based distributions (Debian, Ubuntu, Mint, Kubuntu, etc.)
 - X11 
 - Latest stable KDE Plasma 5 release, latest KDE Frameworks version
 - Latest Qt 5 version
 - Intel integrated graphics, AMD dedicated graphics
 - 96 DPI scaling
  
Here's what's currently not supported but is planned (see FAQ):

 - Multi-distro support (While this could work on other distros, and has been confirmed to run well on Arch and Ubuntu, I cannot provide help if something goes wrong)
 - HiDPI scaling
 - Translations in multiple languages

The following has been deprecated: 

 - GTK2
 - QtCurve

The following will not be supported at all in the foreseeable future:

 - GTK3
 - GTK4
 - Wayland*

 *Based on user feedback, it seems that only the KWin effects provided in AeroThemePlasma don't work with Wayland. I have issues when running Wayland so I'm unable to debug this, but I'd be happy to accept a merge request that fixes this issue.

<h3>DISCLAIMER:</h3>

This project modifies a small number of KDE Plasma UI components which are not meant to be modified. Make sure to create backups before attempting to install this project. I am not responsible for broken KDE and/or Linux installs.

Because this project is under development and relies on upstream for a lot of things, many things are subject to change and will likely break as KDE Plasma gets updated over time. Keep an eye out on the issue tracker for further details when things inevitably happen to break. 

Lastly, feel free to fork this project and/or contribute to it in any way. Any and all effort is greatly appreciated.

## Screenshots <a name="screenshots"></a>

### Example Desktop
<img src="Screenshots/Desktop.png">

### Start Menu
<img src="Screenshots/Start_Menu.png">
<img src="Screenshots/Start_Menu_2.png">
<img src="Screenshots/Start_Menu_3.png">
<img src="Screenshots/Start_Menu_4.png">

![](Screenshots/starthover.webm)

### Dolphin
<img src="Screenshots/Kvantum/Dolphin.png">

<img src="Screenshots/Kvantum/Dolphin_2.png">

### Context Menu

<img src="Screenshots/Kvantum/Context_Menu.png">
<img src="Screenshots/Kvantum/Context_Menu_2.png">
<img src="Screenshots/Context_Menu_Taskbar.png">

### Taskbar

![](Screenshots/hovertask.webm)

<img src="Screenshots/Taskbar.png">
<img src="Screenshots/Taskbar_2.png">
<img src="Screenshots/Taskbar_3.png">

### Clock

<img src="Screenshots/Tooltips.png"> 
<img src="Screenshots/Calendar.png">

### System Tray

<img src="Screenshots/System_Tray.png">

### Icons

<img src="Screenshots/Icons.png">

### Lock Screen

<img src="Screenshots/Lock_Screen.png">

### Plasma Style

<img src="Screenshots/Notification.png">

<img src="Screenshots/Media_Controls.png">

<img src="Screenshots/Keyboard.png">

<img src="Screenshots/Shutdown.png">

<img src="Screenshots/Switcher.png">

### Reflections and accent colors

<img src="Screenshots/Kvantum/AeroColorMixer.png">

<img src="Screenshots/Reflections.png">

### Window Style

<img src="Screenshots/Window_Decorations.png">

### Firefox

<img src="Screenshots/Firefox.png">

## Installation <a name="installation"></a>

*See [INSTALL.md](./INSTALL.md)*

## Documentation <a name="documentation"></a>

*See [DOCUMENTATION.md](./DOCUMENTATION.md)* 

## FAQ <a name="questions"></a>

### What do you mean by support? Can I not use this if I have an unsupported setup?
    
You can still use this project, and it will most likely work, but any errors and bugs caused by the unsupported parts of your setup I most likely cannot debug or fix easily or in a reasonable amount of time, or at all. If it's a simple fix, I don't mind doing it, but anything more is likely out of my scope.

The main factor that decides whether something is supported or not is availability. I either don't have the hardware required to test things (I don't have a HiDPI monitor or a large variety of Nvidia GPUs, for example), or I simply don't and/or can't use certain software (Wayland).

### Is this project designed to help Windows users migrate to Linux?

In short: No.

Ultimately, this project doesn't change the fact that the underlying operating system is still Linux. The goal of this project isn't to act as a full Windows desktop replacement, or to provide any easy way for Windows users to migrate to Linux.

The main goal is to maintain the Aero visual style and keep it as authentic as possible while adapting it for Linux where it's necessary. This project is most likely not for people who want Aero but do not want to deal with Linux. There are many resources online that provide guides on how to bring back Aero into Windows 10 and 11, more or less, for those who aren't willing to migrate over to Linux, and that's totally fine.

### Will there be a Vista variant of this theme?

Yes, however do not expect it to happen anytime soon. Progress is slow, as the main focus is still on Windows 7.

### Why do certain details of this theme still look inaccurate and wrong?

A list of possible reasons:

- This is a work in progress, so I simply haven't come down to fixing it.
- The details can be fixed but it's incredibly time consuming and tedious to do so (for example, icons and the Qt widget style). Thus they're low priority on my end. These little wrong details burn my eyes too, don't worry. 
- I have no control over how certain parts of the desktop look like (for example, font rendering, KDE system plasmoids and shortcut/symlink icon placement, and other totally not overly specific things I tried to fix already)
- I simply didn't notice it, so thank you for pointing it out. :)