Official NixOS Wiki

KDE: Difference between revisions

← Older edit
DHCP (talk | contribs)
232 edits
VisualWikitext
Malix (talk | contribs)
136 edits
m →Configuration: fix: heading format
DHCP (talk | contribs)
232 edits
m style fixes
 
(12 intermediate revisions by 5 users not shown)
Line 7: Line 7:
{{file|3={
{{file|3={
   # Enable Plasma  
   # Enable Plasma  
   services.desktopManager.plasma6.enable = true;
   services = {
    desktopManager.plasma6.enable = true;


  # Default display manager for Plasma
    # Default display manager for Plasma
  services.displayManager.sddm = {
    displayManager.plasma-login-manager.enable = true;
    enable = true;
 
 
    # Optionally enable xserver
  # To use Wayland (Experimental for SDDM)
     # xserver.enable = true;
     wayland.enable = true;
   };
   };
 
}|name=configuration.nix|lang=nix}}
  # Optionally enable xserver
  services.xserver.enable = true;
}|name=configuration.nix|lang=nix}}{{Warning|SDDM is no longer supported on the unstable branch, users on unstable should use Plasma Login Manager instead. See configuration later in this page.}}
 
== Configuration ==
== Configuration ==


Line 27: Line 23:
Some optional packages can be excluded if they are not needed at the cost of functionality.
Some optional packages can be excluded if they are not needed at the cost of functionality.


Optional packages: [https://github.com/NixOS/nixpkgs/blob/nixos-24.11/nixos/modules/services/desktop-managers/plasma6.nix#L159-L174 plasma6.nix]
Optional packages: [https://github.com/NixOS/nixpkgs/blob/7e495b747b51f95ae15e74377c5ce1fe69c1765f/nixos/modules/services/desktop-managers/plasma6.nix#L150-L170]


{{File|3={
{{File|3={
Line 35: Line 31:
     elisa
     elisa
   ];
   ];
}|name=configuration.nix|lang=nix}}
=== Plasma Login Manager ===
[https://github.com/KDE/plasma-login-manager Plasma Login Manager] is currently only available in unstable. If you are on unstable you can enable it with the following configuration.
{{File|3={
  services.displayManager.plasma-login-manager = {
    enable = true;
  };
}|name=configuration.nix|lang=nix}}
}|name=configuration.nix|lang=nix}}


Line 54: Line 40:
   services.displayManager.defaultSession = "plasmax11";
   services.displayManager.defaultSession = "plasmax11";
}|name=configuration.nix|lang=nix}}
}|name=configuration.nix|lang=nix}}
=== Unlock KDE Wallet with LUKS password ===
When using LUKS disk encryption and autologin in your display manager, it is possible to unlock KDE Wallet with the LUKS password. Set the LUKS password, login password, and KWallet keyring password all to the same string, and for NixOS 25.11 and below use the following configuration:
<syntaxhighlight lang="nix">
{
  boot.initrd.systemd.enable = true;
  systemd.services.display-manager.serviceConfig.KeyringMode = "inherit";
  security.pam.services.sddm-autologin.text = pkgs.lib.mkBefore ''
    auth optional ${pkgs.systemd}/lib/security/pam_systemd_loadkey.so
    auth include sddm
  '';
}
</syntaxhighlight>
For Plasma Login Manager in NixOS 26.05 or above, use:
<syntaxhighlight lang="nix">
{
  boot.initrd.systemd.enable = true;
  systemd.services.plasmalogin.serviceConfig.KeyringMode = "inherit";
  security.pam.services.plasmalogin-autologin.rules.auth = {
    systemd_loadkey = {
      order = 0;
      control = "optional";
      modulePath = "${pkgs.systemd}/lib/security/pam_systemd_loadkey.so";
    };
    plasmalogin = {
      order = 1;
      control = "include";
      modulePath = "plasmalogin";
    };
  };
}
</syntaxhighlight>


== Troubleshooting ==
== Troubleshooting ==
Line 61: Line 82:
This is caused by a stale QML cache [https://github.com/NixOS/nixpkgs/issues/177720 (see this issue)]. A dirty way to fix this is by running on a terminal the following command:
This is caused by a stale QML cache [https://github.com/NixOS/nixpkgs/issues/177720 (see this issue)]. A dirty way to fix this is by running on a terminal the following command:


<syntaxHighlight lang=sh>
<syntaxHighlight lang=console>
find ${XDG_CACHE_HOME:-$HOME/.cache}/**/qmlcache -type f -delete
$ find ${XDG_CACHE_HOME:-$HOME/.cache}/**/qmlcache -type f -delete
</syntaxHighlight>
</syntaxHighlight>


Line 84: Line 105:


<syntaxHighlight lang=nix>
<syntaxHighlight lang=nix>
hardware.bluetooth.enable = true;
hardware.bluetooth.enable = true;
</syntaxHighlight>
</syntaxHighlight>


Line 91: Line 112:
<syntaxHighlight lang=nix>
<syntaxHighlight lang=nix>
[
[
bluedevil
  bluedevil
bluez-qt
  bluez-qt
pkgs.openobex
  pkgs.openobex
pkgs.obexftp
  pkgs.obexftp
]
]
</syntaxHighlight>
</syntaxHighlight>


=== Brightness and Color brightness control sets gamma instead of brightness on external monitors ===
=== Brightness and Color brightness control sets gamma instead of brightness on external monitors ===
To allow <code>powerdevil</code> (and by extension the "Brightness and Color" status tray menu) to control brightness on supported monitors directly instead of adjusting gamma, [[Backlight#Via ddcutil|configure your system to enable ddcutil]], and allow your user to use DDC/CI without root.
To allow <code>powerdevil</code> (and by extension the "Brightness and Color" status tray menu) to control brightness on supported monitors directly instead of adjusting gamma, [[Backlight#Via ddcutil|configure your system to enable ddcutil]], and allow your user to use DDC/CI without root. Note that you do not need to add <code>ddcutil</code> to your system packages because PowerDevil uses libddcutil.
 
=== Plasma wallpaper reverts back to default after a Nix GC ===
When setting a wallpaper, Plasma may save the path as a <code>/nix/store/*/share/wallpapers</code> path instead of <code>/run/current-system/sw/share/wallpapers/</code>. To fix this, open <code>$XDG_CONFIG_HOME/plasma-org.kde.plasma.desktop-appletsrc</code> and manually change the paths.
 
=== No available locale settings in the Plasma system settings ===
The "Region & Language" page in the Plasma system settings is somewhat broken on NixOS. Instead, edit the <code>$XDG_CONFIG_HOME/plasma-localerc</code> file.
 
If you really want to configure locale in settings, you can use this workaround:
<syntaxhighlight lang="nix">
{ pkgs, ... }:
{
  i18n = {
    extraLocales = "all";
    imperativeLocale = true; # Unknown if needed (system settings sets user-level override?)
  };
  environment = {
    systemPackages = [ pkgs.stdenv.cc.libc.out ]; # this derivation contains the locales
    pathsToLink = [ "/share/i18n" ];
  };
}
</syntaxhighlight>
 
Switch to that configuration, then run:
 
<syntaxhighlight lang=console>
# mkdir -p /usr/share/i18n
# ln -s /run/current-system/sw/share/i18n/locales /usr/share/i18n/locales
</syntaxhighlight>
That is a very dirty command, and I don't know if it persists across reboots.


== Tips and tricks ==
== Tips and tricks ==
Line 105: Line 155:
=== Plasma-Manager ===
=== Plasma-Manager ===


{{note|  [https://github.com/pjones/plasma-manager Plasma-Manager] is an unofficial community project and is not yet mature}}  
{{note|  [https://github.com/nix-community/plasma-manager Plasma-Manager] is a community project}}  
By default, the Plasma configuration can be handled like on [https://wiki.archlinux.org/title/KDE traditional systems].  
By default, the Plasma configuration can be handled like on [https://wiki.archlinux.org/title/KDE traditional systems].  
With [https://github.com/pjones/plasma-manager plasma-manager], it is possible to make Plasma configurations via nix by providing [https://github.com/nix-community/home-manager home-manager] modules.
With [https://github.com/nix-community/plasma-manager plasma-manager], it is possible to make Plasma configurations via nix by providing [https://github.com/nix-community/home-manager home-manager] modules.


=== User icon (avatar) ===
=== User icon (avatar) ===
Retrieved from "https://wiki.nixos.org/wiki/KDE"