KDE Theme Installer — install a theme and all its companions with one URL

If you’ve ever tried installing a KDE theme from the store, you know the drill: download the global theme, then scroll through the description hunting for links to the matching icon pack, color scheme, Aurorae window decoration, Konsole color scheme, Kvantum theme, cursors… each one a separate download, each one with its own archive to extract and drop in the right folder.

I got tired of it, so I built a tool to do it automatically.

KDE Theme Installer takes a KDE Store / Pling / opendesktop.org URL, discovers every companion piece referenced in the theme’s description, and installs everything to the correct location — no manual archive extraction, no hunting for the right ~/.local/share/ subfolder.

What it does

  • Fetches the theme and all linked companions via the OCS API (same one Plasma uses internally)
  • Installs to the correct XDG path per content type — Global Themes, Plasma styles, icon themes, color schemes, Aurorae decorations, Konsole color schemes, wallpapers, Kvantum themes, cursor themes
  • Preview popup so you can see what each item looks like before installing
  • Correctly handles Plasma 5 content (flags it as incompatible rather than silently installing broken files)
  • Verifies MD5 checksums, handles rate limiting, safe archive extraction

Install

pip install git+https://github.com/robinsiebler/kde-theme-installer --user
sudo dnf install python3-tkinter  # or python3-tk on Debian/Ubuntu
kde-theme-installer

GitHub: GitHub - robinsiebler/kde-theme-installer: A GUI program to download and install KDE Plasma themes (all components) automatically · GitHub

Tested on Nobara KDE (Plasma 6, Wayland). Feedback and bug reports welcome — there are still some content types (fonts, GTK themes) that aren’t fully handled yet, and I’d love to know what breaks on other distros.

wow, thanks for contributing.

your timing tho… have you read bout Union and the efforts already underway to streamline this process?

great minds think alike.

I have no clue what Union is. I’ve used Linux for 2 weeks, one of which was getting it installed, configured and fixing all the minor issues I had.

I installed 1 theme and threw up my hands! I’m used to WindowBlinds which made installing Windows themes a matter of a few button clicks.