| Name | Modified | Size | Downloads / 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
splashdirectory. - User avatar: Sets
piwo.pngas the user avatar in the system, Plasma environment, and SDDM display manager (AccountsService). - Login screen & wallpapers: Copies a dedicated login wallpaper (
start.png) and theplasmalogin.confconfiguration 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
plasmashellprocess to prevent the running desktop environment from overwriting files. - Config transfer: Copies the hidden directories
.config,.local, and.iconsto 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
sycocadatabase.
π 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!
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-installerfile to avoid password prompts during execution. This file is completely removed just before the script finishes.
