hello is a kwin window decoration, which aims to mimic macOS' appearance, but with power ups.
It also works great with the KWin effects.
Looks great with light and dark color schemes. Shown here with and
color schemes.
sudo add-apt-repository ppa:krisives/kde-hello
sudo apt install kde-hello
Made and maintained by krisives
yay -S hello-kde-git
Made and maintained by ToxicSalt
Before proceeding with the actual installation process, make sure you have the following dependencies installed:
- cmake
- g++ / clang
- extra-cmake-modules
- libkdecorations2-dev
- libkf5guiaddons-dev
- libkf5configwidgets-dev
- libkf5windowsystem-dev
- libkf5package-dev
- libqt5x11extras5-dev
- gettext
- pkg-config (optional)
Download the latest stable release or clone this repository for bleeding edge builds:
git clone https://github.com/n4n0GH/hello
It's recommended to clone the repository to where you can leave the built directory, just in case you want to uninstall hello. However, if you accidentally removed the directory, please check below for manually uninstallation instructions.
Change to window-decoration
directory and create a new directory called build
:
cd hello/window-decoration && mkdir build && cd build
To install, use cmake
, make
and make install
:
cmake -DCMAKE_INSTALL_PREFIX=/usr ..
make && sudo make install
It may be necessary to restart the KWin window manager after that, so either reboot your machine, or do it the cool way:
kwin_x11 --replace &
In the build directory, run:
sudo make uninstall
If you removed the installation directory, you'll have to delete the following files and folders:
/usr/lib64/cmake/hello/HelloConfig.cmake
/usr/lib64/cmake/hello/HelloConfigVersion.cmake
/usr/lib64/qt/plugins/org.kde.kdecoration2/hellodecoration.so
/usr/share/kservices5/hellodecorationconfig.desktop
/usr/lib64/libhellocommon5.so.5.16.5
/usr/lib64/libhellocommon5.so.5
If you have any questions regarding hello, you are welcome to open an issue.
Q: I can see this theme in the KDE store, but I can't install it through KDE's settings menu, what's up with that?
A: The KDE store is meant to provide easy access to Aurorae themes and KDE's settings menu is pretty good at downloading those themes and moving them around. BreezewayMod is written in C++ and not using the Aurorae engine. Sorry to say, but you're going to have to get your hands dirty in the terminal.
Q: Why is blur not enabled by default on this theme?
A: There's a massive ongoing issue with the KDecoration2 framework which will treat the titlebar - and windows in general - as if they had 90° corners, i.e. perfectly rectangular shapes. This leads to something I call "blur bleed", which enables you to see the blur effect being rendered underneath the window when your theme uses rounded corners. This affects regular Aurorae themes and QML themes alike. Read more about it on the KDE bugtracker: https://bugs.kde.org/show_bug.cgi?id=395725
Description | Showcase |
---|---|
This glitch in action. | ![]() |
BreezewayMod doesn't have that problem because it doesn't rely on blur features until KDecoration2 gets fixed. | ![]() |
Q: But I really don't care about the glitches, I just want blur! How can I do this?
A: Find the hello.json
file inside the kdecoration
directory. On line 12 you switch out "blur": false,
with "blur": true,
and then compile the theme according to the instructions.
Q: Does this work on Wayland?
A: Nyes. The theme will render with glitches and is not ready for Wayland yet. Maybe when Wayland works stable on my system I'll get around to fixing that.