| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| fedora-config-kde.run | < 13 hours ago | 233.5 MB | |
| README.md | 2026-07-16 | 6.3 kB | |
| Totals: 2 Items | 233.5 MB | 3 |
๐ Fedora + KDE Plasma โ Comprehensive Post-Install Script
A powerful, fully automated configuration script dedicated to Fedora with the KDE Plasma desktop environment. It automates system optimization, graphics driver configuration, essential software installation, and full visual personalization (dot-files, icons, wallpapers).
โจ Main Features
๐ ๏ธ 1. Optimization & System
- DNF5 Tuning: Dramatically speeds up package downloads by configuring
max_parallel_downloads=10,retries=10,fastestmirror, and increased timeout limits. - Lock Management: Intelligently waits for RPM database locks to be released and forcefully clears blocking processes (e.g. Discover, PackageKit, DNF).
- System Cleanup: Automatically removes unnecessary software (including Konqueror, KMail, Akonadi, Nano, Plasma Vault) and optimizes log size (
journalctl --vacuum-time=2d). - Fast Boot: Sets GRUB timeout to 0 seconds and automatically regenerates the configuration.
๐ฆ 2. Repositories & Software
- Extra Repositories: Automatic setup of RPM Fusion (Free/Non-free), repositories for Google Chrome, Brave Browser, and COPR (faugus-launcher).
- Rich Toolset: Installs developer tools (
@development-tools), decompressors (7zip, unrar), multimedia players and editors (GIMP, Kdenlive, Audacity, Mixxx), as well as Discord, Telegram, and qBittorrent. - Virtualization: Full KVM/QEMU environment setup (
virt-manager,libvirtd) with automatic Firewalld zone configuration.
๐ฎ 3. GPU Detection & 32-bit Architecture
The script automatically analyzes hardware via lspci and installs dedicated 32-bit libraries (essential for Steam/Wine/Proton) and configures kernel modules via Dracut:
- ๐ข NVIDIA: Forces driver loading in Dracut + 32-bit CUDA and X11 libraries.
- ๐ด AMD/Radeon: Optimized for
amdgpu+ 32-bit Mesa and Vulkan drivers. - ๐ต Intel: Configures the
i915kernel module + 32-bit Mesa drivers.
๐ 4. Modern Terminal (ZSH)
- Automatically changes the default user shell from Bash to Zsh.
- Installs and silently deploys the Oh My Zsh framework.
- Configures and clones the ultra-fast, readable Powerlevel10k theme.
- Adds automatic system stats and logo display on every terminal launch via Fastfetch.
๐จ 5. Desktop Environment & User Paths
- Safely installs configuration files (
.config,.local,.icons) into a dormant Plasma session (prevents the system from overwriting changes). - Dynamically replaces old user paths (placeholder
bartek) with the currently logged-in profile name in text files, JSON, INI, and CONF configurations. - Replaces the default Breeze splash screen with a custom one.
- Automatically deploys system wallpapers in Full HD, 2K, and 5K resolutions including dark variants.
- Sets a personalized user avatar from the
piwo.pngfile. - Configures Cloudflare fast DNS servers (
1.1.1.1) for the active network connection.
๐ Required Repository Structure
For the install.sh script to work correctly and find all required dependencies, maintain the following file structure in your project folder before pushing to GitHub:
โโโ install.sh # Main configuration script
โโโ piwo.png # System user avatar (KDE / AccountsService)
โโโ 1920x1080.png # System wallpaper (Full HD)
โโโ 2560x1440.png # System wallpaper (2K)
โโโ 5120x2880.png # System wallpaper (5K / 4K)
โโโ .update.sh # Optional update script copied to the home directory ~
โโโ .config/ # Your configuration files (shortcuts, panel settings, widgets)
โโโ .local/ # Local app data and user configurations
โโโ .icons/ # Custom system icon packs or cursors
โโโ bleachbit/ # Pre-configured BleachBit system cleanup settings
๐ How to Run
1. Clone your repository
git clone https://github.com/bartko4321/fedora-config-kde.git
2. Enter the downloaded folder
cd fedora-config-kde
3. Make the script executable
chmod +x install.sh
4. Run the script as a regular user
โ ๏ธ IMPORTANT: Do NOT run the script directly with
sudo ./install.shor from the root account. The script is smart โ it will elevate privileges viasudoonly when needed, and this ensures it correctly reads the paths to your home directory/home/.
./install.sh
Once all operations are complete and temporary privileges are cleaned up, the system will display a success message and automatically restart after 3 seconds to properly initialize kernel modules and load the new environment.
โ Support the Project
If you find this tool helpful and it saved you some time, consider buying me a coffee to support further development!
โ ๏ธ Security & Best Practices
- Data privacy (
.config/.local): Before packing and pushing your configuration folders to a public GitHub repository, carefully check that they don't contain sensitive files (e.g. Discord tokens, browser sessions, API keys, SSH configs, or saved passwords). If you want to exclude something, create a.gitignorefile. - Fresh installation: This script is optimized to run on a fresh Fedora KDE Spin installation. Running it on a system you've been using for months will overwrite your current configuration files in
/home/.
If you find this project useful, leave a star! โญ
Built for maximum automation and convenience when working with Fedora. ๐งโ๏ธ
