Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/paulmcauley/klassy/llms.txt

Use this file to discover all available pages before exploring further.

​
Installation

Klassy requires Plasma 6.3 or later. Please check your Plasma version in KInfoCenter before attempting installation.
Installing Klassy on Plasma versions older than 6.3 is not supported and may cause issues.
You have two main options for installation:
  1. Pre-built packages - Recommended for most users
  2. Compile from source - For advanced users or latest development features

​
Pre-built Packages

Pre-built packages are available from the Open Build Service for multiple distributions.

​
Supported Distributions

  • OpenSUSE
  • Debian/Ubuntu
  • Fedora
  • Mageia
  • Arch/Manjaro

​
Installation via Repository

Using repositories keeps you on the latest version automatically through your system updates.
1

Visit the Open Build Service

Navigate to the Klassy package page on OBS
2

Select your distribution

Choose your Linux distribution from the list and follow the distribution-specific instructions to add the repository.
3

Install the package

Use your distribution’s package manager to install Klassy after adding the repository.

​
Direct Binary Downloads

If you prefer not to add a repository, raw binary packages (.rpm, .deb, etc.) are also available:
  1. Visit the Open Build Service page
  2. Select “Grab binary packages directly”
  3. Download the appropriate package for your distribution
  4. Install using your package manager

​
Compile from Source

Compiling from source gives you access to the latest features and allows for customization.

​
Step 1: Install Dependencies

First, install the required build tools and development libraries for your distribution. 
# Install basic build tools
sudo zypper in git cmake kf6-extra-cmake-modules gettext

# Install KDE/Qt development libraries
sudo zypper in "cmake(KF5Config)" "cmake(KF5CoreAddons)" "cmake(KF5FrameworkIntegration)" \
  "cmake(KF5GuiAddons)" "cmake(KF5Kirigami2)" "cmake(KF5WindowSystem)" "cmake(KF5I18n)" \
  "cmake(KF5KCMUtils)" "cmake(Qt5DBus)" "cmake(Qt5Quick)" "cmake(Qt5Widgets)" \
  "cmake(Qt5X11Extras)" "cmake(KDecoration3)" "cmake(KF6ColorScheme)" "cmake(KF6Config)" \
  "cmake(KF6CoreAddons)" "cmake(KF6FrameworkIntegration)" "cmake(KF6GuiAddons)" \
  "cmake(KF6I18n)" "cmake(KF6KCMUtils)" "cmake(KF6KirigamiPlatform)" "cmake(KF6WindowSystem)" \
  "cmake(Qt6Core)" "cmake(Qt6DBus)" "cmake(Qt6Quick)" "cmake(Qt6Svg)" "cmake(Qt6Widgets)" \
  "cmake(Qt6Xml)"

​
Step 2: Download, Build, and Install

1

Clone the repository

git clone https://github.com/paulmcauley/klassy
2

Navigate to the directory

cd klassy
3

Checkout the Plasma 6.3 branch

git checkout plasma6.3
4

Run the installation script

./install.sh
The script will:
  • Uninstall any previous version if found
  • Create a clean build directory
  • Run CMake with optimized settings
  • Compile using all available CPU cores
  • Install the theme system-wide
The install.sh script uses the following CMake configuration:
cmake -DCMAKE_INSTALL_PREFIX=/usr \
      -DCMAKE_BUILD_TYPE=Release \
      -DBUILD_TESTING=OFF \
      -DKDE_INSTALL_USE_QT_SYS_PATHS=ON ..

​
Uninstalling

To uninstall Klassy compiled from source: 
cd klassy
./uninstall.sh

​
Gentoo Linux

Klassy is available in the guru repository.
1

Install eselect repository

sudo emerge -av app-eselect/eselect-repository
2

Enable the guru repository

sudo eselect repository enable guru
3

Sync repositories

sudo emaint sync -r guru
4

Add package keywords

echo "gui-apps/klassy ~amd64" | sudo tee /etc/portage/package.accept_keywords/klassy
5

Install Klassy

sudo emerge -av gui-apps/klassy

​
Next Steps

After installation, proceed to the Quick Start guide to enable and configure the Kite theme.

Build docs developers (and LLMs) love

Get started for freeTalk to us