Can I use KDE themes on a Wayland session?

Yes. Global Themes, Plasma Styles, and color schemes all work on Wayland. A small number of Desktop Effects are X11-only and will be greyed out in System Settings when running under Wayland.

What is the difference between a Plasma Style and a Global Theme?

A Plasma Style only affects the appearance of panels, widgets, and pop-ups. A Global Theme bundles a Plasma Style together with color schemes, window decorations, icons, and a splash screen into a single package.

How do I reset Plasma to default settings without reinstalling?

Rename or delete ~/.config/plasma-org.kde.plasma.desktop-appletsrc and restart plasmashell. Plasma regenerates the file with defaults on the next launch. Back up the file first if you want to recover your layout.

Are Activities the same as virtual desktops?

No. Virtual desktops divide the screen space within a single Activity context. Activities are separate workspaces, each with their own wallpaper and widget set; each Activity can itself contain multiple virtual desktops.

Why does a downloaded widget not appear after install?

Try restarting plasmashell with systemctl --user restart plasma-plasmashell. If the widget still does not appear, verify it supports your current Plasma version by checking its page on the KDE Store.

How to Customize KDE Plasma

KDE Plasma is one of the most configurable desktop environments on Linux. Unlike environments that hide settings behind third-party tools or require editing dotfiles, Plasma exposes nearly everything through a coherent GUI — but the sheer number of options can be overwhelming. This guide walks through the most useful customization layers: themes, widgets, activities, and key System Settings knobs, so you can build a desktop that fits your workflow rather than fighting the defaults.

Understanding the Plasma Customization Model

Plasma separates appearance from behavior more cleanly than most desktops. A few terms worth knowing before you start:

Global Theme — bundles colors, window decorations, icons, cursors, and the splash screen into one installable package.
Plasma Style — controls the look of panels, widgets, and pop-ups only.
Color Scheme — application window colors, independent of the Plasma Style.
Widget / Plasmoid — an applet that lives on the desktop or inside a panel.
Activity — a separate workspace context with its own wallpaper, widgets, and virtual desktops.

You can mix these independently; a dark color scheme does not force a particular Plasma Style.

Installing KDE Plasma

If you are starting from a minimal install or want the full Plasma environment, install it first.

Debian / Ubuntu

sudo apt install kde-plasma-desktop

Fedora

sudo dnf groupinstall "KDE Plasma Workspaces"

Arch Linux

sudo pacman -S plasma plasma-wayland-session kde-applications

Log out and choose the Plasma (Wayland) session at your display manager. Wayland is the recommended session on modern hardware; X11 remains available if you need it for legacy applications.

Applying a Global Theme

The fastest way to overhaul the desktop's appearance is a Global Theme. Open System Settings → Appearance → Global Theme. Several themes ship with Plasma; more are a click away.

Click Get New Global Themes… to browse the KDE Store directly from the dialog.
Search for a theme (e.g., Breeze Dark, Layan, Sweet), then click Install.
Select the newly installed theme and click Apply.
Tick or untick the sub-components (colors, window decoration, icons) if you only want parts of the theme.

Global themes install into ~/.local/share/plasma/look-and-feel/. You can delete unwanted ones from there or through the same dialog.

Fine-Tuning Appearance

Colors and Fonts

Go to System Settings → Appearance → Colors to pick or download a color scheme without changing anything else. Fonts lets you set the UI font, fixed-width font, and DPI scaling independently — useful on HiDPI displays where the global scale in Display and Monitor → Display Configuration → Global Scale may not be granular enough.

Icons and Cursors

Both live under System Settings → Appearance. Papirus and Breeze are popular icon sets available in most distro repos:

# Debian/Ubuntu
sudo apt install papirus-icon-theme

# Fedora
sudo dnf install papirus-icon-theme

# Arch
sudo pacman -S papirus-icon-theme

After installing, select Papirus or Papirus-Dark in the Icons page and click Apply.

Window Decorations and Effects

System Settings → Appearance → Window Decorations controls title bars and borders. Under System Settings → Window Management → Desktop Effects you can enable or disable compositing effects such as Wobbly Windows, Magic Lamp minimize animation, and the Blur effect behind translucent panels. Disable them all if you are on a low-powered machine; Plasma remains fully functional without them.

Working with Panels and Widgets

Editing the Default Panel

Right-click any empty area of the panel and choose Edit Panel…. A toolbar appears at the panel edge with controls to:

Add spacers (flexible or fixed) to push widgets left or right.
Drag widgets to reorder them.
Set panel height, opacity, and whether it floats or docks to the screen edge.

Click Add Widgets… in the edit toolbar to open the widget picker. Drag any widget onto the panel or double-click to add it at the end.

Right-click the desktop and choose Add Widgets…, or press the default keyboard shortcut:

Meta+A   # default shortcut to open the widget explorer

Drag the widget onto the wallpaper. Lock the desktop with Right-click → Lock Widgets when you are done so you do not accidentally move things.

Installing Third-Party Widgets

From the widget picker, click Get New Widgets → Download New Plasma Widgets. Widgets are installed to ~/.local/share/plasma/plasmoids/. Popular choices include Event Calendar, Latte Separator, and System Monitor widgets. Be aware that third-party plasmoids may lag a Plasma version behind; check the store page for compatibility notes.

Creating a Second Panel

Right-click the desktop, choose Add Panel, then pick Empty Panel or a template. You can place panels on any screen edge. A common setup is a top panel for a global menu or status area and a bottom panel as a taskbar.

Using Activities

Activities are underused but powerful. Think of each Activity as a named context — Work, Personal, Presentation — with its own wallpaper, desktop widgets, and set of virtual desktops. Applications are not confined to an Activity by default, but you can associate windows with specific Activities through the window rules system.

Creating and Switching Activities

Open the Activity manager with the keyboard shortcut or from the taskbar widget:

Meta+Q   # open/close the Activity switcher

In the switcher, click Create Activity, give it a name, and press Enter. Switch between activities with Meta+Tab. Each Activity can have a completely different wallpaper and widget layout set independently — right-click the desktop while inside that Activity to configure it.

Stopping Unused Activities

Activities that are created but not actively used still consume a small amount of memory because KWin tracks their state. In the Activity manager, hover over an Activity and click the stop button (square icon) to suspend it. Its state is preserved; it simply is not loaded until you switch to it.

Configuring Shortcuts and Gestures

System Settings → Shortcuts exposes every KDE application and system action. Set custom shortcuts for KWin operations (tiling, maximizing to a specific screen), or reassign the Meta key from the Application Launcher to something more useful. On Wayland, touchpad gestures for Activities and virtual desktops are configured under System Settings → Workspace Behavior → Touchpad Gestures.

Plasma Configuration Files

When a GUI option does not exist, Plasma stores its configuration in ~/.config/. Key files:

~/.config/plasmarc — Plasma Style and theme settings.
~/.config/plasma-org.kde.plasma.desktop-appletsrc — all panel and widget layout data.
~/.config/kwinrc — KWin compositor and window manager rules.

Back these up before major changes. To reset Plasma to defaults, rename or remove the appletsrc file and restart plasmashell:

mv ~/.config/plasma-org.kde.plasma.desktop-appletsrc \
   ~/.config/plasma-org.kde.plasma.desktop-appletsrc.bak
systemctl --user restart plasma-plasmashell

Verifying Your Setup

After making changes, confirm that Plasma is running cleanly:

systemctl --user status plasma-plasmashell

The output should show active (running). Check for compositor issues (tearing, missing effects) with:

qdbus org.kde.KWin /KWin supportInformation | grep -i compositor

This prints the active compositor type (OpenGL 3.1, Vulkan, etc.) and whether it is in fallback mode.

Troubleshooting

Widgets disappeared after a crash — The appletsrc file may be corrupted. Restore your backup or delete the file to regenerate defaults on the next login.
Theme looks broken (missing icons, wrong colors) — Some themes target a specific Plasma version. Check the theme's store page for a supported version range. Run plasma-apply-lookandfeel --list to see what is actually installed.
High CPU from plasmashell — A misbehaving widget is usually the cause. Enter edit mode, remove widgets one at a time, and watch CPU usage in htop after each removal.
Effects not working on Wayland — Some older effects are X11-only. Check Desktop Effects; unsupported effects are greyed out or absent on Wayland sessions.
Global Theme download fails — Check that knewstuff or libkf5newstuff is installed and that the KDE Store (api.kde-look.org) is reachable from your network.