Koi is a program designed to provide the KDE Plasma Desktop functionality to automatically switch between light and dark themes. Koi is under active development, and while it is stable enough to use daily, expect bugs. Koi is designed to be used with Plasma, and while some features may function under different desktop environments, they are unlikely to work and untested.
Disclaimer: Koi was written as a project to practice Qt by a novice programmer, expect code to be written sloppily.
- Toggle between light and dark presets based on time.
- Change Plasma style.
- Change Qt colour scheme.
- Change Icon theme.
- Change GTK theme.
- Change wallpaper.
- Hide application to system tray.
Koi is designed to be very simple to use. When you first open Koi, settings for the light and dark presets will be empty, all you need to do is select which themes you'd like for Koi to manage and select your desired themes by clicking the Preferences button.
If you would like that Koi switch between your light and dark settings automatically, you can select this option in the main page of the program, and choose between following a user set schedule, or at sunrise and sunset (planned feature). To switch between light and dark manually right click the tray icon and select the desired preset, or do so from Koi's main window.
In order to have Koi start at login, you can do so with the Plasma System Settings. Simply navigate to Startup and Shutdown > Autostart, and select Add Program.... If you are to do this, I recommend that you also check the option to start Koi hidden, so not to be annoyed by Koi popping up every time you start your system.
Lastest version: 0.2.3
GENERIC Dependencies
-
Qt [Development files]
-
KDE Plasma Desktop Environment
-
KDE Frameworks [Development files]
-
cmake [Build dependencies]
Build Instructions
-
git clone https://github.com/baduhai/Koi.git -
cd Koi -
mkdir build -
cd build -
cmake ../src/ -
sudo make -
sudo make install
These instructions also apply to building the latest release version of Koi. Instead of cloning the repository, download and extract the latest Source Code archive, from then follow step 2 and beyond.
Building with NIX
nix-build -E 'with import <nixpkgs> {}; pkgs.libsForQt5.callPackage ./dev.nix {}'
Dependencies
qt5-baseplasma-desktop | kconfig | kcoreaddons | kwidgetsaddons
Download
Install it from the AUR. Packaged by AUR user dasbaumwolltier, let them know if it's out of date, not me.
Dependencies
cmake | cmake-full | extra-cmake-modules | patterns-kde-devel_kde_frameworks | patterns-kde-devel_qt5 | fdupespatterns-kde-kde | patterns-kde-kde_plasma | desktop-file-utils
Download
Available from OBS | REPO. Packaged by Fabio Pesari-fpesari + Martin von Reichenberg, let them know if it's out of date, not me.
Dependencies
cmake | desktop-file-utils
Download Available from copr. Packaged by h3o66, let them know if it's out of date, not me.
Download
Available from me NUR repo. Packaged by yours truly.
Install to your NIX profile with nix-env -iA koi -f https://github.com/baduhai/nur/tarball/master, to add to you nixos configuration, follow the Instructions on the NUR repo.
Dependencies
g++ | qtbase5-dev | cmake | libkf5coreaddons-dev | libkf5widgetsaddons-dev | libkf5config-dev | libkf5package-dev | libkf5service-dev
Download Not yet available . . .
Install with NIX (See NixOS above) or grab the AppImage of the latest release.
Koi targets the latest version of the above deps. Since I can't know the name of every dependency for every distribution . . .
The following is a list of resources that I used as reference and inspiration for writing Koi.
- Yin-Yang - For UI layout and features inspiration.
- system-tray-icon-qt - For teaching me how to implement a system tray icon with Qt.
- plasma-theme-switcher - For teaching me how to set current Qt colour scheme.
- ksetwallpaper - For teaching me how to set the wallpaper on Plasma.
- This blog post from Zren - For teaching me how to set the icon theme.