Skip to content

AitorAstorga/garuda-linux-customisations

Repository files navigation

Contributors Forks Stargazers Issues MIT License LinkedIn


Logo

Garuda Linux Customisations

The purpose of this repo is to have a backup of all my customisations in Garuda Linux.
Supports modern KDE Plasma 6 features and follows XDG Base Directory specification.
Report Bug · Request Feature

Table of Contents
  1. Getting Started
  2. Manual Customisations
  3. License
  4. Contact

Getting Started

This project comes with two bash scripts backup_customisations.sh and apply_customisations.sh.

Prerequisites

  • Garuda Linux (or any Linux distribution with the listed KDE Plasma paths): Arch Linux, Kubuntu, openSUSE, Manjaro, Fedora, Neon, Debian...
  • KDE Plasma 6.0 or higher (for full compatibility with new features)
  • Root permissions to execute the scripts

Setup

  1. Clone the repository:
    git clone https://github.com/AitorAstorga/garuda-linux-customisations.git
    
  2. Navigate to the directory:
    cd garuda-linux-customisations
    
  3. Make the scripts executable:
    chmod +x backup_customisations.sh apply_customisations.sh
    

Using the Scripts

  1. Backup Current Customisations:

    To extract the current customisations from the system and place them into the "Garuda Linux Customisations" folder, run:

    sudo ./backup_customisations.sh

    The script will create or use an existing Garuda Linux Customisations directory and place the backup inside.

  2. Apply Customisations:

    To apply the customisations from the "Garuda Linux Customisations" folder to the system, run:

    sudo ./apply_customisations.sh

    The script will copy each customisation from the folder to its respective path on the system.

(back to top)

Manual Customisations

This section is intended for those configurations that I want to change sometimes, but I never find :)

Installation paths

This is the list of paths for each component in KDE Plasma 6:

System-wide Installation Paths

Customisation Path
GRUB Themes /usr/share/grub/themes/
SDDM Themes /usr/share/sddm/themes/
SDDM Configuration /etc/sddm.conf
SDDM User Config /var/lib/sddm/.config/
Plasma Look & Feel Themes /usr/share/plasma/look-and-feel/
Plasma Desktop Themes /usr/share/plasma/desktoptheme/
Plasma Color Schemes /usr/share/color-schemes/
KWin Window Decorations /usr/share/kwin/decorations/
Plasma Layout Templates /usr/share/plasma/layout-templates/
Icon Themes /usr/share/icons/
Konsole Themes /usr/share/konsole/
Cursor Themes /usr/share/icons/
Wallpapers /usr/share/wallpapers/
Aurorae Window Decorations /usr/share/aurorae/themes/
Plasmoid Widgets /usr/share/plasma/plasmoids/
Kvantum Themes /usr/share/Kvantum/
Plasma Welcome Pages /usr/share/plasma/plasma-welcome/extra-pages/
Session Files (X11) /usr/share/xsessions/
Session Files (Wayland) /usr/share/wayland-sessions/
User Avatars /var/lib/AccountsService/icons/

User-specific Installation Paths (KDE Plasma 6+)

Customisation Path
Application Configuration ~/.config/
Global Shortcuts ~/.config/kglobalshortcutsrc
User Plasma Themes ~/.local/share/plasma/
User Color Schemes ~/.local/share/color-schemes/
User Aurorae Themes ~/.local/share/aurorae/
User Konsole Themes ~/.local/share/konsole/
User Icon Themes ~/.local/share/icons/
User Wallpapers ~/.local/share/wallpapers/

Notes:

  • Icons and cursors share the same path in both system and user directories
  • User-specific paths take precedence over system-wide paths
  • KDE Plasma 6 follows XDG Base Directory specification more strictly

Application Menu

Enable the application menu in the top bar of windows (options such as Files, Edit, View...):

  1. Disable the application menu daemon and stop it if it is running:

    imagen

  2. Remove the application menu from the title bar:

    imagen

Mozilla Firefox Window Decorations

To merge the title bar with the Mozilla Firefox tabs do the following:

  1. Right click on the toolbar > Customise toolbar:

    imagen

  2. Then, in the bottom left corner disable Title bar:

    imagen

KDE Plasma 6 Specific Features

SDDM Settings Synchronization

Apply your current Plasma settings to SDDM (login screen):

  1. Open System Settings > ... > Login Screen (SDDM)
  2. Click "Apply Plasma Settings..." (hamburguer menu) to sync your theme, colors, and scaling

Welcome Center Customization

Custom welcome pages can be added to /usr/share/plasma/plasma-welcome/extra-pages/

(back to top)

License

Distributed under the GNU General Public License v3.0. See LICENSE for more information.

(back to top)

Contact

Aitor Astorga Saez de Vicuña - a.astorga.sdv@gmail.com

Project Link: https://github.com/AitorAstorga/garuda-linux-customisations

(back to top)

About

Personal guide for customisation in Garuda Linux

Resources

License

Stars

Watchers

Forks