Home
Name Modified Size InfoDownloads / Week
kde-config.run 2026-07-16 51.4 MB
README.md 2026-07-16 3.6 kB
Totals: 2 Items   51.4 MB 0

πŸš€ KDE Environment Auto-Setup Script

A script that automates the personalization and visual configuration of the KDE Plasma desktop environment. It allows you to easily transfer themes, wallpapers, lock screens, and panel configurations between different user accounts or systems.

πŸš€ What does this script do?

1. System Configuration (Sudo)

  • Splash Screen: Replaces the default KDE Breeze splash screen with a custom one from the splash directory.
  • User avatar: Sets piwo.png as the user avatar in the system, Plasma environment, and SDDM display manager (AccountsService).
  • Login screen & wallpapers: Copies a dedicated login wallpaper (start.png) and the plasmalogin.conf configuration file.
  • Default system wallpapers: Overwrites the system wallpapers from the "Next" theme in 1080p, 2K, and 4K resolutions (light and dark variants).

2. User Configuration

  • Safe copying: Stops the plasmashell process to prevent the running desktop environment from overwriting files.
  • Config transfer: Copies the hidden directories .config, .local, and .icons to the home directory (~).
  • Dynamic path replacement: Automatically scans config files for the old username (bartek) and replaces it with your current system account name.
  • Cache cleanup & rebuild: Clears the icon/Plasma cache and forces a rebuild of the sycoca database.

πŸ“‚ Required Directory Structure

Before running the script, make sure the following image and configuration files are present in the same directory:

.
β”œβ”€β”€ install.sh             # This script
β”œβ”€β”€ piwo.png               # Your system avatar
β”œβ”€β”€ start.png              # Login screen wallpaper
β”œβ”€β”€ plasmalogin.conf       # Login screen configuration
β”œβ”€β”€ 1920x1080.png          # Full HD wallpaper
β”œβ”€β”€ 2560x1440.png          # 2K wallpaper
β”œβ”€β”€ 5120x2880.png          # 4K/5K wallpaper (light and dark)
β”œβ”€β”€ .config/               # Your KDE configuration files
β”œβ”€β”€ .local/                # Local app data and themes
└── .icons/                # Your icons and cursors

πŸ› οΈ How to Use

1. Clone the repository or download the files

git clone https://github.com/bartko4321/kde-config.git

2. Enter the downloaded folder

cd kde-config

3. Make the script executable

chmod +x install.sh

4. Run the script

⚠️ IMPORTANT: Run the script as a regular user (NOT as root/sudo). The script will ask for the administrator password at the start to configure temporary elevated privileges.

./install.sh

β˜• Support the Project

If you find this tool helpful and it saved you some time, consider buying me a coffee to support further development!

Buy Me A Coffee


Zrzut ekranu_20260716_191008

If you find this project useful, leave a star! ⭐

⚠️ Important Notes

  • Auto-Reboot: After all configurations complete successfully, the script will automatically restart the computer after 3 seconds so that all changes to the display manager and desktop environment are properly loaded. Save your work before running!
  • Temporary privileges: The script creates a /etc/sudoers.d/99-temp-installer file to avoid password prompts during execution. This file is completely removed just before the script finishes.
Source: README.md, updated 2026-07-16