The purpose of this documentation is to provide a detailed explanation of elements that contribute to the look, feel and functionality of this project.
Since this project features a large variety of components, ranging from simple themes to
entire applications, documentation will be organized into multiple categories based on the
language the component is written in (plasmoids, applications) or the standard that defines it (themes). Components will categorized in the following way:
To keep the documentation condensed and to prevent redundancy, components that don't require documentation or are out of scope for this project (as in, documentation exists elsewhere) will not be documented here:
- Date and time (io.gitgud.wackyideas.digitalclocklite)
- Show desktop (Aero) (io.gitgud.wackyideas.win7showdesktop)
*While Kvantum won't be discussed here, one important detail worth mentioning is that Kvantum does not respect KDE's color schemes for the most part and that this sometimes leads to unexpected visual results. Still, it's recommended to apply a KDE color scheme alongside Kvantum for maximum compatibility.
In the future, some components might receive their dedicated documentation, in case it's required.
## List of components <a name="list-of-components"></a>
This is a list of components that are included in this project, as well as their completion status. Note that finished components are still subject to bugs, general enhancements and maintenance, but they are "more or less" feature complete. The forked column links to the original projects and their authors. Please consider taking a look at their work, because without them, this project would not be possible.
|DigitalClockLite Seven |Displays a calendar, time, events and holidays. |N |Y |[Intika](https://www.kde-look.org/p/1225135/)|
|SevenStart |An application launcher made to look like Windows 7's Start menu. |N |N |[adhe](https://store.kde.org/p/1386465/),<br>[oKcerG](https://github.com/oKcerG/QuickBehaviors),<br>[SnoutBug](https://store.kde.org/p/1720532)|
|SevenTasks |Task manager made to look like Windows 7's taskbar buttons. |N |N |[KDE](https://invent.kde.org/plasma/plasma-desktop/-/tree/master/applets/taskmanager)|
|Show Desktop (Aero) |Textured button that shows the desktop when clicked. Supports peeking. |N |Y |[Zren](https://www.kde-look.org/p/1100895/)|
|DefaultToolTip.qml |QML component used for displaying tooltips. Reduced padding and size. |Y |Y |[KDE](https://api.kde.org/frameworks/plasma-framework/html/DefaultToolTip_8qml_source.html)|
|Desktop icons |Improved desktop shell that reduces padding between icons. |Y |Y |[KDE](https://invent.kde.org/plasma/plasma-desktop)|
|Keyboard layout switcher|Textured button for switching layouts, with reduced size and better alignment. |Y|Y|[KDE](https://invent.kde.org/plasma/plasma-desktop)|
|System tray|Redesigned with reorganized placement, floating panels, hoverable icons and reduced size and padding.|Y|Y|[KDE](https://invent.kde.org/plasma/plasma-workspace/-/tree/master/applets/systemtray)|
|Sound collection |Sounds taken from Windows 7 directly. |Y |Microsoft|
|VistaVG Wine theme|Msstyle used for theming Wine applications. |Y |[Vishal Gupta](https://www.deviantart.com/vishal-gupta/art/VistaVG-Ultimate-57715902)|
|Win2-7 |Windows 7 theme for GTK2 applications. Adapted to work better with QGtkStyle. |Y |[Juandejesuss](https://www.gnome-look.org/p/1012465)|
|Windows 7 Kvantum |Fixed certain padding and sizing issues, added more textures. |Y |[DrGordBord](https://store.kde.org/p/1679903)|
|WindowsIcons |Windows 8.1 icon pack adapted to fit KDE better while also changing certain icons to their Windows 7 counterparts.|N |[B00merang team](https://b00merang.weebly.com/icon-themes.html)|
|Reflection Effect|KWin Effect that renders a glassy texture under windows. |N |[KDE](https://invent.kde.org/plasma/kwin/-/tree/master/src/plugins/blur)|
|Firefox Blur Region Fix|KWin Effect that fixes Firefox's transparency and allows it to have proper blur and reflections. |N |N/A|
|SMOD |KWin decoration theme based on Breeze, has support for removing inner window borders to mimic Windows 7's extended borders feature.|N |[Souris-2d07](https://gitgud.io/souris)|
|Thumbnail Seven |KWin task switcher that mostly replicates the look and behavior of Windows 7's task switcher|N|[KDE](https://invent.kde.org/plasma/kwin/-/tree/master/src/tabbox/switchers/thumbnail_grid)|
|Smaragd Seven |KWin decoration theme which uses Emerald themes as a basis, with some Aero specific changes and bugfixes. Lacks HiDPI support.|N |[KDE](https://invent.kde.org/plasma/smaragd)|
|Aero Emerald |Custom, non-standard Emerald theme made to work with Smaragd Seven. Features caption buttons that match the default sizes for both 7 and Vista. |Y |[nicu96](https://store.kde.org/p/1003826/), [Souris-2d07](https://gitgud.io/souris)|
