Giter VIP home page Giter VIP logo

klassy's Introduction

Klassy

Table of Contents

Overview
Installation

Pre-built packages
Compile from source

System icon theme
Klassy Settings
Donations

 

Klassy (formerly ClassiK/ClassikStyles) is a highly customizable binary Window Decoration, Application Style and Global Theme plugin for recent versions of the KDE Plasma desktop. Initially taking inspiration from the iconography of KDE 1, the Klassy defaults are an attempt to create a usable and appealing look for the modern Plasma desktop. Install with the instructions below, and then make sure it is enabled in System Settings -> Appearance -> Window Decorations, in System Settings -> Appearance -> Application Style and in System Settings -> Appearance -> Icons.

Screenshot of Button icons menu

(Above Preset: Glassy Klassy, Colours: Klassy Dark)

  • Also provides Oxygen/Breeze and Redmond button icons.
  • Provides a Window Decoration, Application Style and Icons so that icons in dockable panels, MDI applications, context menus and GTK applications consistently match the main titlebar icons (make sure to enable all 3 in your Plasma Appearance settings!):

Watch the Klassy demo video

  • Configurable button size, shape, translucency, colours and outlining.

  • Default buttons (Klassy preset) are "Integrated Rounded Rectangles" with translucent outlined accent colours, with a large clickable area. These are designed to complement the "Blue Ocean" design refresh in Plasma 5.23, along with the Plasma 5.23 accent colour feature:

Default Integrated Rounded rectangle button style, dark

  • Alternative "Traffic lights" background colours:

Traffic lights button style, dark

  • Alternative "Full-height Rounded Rectangle" button shape (ClassiK v3 preset):

Rounded rectangle button style, darkRounded Rectangle button style, light Pink button style, darkPink button style, light Turquoise button style, darkTurquoise button style, light

  • Full-height Rectangular (ClassikStyles preset) or Circular (Classik-Aurorae preset) button highlights:

Full-height Rectangle button highlight style, inheriting system highlight coloursCircle button highlight style, inheriting system highlight colours

  • Ability to inherit system colour-scheme highlight colours for hover and focus, as well as titlebar colour. Auto-enhances contrast in cases where it is poor.

  • Option to have matching titlebar colour and border colour.

  • Configurable button spacing (left and right), titlebar margins (sides, top/bottom and option for different maximized), corner radius; all with scaling for HiDPI:

Screenshot of Alignment & Spacing tab

  • Transparency/opacity configurable for both active/inactive titlebars/headers; setting to make maximized windows opaque; blur is configurable:

  • Configurable thin window outline with optional accent colours:

Composite screenshot of thin window outlines with Contrast blended with accent colour (dark) Composite screenshot of thin window outlines with Contrast blended with accent colour (light)

  • Configurable scrollbars:

Default scrollbar animation

  • Configurable animations

  • Ability to load icons from the system icon theme. window-*-symbolic icons are recommended for this purpose. If the icons have been designed properly with SVG CSS properties then they will be colourized by default. You can also force the colourization of any symbolic icon by checking the Force-colourize icons window decoration setting.

 

Klassy version 5.1 requires at least Plasma 5.27, so please check you have this in kinfocenter before trying to install. You can either download the pre-built packages or compile from source.

Pre-built packages

Respositories are available from the Open Build Service for OpenSUSE, Debian/Ubuntu/KDE Neon, Fedora, Mageia and Arch/Manjaro to keep you on the latest version.

 

Raw .rpm, .deb etc. binary packages are also available from the Open Build Service link above if you choose "Grab binary packages directly".

   

Compile from source

Step 1: First, Install Dependencies

OpenSUSE Tumbleweed/Leap build dependencies

sudo zypper in git cmake extra-cmake-modules libQt5Core-devel libQt5Gui-devel libQt5DBus-devel libqt5-qtx11extras-devel libkdecoration2-devel kcoreaddons-devel kguiaddons-devel kconfigwidgets-devel kwindowsystem-devel ki18n-devel kiconthemes-devel kpackage-devel libQt5QuickControls2-devel frameworkintegration-devel kcmutils-devel kirigami2-devel libqt5-qtsvg-devel libQt5Xml-devel

Debian/Ubuntu/KDE Neon build dependencies

sudo apt install git build-essential libkf5config-dev libkdecorations2-dev libqt5x11extras5-dev qtdeclarative5-dev extra-cmake-modules libkf5guiaddons-dev libkf5configwidgets-dev libkf5windowsystem-dev libkf5coreaddons-dev gettext cmake libkf5iconthemes-dev libkf5package-dev libkf5style-dev libkf5kcmutils-dev kirigami2-dev libqt5svg5-dev

Arch/Manjaro build dependencies

sudo pacman -S git kdecoration qt5-declarative qt5-x11extras cmake make gcc extra-cmake-modules

Fedora build dependencies

sudo dnf install cmake extra-cmake-modules
sudo dnf install "cmake(Qt5Core)" "cmake(Qt5Gui)" "cmake(Qt5DBus)" "cmake(Qt5X11Extras)" "cmake(KF5GuiAddons)" "cmake(KF5WindowSystem)" "cmake(KF5I18n)" "cmake(KDecoration2)" "cmake(KF5CoreAddons)" "cmake(KF5ConfigWidgets)" "cmake(KF5IconThemes)" "cmake(KF5Package)" "cmake(Qt5Quick)" "cmake(KF5FrameworkIntegration)" "cmake(KF5KCMUtils)" "cmake(KF5Kirigami2)" "cmake(Qt5Svg)"

Step 2: Then download, build and install

Download, build and install from source script:

git clone https://github.com/paulmcauley/klassy
cd klassy
git checkout 5.1.breeze5.27.11
./install.sh

Uninstall build script:

./uninstall.sh

 

System icon theme

To make your Plasma Desktop fully consistent, Klassy auto-generates "Klassy" and "Klassy Dark" system icon themes whenever a window-decoration setting changes. These add consistent titlebar button icons to certain minor context menus in Plasma, and also add consistent GTK application titlebar icons (for Firefox to have consistent titlebar icons on Wayland, it is recommended to set the system GNOME/GTK Application style to Adwaita as Breeze is buggy).

Screenshot of Klassy with icon theme

These icons inherit the Breeze icon theme by default, only overriding the titlebar button icons. Another icon theme may be inherited by changing the setting in the Window Decoration settings under the System Icon Generation... button.

Klassy includes a settings application, klassy-settings. This shows Window Decoration and Application Style settings in one place.

klassy-settings also has command-line options to allow Preset file imports, load Presets and generate system icons. Run klassy-setttings --help for details.

Donate using Liberapay or Donate using Paypal

klassy's People

Contributors

paulmcauley avatar jriddell avatar andreas-kainz avatar notmart avatar pontaoski avatar noahadvs avatar mgraesslin avatar zzag avatar jamboarder avatar pointedstick avatar davidedmundson avatar kbroulik avatar nicolasfella avatar sodivad avatar ratijas avatar vogtinator avatar nowrep avatar montel avatar ken-vermette avatar aleixpol avatar bhush9 avatar hsitter avatar vkrause avatar alex1701c avatar easyteacher avatar gb2dev avatar heirecka avatar flying-sheep avatar lbeltrame avatar ingokloecker avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.