Repository files navigation

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 thePreferences 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 toStartup and Shutdown >Autostart, and selectAdd 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

1. git clone https://github.com/baduhai/Koi.git

2. cd Koi

3. mkdir build

4. cd build

5. cmake ../src/

6. sudo make

7. sudo make install

These instructions also apply to building the latest release version of Koi. Instead of cloning the repository, download and extract the latestSource 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-base
• plasma-desktop | kconfig | kcoreaddons | kwidgetsaddons

Download

Install it from theAUR. Packaged by AUR userdasbaumwolltier, 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 | fdupes
• patterns-kde-kde | patterns-kde-kde_plasma | desktop-file-utils

Download

Available fromOBS |REPO. Packaged byFabio Pesari-fpesari +Martin von Reichenberg, let them know if it's out of date, not me.

Dependencies

• cmake | desktop-file-utils

DownloadAvailable fromcopr. Packaged byh3o66, let them know if it's out of date, not me.

Download

Available from meNUR repo. Packaged by yours truly.
Install to your NIX profile withnix-env -iA koi -f https://github.com/baduhai/nur/tarball/master, to add to you nixos configuration, follow theInstructions on the NUR repo.

Dependencies

• g++ | qtbase5-dev | cmake | libkf5coreaddons-dev | libkf5widgetsaddons-dev | libkf5config-dev | libkf5package-dev | libkf5service-dev

DownloadNot yet available . . .

Install withNIX (SeeNixOS 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.