aerothemeplasma/DOCUMENTATION.md
2023-08-25 00:32:11 +02:00

9.4 KiB
Executable file

AEROTHEMEPLASMA DOCUMENTATION

TABLE OF CONTENTS

  1. Introduction
  2. List of components
  3. Components to be implemented

Introduction

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:

*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

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.

Plasmoids

Name Description System Finished Fork
DigitalClockLite Seven Displays a calendar, time, events and holidays. N Y Intika
SevenStart An application launcher made to look like Windows 7's Start menu. N N adhe,
oKcerG,
SnoutBug
SevenTasks Task manager made to look like Windows 7's taskbar buttons. N N KDE
Show Desktop (Aero) Textured button that shows the desktop when clicked. Supports peeking. N Y Zren
DefaultToolTip.qml QML component used for displaying tooltips. Reduced padding and size. Y Y KDE
Desktop icons Improved desktop shell that reduces padding between icons. Y Y KDE
Keyboard layout switcher Textured button for switching layouts, with reduced size and better alignment. Y Y KDE
System tray Redesigned with reorganized placement, floating panels, hoverable icons and reduced size and padding. Y Y KDE

Themes

Name Description Finished Fork
Aero cursors Cursor pack for KDE. Currently only has the small size (96 DPI). N Moony
SevenBlack Windows 7 theme for KDE Plasma. Contains non-standard theme elements. N Mirko Gennari,
DrGordBord,
bionegative
Sound collection Sounds taken from Windows 7 directly. Y Microsoft
VistaVG Wine theme Msstyle used for theming Wine applications. Y Vishal Gupta
Win2-7 Windows 7 theme for GTK2 applications. Adapted to work better with QGtkStyle. Y Juandejesuss
Windows 7 Kvantum Fixed certain padding and sizing issues, added more textures. Y DrGordBord
WindowsIcons Windows 8.1 icon pack adapted to fit KDE better while also changing certain icons to their Windows 7 counterparts. N B00merang team

KWin

Name Description Finished Fork
Aero Emerald Custom, non-standard Emerald theme made to work with Smaragd Seven. Y nicu96
Reflection Effect Effect that renders a glassy texture under windows. N KDE
Smaragd Seven KWin decoration theme which uses Emerald themes as a basis, with some Aero specific changes and bugfixes. Lacks HiDPI support. N KDE
Thumbnail Seven KWin task switcher that mostly replicates the look and behavior of Windows 7's task switcher N KDE

Applications

Name Description Finished Fork
AeroColorMixer Program designed for changing the accent color across the entire theme. (NOTE: This program is now deprecated and has been moved into the reflection effect.) Y N/A

Miscellaneous

Name Description Finished Fork
Aero Splash Screen Aero themed login splash screen. Y Matias Saibene

Components to be implemented

These components are listed from highest priority to lowest priority.

  • Qt visual style based on reading Msstyle themes (Like QWindowsVistaStyle)
  • Proper sound theme (upcoming in KDE Plasma 6)
  • SDDM Login theme and lock screen
  • Better folder thumbnailer plugin
  • Plymouth theme(?)