Skip to main content

Nitrux is a Linux distribution that does things very differently than other distributions, or at least to what most people are accustomed to seeing in other Linux distributions, from the desktop workflow to software management and its underpinnings and, ultimately, many of its goals. As such, many people may need assistance getting to know this distribution, so in today’s tutorial, we will check out how to use NX Desktop.

After reading this tutorial, we expect users to understand this distribution better and be able to use the default layout in Nitrux more effectively. So, let’s begin.

Difficulty: ★☆☆☆☆

📜 Table of Contents

  1. Get to Know NX Desktop
    1. What is NX Desktop?
    2. NX Desktop layout (default)
  2. Using NX Desktop
    1. Interacting with application windows
    2. Using the HUD (plasma-hud)
    3. Enabling window tiling (Polonium)
    4. Using Plasma KRunner
    5. Virtual desktops in NX Desktop
    6. Window management in NX Desktop
    7. Complementary addons in NX Desktop
  3. Troubleshooting

Get to Know NX Desktop

After installing Nitrux following our tutorial (and if the user selected the option to log in automatically), you’ll be greeted by NX Desktop on a Wayland session; this is the default graphical session.

🔰 Information: Since Nitrux 2.9.0, Latte Dock is no longer included in the distribution. NX Desktop will default to a similar layout but use Plasma panels instead.

What is NX Desktop?

We’ve covered what NX Desktop is on this website before, but in summary.

  • NX Desktop is a customization layer on top of Plasma 5. While initially, it focused on made-from-scratch artwork, we’ve extended it over the years to include configuration for the window manager, dock, desktop settings, system settings, user configuration, etc.
  • However, despite this extensive configuration of many different settings, NX Desktop is not a desktop environment (as we mentioned). NX Desktop does not provide a desktop shell or applications.

Now that we know what it looks like, what it is, and what it isn’t, let’s look at what things are called and what they do. Looking at the image below, we have the following items. From left to right and top to bottom.

NX Desktop layout (default)

  • Top Panel
    • Window Controls.
      • This top panel area will always display the window controls in the following order.
        • Close
        • Maximize/Restore
        • Minimize
    • Window Title.
      • This top panel area will always display the application title.
    • Window File Menu bar.
      • This top panel area will always display the application’s menu items (or menu bar, as other OSes and desktop environments call these items) from applications that support exporting their menus.
    • System Tray.
      • This top panel area will always display the desktop system tray applets where the user can view notifications, control night color, manage networks, manage supported printers, see clipboard history, change keyboard layout, control the volume, access other items with less priority, and lastly, see the clock and calendar.
  • Dock
    • Applications Menu.
      • This item in the dock will display a grid with all the available applications.
    • Virtual Desktops Overview.
      • This item in the dock gives users quick access to the Overview, which allows for a general view of the current virtual desktop and other virtual desktops. Additionally, users can add or remove virtual desktops using the Overview and move windows from one virtual desktop to another.
    • Task Manager.
      • This item in the dock lists pinned application launchers and non-pinned but running applications. It also allows users to access certain application functionality, such as home directories (like in Index), recent files (most text editors), send application windows to other virtual desktops, or window controls (maximize, minimize, close, restore, etc.).
    • Session Controls.
      • This item in the dock will display the session controls, which allow the user to select an action such as shutdown, reboot, logout, suspend, etc.

This covers everything about knowing NX Desktop; now, let’s move towards using NX Desktop.

Using NX Desktop

Interacting with application windows

Having said that, if the title bar is what users using other operating systems and desktop environments interact with to move windows around the desktop, and it’s hidden in Nitrux, how do users move windows? Well, that’s pretty easy to do by doing the following.

 Hold the modifier key ALT, then left-click the window and drag the application window by moving the mouse or using the touchpad/trackpad.

That’s it.

  • ⚠️ Important: Some windows do not support moving the window if not from the window decoration, like Telegram when using native window decorations or Electron apps that use native window decorations, such as GitHub Desktop. In these cases, use the Plasma keyboard shortcut to drag a window or right-click on the bottom Dock over the application icon, select More Actions, and click Move.

Disclaimer: We do not develop the KWin window manager. Please create issues at its bug tracker here to request features or report problems.

Using the HUD (plasma-hud)

The HUD (provided by plasma-hud) or Heads UP Display uses an intelligent search-based approach to finding and accessing menu items you need. Instead of hunting through menus to find a command, just type what you want (express your intent) and let the HUD show you precisely what you need. Rather than navigating menus to find an application function, just press the MENU key and type what you want the application to do.

MENU key. The icon may differ from the picture.

To complete the action, press RETURN/ENTER or select one of the alternative functions presented in the auto-complete.

The application menu in the HUD provides a fast and efficient way to complete any journey. The HUD also makes functionality more discoverable by matching and displaying available options when the user types what they want; this includes options usually hidden in a sub-sub menu.

This new feature has extensive applicability; it provides a new way of working with any application compatible with the global menu applet on the Window File Menu bar area.

Enabling window tiling (Polonium)

For window tiling functionality, we include Polonium. Polonium is a tiling window manager for KWin 5.27 and newer.

  • Works in Wayland Plasma 5.27 and up.
  • The tiling backend uses binary trees and decent enough code to mod independently.
  • Edit tile sizes with the integrated KWin GUI.
  • Move and tile windows with your mouse and keyboard.
  • Set layouts independently of the desktop.

To enable Polonium, go to System Settings→Window Management→KWin Scripts and check Polonium, then click Apply.

Using Plasma KRunner

KRunner (launched with Alt+F2 or Alt+Spacebar) is the launcher built into the Plasma desktop. While its primary function is to launch programs from a mini-command-line, its functionality can be extended by “runners” to assist the user in accomplishing many tasks.

Virtual desktops in NX Desktop

The default configuration in NX Desktop provides four virtual desktops; these can be accessed by clicking the button to display the Virtual Desktops Overview.

In NX Desktop, by default, when a window is maximized, it’s put into a new virtual desktop, which is a behavior similar to that of recent versions of macOS.

  • 🔰 Information: To turn off this functionality, go to System Settings→Window Management→KWin Scripts and uncheck MACsimize.

Window management in NX Desktop

As mentioned, the top panel houses the window controls, title, and menu bar.

Our standard position for window controls. Image for reference, Plasma X11.

The current layout works by doing the following.

  • Moving window controls to a location that (literally) never changes is good for muscle memory.
  • Different apps use different technologies; the current layout integrates menu bars and window titles in a location that never changes.
  • All windows now “look” similar.
  • Windows are similarly manageable; they can be dragged from the same corners, have the same background shadow, and so on.
  • Software with extensive menu bars fully utilizes the width of the top panel, as do applications that don’t display only their window titles.

Additionally, by right-clicking the application icon in the task manager and hovering over it, users can access the same window management controls and other additional options, such as Move, Resize, Keep above or below other windows, Fullscreen, and Shade.

Complementary addons in NX Desktop

In addition to the changes described earlier, we include other complements, such as setting a video as the wallpaper and a video as the background in the lock screen. The default option in both instances is to use an image.


We include a command-line tool called desktop-config, which handles the following.

  • Ensure that Plasma, i.e., plasmashell, is started when the user logs in, even if it crashes (at this point).
  • Ensure that Fcitx5 is started when the user logs in, even if it crashes(at this point).
  • Ensure that Powerdevil, i.e., KDE’s power management utility, is started when the user logs in, even if it crashes (at this point).
  • Ensure that plasma-hud, i.e., the HUD utility, is started when the user logs in, even if it crashes (at this point).
  • Ensure that the KDE PolicyKit Authentication Agent, i.e., KDE’s PolicyKit integration, is started when the user logs in, even if it crashes (at this point).
  • Easily restart the Plasma Desktop manually at any point while the session is active.
  • Create a log containing helpful information about these processes and their background activity.

To visualize the help of desktop-config, run the following command.

desktop-config --help

That’s it; this concludes today’s tutorial.