Lumen

Lumen, a Linux terminal emulator

Lumen is a free, open-source Linux terminal emulator written in Rust. It runs on X11 and Wayland, on x86_64 and arm64, and installs for your user without sudo.

Updated

Lumen is a terminal emulator for Linux and macOS. On Linux it runs as a native app on both X11 and Wayland, draws every glyph on the GPU, and keeps everything you'd expect from a daily terminal: tabs, split panes, session restore, search, and shell integration for bash, zsh and fish. This page covers what's specific to Linux: installing, the differences between X11 and Wayland, notifications, and making Lumen your default terminal.

If you're still choosing a terminal, the best Linux terminal emulators page compares Lumen with GNOME Terminal, Konsole, kitty, Alacritty, WezTerm, Ghostty and foot. Lumen is new and small next to those, with one main author, so it's worth knowing what you're trading.

Install Lumen on Linux

One command, for your user only:

curl -fsSL https://lumenshell.dev/install | sh

It puts the lumen command in ~/.local/bin and adds a menu entry and icon. There's no sudo and nothing goes in system folders. Run the same command again to update. To remove it, run the script with --uninstall; your settings stay in ~/.config/lumen. The install docs also cover building from source.

If lumen isn't found after installing, ~/.local/bin isn't on your PATH. Most distributions add it at login when the folder exists, so logging out and back in usually fixes it. Otherwise add export PATH="$HOME/.local/bin:$PATH" to your shell's startup file.

Lumen isn't in distribution repositories yet, so apt, dnf and pacman won't find it.

X11 and Wayland

Lumen runs on both, and almost everything behaves the same. Find out which one you're on with:

echo $XDG_SESSION_TYPE

The differences are in the window system, not the terminal:

X11Wayland
Quick terminalTrue drop-down: full width, above other windows, on every workspaceAn ordinary window the key brings forward and minimises
Quick terminal keyquick-terminal-key in the configBind lumen msg quick-terminal in your desktop's shortcut settings
Blurred, see-through backgroundNeeds a compositorNeeds a compositor (every Wayland desktop is one)

The quick terminal on X11

The quick terminal drops down from the top of the screen on a key, from any app, and hides again with its shells still running. On X11, Lumen grabs the key itself:

quick-terminal-key = "f12"
quick-terminal-height = 0.45
quick-terminal-autohide = true

It opens full width on the monitor under the pointer and stays out of the taskbar and Alt+Tab. With quick-terminal-autohide it hides when you click into another window.

The quick terminal on Wayland

Wayland doesn't let an app grab keys from other apps or place its own window at the top of the screen. So on Wayland you add a custom shortcut in your desktop's keyboard settings that runs:

lumen msg quick-terminal

On GNOME that's Settings > Keyboard > Keyboard Shortcuts > Custom Shortcuts; on KDE Plasma, System Settings > Shortcuts. Lumen has to be running for the command to reach it, so add Lumen to your startup applications. The window it toggles is an ordinary window rather than a drop-down. If a true drop-down on Wayland matters more to you than anything else, Yakuake on KDE Plasma is built only for that. The quick terminal docs have the details.

Notifications need notify-send

With shell integration on, Lumen sends a desktop notification when a command that ran for at least notify-after seconds (10 by default) finishes while you're looking at something else. On Linux it sends them through notify-send. Most desktops have it already. If notifications never appear, install it:

# Debian, Ubuntu, Mint, Pop!_OS
sudo apt install libnotify-bin

# Fedora
sudo dnf install libnotify

# Arch
sudo pacman -S libnotify

Check it works with notify-send "hello". You also need a notification daemon, which GNOME, KDE Plasma, Cinnamon and Xfce all include; on a bare window manager such as i3 or Sway, install one like dunst or mako.

Set Lumen as your default terminal on Linux

"Default terminal" means different things to different parts of the system, so there are a few places to set it.

The keyboard shortcut

The simplest change that covers most of what people mean: make Ctrl+Alt+T open Lumen. In GNOME, add a custom shortcut with the command lumen and the keys Ctrl+Alt+T; if the keys are already taken by the built-in terminal launcher, clear that one first. In KDE Plasma, pick Lumen under System Settings > Default Applications > Terminal Emulator.

xdg-terminal-exec

Newer desktops and apps launch "the terminal" through xdg-terminal-exec, which reads a list of preferred terminals from ~/.config. Lumen's menu entry is a standard terminal entry, so you can list it by its desktop file name. On Ubuntu 25.04 and later the file is ~/.config/ubuntu-xdg-terminals.list; elsewhere it's ~/.config/xdg-terminals.list:

lumen.desktop

x-terminal-emulator on Debian and Ubuntu

Older apps run x-terminal-emulator, which Debian-based systems manage with alternatives. Lumen lives in your home folder, so register it by full path:

sudo update-alternatives --install /usr/bin/x-terminal-emulator \
  x-terminal-emulator "$HOME/.local/bin/lumen" 50
sudo update-alternatives --config x-terminal-emulator

The best terminal for Ubuntu page walks through this for Ubuntu in more detail.

What the Lumen Linux terminal emulator includes

  • Tabs and splits. Ctrl+Shift+D splits right, Ctrl+Shift+E splits down, Ctrl+Arrows moves between panes, and Ctrl+Shift+Enter zooms one pane.
  • Session restore. Windows, tabs, splits, sizes and each pane's folder come back on the next launch. Running programs don't.
  • Shell integration. Jump between commands with Ctrl+Shift+Up/Down, copy the last output with Ctrl+Shift+O, and see failed commands marked in red.
  • Input that works. CJK input methods, compose and dead keys, and the kitty keyboard protocol for Neovim and Helix.
  • One config file. ~/.config/lumen/config.toml, applied on save without a restart. See customising your Linux terminal for fonts, themes and prompts.

What Lumen doesn't do

Lumen has no image protocols (no sixel, no kitty graphics), so image previews in tools like yazi won't show; kitty, WezTerm, Ghostty and foot handle those. Sessions can't be detached and reattached, so if you need shells that survive closing the window, run tmux inside Lumen. Key bindings are single chords; sequences like ctrl-a n aren't supported yet.

Questions

Does Lumen work on Wayland?

Yes. Lumen runs natively on Wayland and X11. The one visible difference is the quick terminal: on Wayland it's an ordinary window you toggle with a desktop shortcut that runs lumen msg quick-terminal, while on X11 it's a full-width drop-down.

Why don't Lumen notifications show up on Linux?

Lumen sends them with notify-send. Install libnotify-bin on Debian or Ubuntu (libnotify on Fedora and Arch), and make sure a notification daemon is running. Notifications only fire for commands longer than notify-after seconds that finish while you're looking elsewhere.

How do I change the default terminal in Linux?

It depends on the desktop. In GNOME, bind Ctrl+Alt+T to your terminal in the keyboard settings; in KDE Plasma, use Default Applications > Terminal Emulator. Apps that use xdg-terminal-exec read ~/.config/xdg-terminals.list, and Debian-based systems also use update-alternatives for x-terminal-emulator.

Does Lumen need sudo to install on Linux?

No. The install script puts Lumen in ~/.local/bin with a menu entry for your user. You only need sudo if you choose to register it as the system's x-terminal-emulator.

Try Lumen

Free and open source, for Linux and macOS. Copy the command for your system and paste it into a terminal.

curl -fsSL https://lumenshell.dev/install | sh
brew install --cask lumenshell/tap/lumen