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 Koi version: 0.2.2
Install it from the AUR. Packaged by AUR user dasbaumwolltier, bug them if it's out of date, not me.
Available from OBS. Packaged by VaiTon, bug them if it's out of date, not me.
Available from copr. Packaged by h3o66, bug them if it's out of date, not me.
Available from my NUR repo. Packaged by yours truly.
Install with nix. See NixOS above.
Dependencies
-
Qt
-
Plasma
-
KDE Frameworks
-
cmake [build dependency]
Koi targets the latest version of the above deps. Since I can't know the name of every dependency for every distro, these are the dependencies on ubuntu: g++ qtbase5-dev cmake libkf5coreaddons-dev libkf5widgetsaddons-dev libkf5config-dev libkf5package-dev libkf5service-dev
Build Instructions
-
git clone https://github.com/baduhai/Koi.git -
cd Koi -
mkdir build -
cd build -
cmake ../src/ -
make -
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 {}'
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.