Files
nix-config/docs/lxqt-niri-setup.md
2025-09-22 09:07:03 -03:00

1.7 KiB

Example: Enabling LXQt with Niri Window Manager

To use LXQt with Niri as the window manager in your NixOS configuration, add the following to your host configuration:

{
  imports = lib.flatten [
    # ... other imports ...
    "hosts/common/optional/lxqt-niri.nix"
    "hosts/common/optional/gdm.nix"  # or sddm.nix for SDDM display manager
    # ... other imports ...
  ];
}

What this provides

  • LXQt Desktop Environment: Full LXQt suite including panel, file manager, settings tools, and applications
  • Niri Window Manager: Modern tiling Wayland compositor with smooth animations
  • Qt Theming: Proper Qt theming integration with LXQt themes and Kvantum support
  • System Integration: Audio (PipeWire), network management, power management, and hardware support
  • XDG Portals: Screen sharing and file picker integration for Wayland applications

Session Selection

After adding this configuration and rebuilding your system, you'll see "LXQt (Niri)" as an option in your display manager's session selection menu.

Additional Notes

  • The configuration enables X11 server support for compatibility with X11-only applications
  • Network management is handled through NetworkManager with Qt frontend
  • Audio is configured with PipeWire for low-latency audio
  • The setup includes proper polkit integration for system authentication dialogs
  • Bluetooth support is enabled by default

Customization

You can further customize the LXQt-Niri experience by:

  • Adding additional LXQt applications to your user packages
  • Configuring Niri-specific settings through its configuration files
  • Using LXQt's appearance settings to customize themes and styling
  • Adding additional Qt applications that integrate well with the LXQt environment