Coder Social home page Coder Social logo

neokamen / klassy Goto Github PK

View Code? Open in Web Editor NEW

This project forked from paulmcauley/klassy

0.0 0.0 0.0 822.85 MB

Klassy is a highly customizable binary Window Decoration and Application Style plugin for recent versions of the KDE Plasma desktop. It provides the Klassy, Kite, Oxygen/Breeze, and Redmond icon styles.

Shell 0.20% C++ 98.73% CMake 1.07%

klassy's Introduction

Klassy

Table of Contents

Overview
Installation

Pre-built packages
Compile from source

System icon theme
Donations

 

Klassy (formerly ClassiK/ClassikStyles) is a highly customizable binary Window Decoration and Application Style 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 enable in System Settings -> Appearance -> Window Decorations, and also in System Settings -> Appearance -> Application Style.

Screenshot of Button icons menu

  • Also provides Oxygen/Breeze and Redmond button icons
  • Provides both a Window Decoration and an Application Style so that icons in dockable panels and MDI applications consistently match the titlebar icons (make sure to enable both in your Plasma Appearance settings!):

Watch the demo video on enabling the Application Style

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

  • Default buttons 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:

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 or Circular button highlights:

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

(Above-left configuration: Background shape: Full-height Rectangle, Titlebar side margins: 0, Right-hand button spacing: 0, Button width margins Right-hand buttons: 10, Highlight using: Background

Above-right configuration: Background shape: Small Circle, Titlebar side margins: 3, Right-hand button spacing: 5, Highlight using: Background )

  • 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. For example, the following is with the quasi-Windows 11-style Cobalt icon theme: Screenshot of using system icon theme

 

Klassy from version 4.0 onwards requires at least Plasma 5.25, 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.

NB: for OpenSUSE Leap you will first need to install newer "Argon" KDE packages, otherwise you could corrupt your system!

 

Raw binary packages are also available from the Open Build Service link above if you choose "Grab binary packages directly" -- a .rpm or .deb file from one of the selected distributions should also work on other distributions.

   

Compile from source

Step 1: First, Install Dependencies

OpenSUSE Tumbleweed/Leap build dependencies

(Leap requires newer KDE packages from https://en.opensuse.org/SDB:KDE_repositories first):

sudo zypper in 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

Debian/Ubuntu/KDE Neon build dependencies

sudo apt install 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

Arch/Manjaro build dependencies

sudo pacman -S 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)"

Step 2: Then, build and install

Build and install from source script:

./install.sh

Uninstall build script:

./uninstall.sh

 

System icon theme

To make your Plasma Desktop fully consistent, there are also matching system icon themes. These add consistent titlebar button icons to certain minor context menus in Plasma, and also add consistent GTK application titlebars (for Firefox to have consistent titlebar icons, it is recommended to set the system GNOME/GTK Application style to Adwaita as Breeze is buggy). For example, Klassy-with-Square-highlight:

Screenshot of Klassy with Square highlight icon theme

To obtain these icon themes go to System Settings->Appearance->Icons->Get New Icons... and search for "klassy". Then download your theme of choice to match your Button icon style and Button highlight style:

Screenshot of downloading matching Klassy system icons

Alternatively, the icons can be downloaded from the icons source repository and installed via System Settings->Appearance->Icons->Install from file...

These icons inherit the Breeze icon theme, only overriding the titlebar button icons. To inherit a different icon theme, go to ~/.local/share/icons/ and edit the Inherits line in your index.theme file.

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.