VeshellGitHub Install

Veshell

Veshell is a Linux environment that aims to provide a workflow that reduces the need to manipulate windows, feels more natural to navigate, and is accessible to everyone.

In order to achieve that goal, Veshell provides an environment that is predictable and persists across sessions. Every decision you make along the way is remembered, which lets you build your own layout simply by using Veshell.

Spatial model

Opening apps: each one takes the next tile, new rows appear below

It's much easier to navigate in a known space, so we made it predictable: that's why Veshell arranges your apps on a two-dimensional grid.

An example: how you group your apps into rows is up to you

You organize your applications relative to each other, in a way that's meaningful to you. It takes shape naturally, simply by using your computer day to day.

Persistence

Closed apps keep their tile: Resume opens them again

You never save a layout. Veshell records each change as you make it (which app, in which tile, on which row and screen) and puts everything back when you log in.

After a reboot, each app you had open waits in its tile as a placeholder. Click it, or press Enter, and the app starts right there. What comes back with it depends on the app:

  • Browsers, editors and document viewers reopen their own tabs, projects and documents.
  • Terminals reopen in the same folder, running the same program.
  • Other apps start fresh, in the right place.

Veshell doesn't freeze processes or snapshot memory. It puts each app back where it belongs and lets it restore what it knows how to.

Application tiles

A tile is an app's place in your layout. It plays two roles:

  • A placeholder. When the app isn't running, its tile stays where it is. Click it and the app opens right there. You can edit the command the tile runs, and while the app starts, the tile shows its running process and output, so you see at once if something goes wrong.
  • A boundary. The app is kept inside its tile and never spreads over your other apps. The windows it opens on its own behalf (dialogs, file pickers, an About box, a window from a helper process) open in its tile too, instead of taking a new one. And a splash screen hands over to the main window in the same tile.

Display modes

Each tile has a display mode, picked from the buttons on the tile:

Maximized
The app fills its tile, and its dialogs open inside it. The default.
Fullscreen
The app is told it's fullscreen, so it hides its own toolbars and frame, but it stays in its tile.
Game
The game gets direct access to rendering and inputs: the compositor draws it at full size and sends input straight to it, to optimize latency and performance. Going to a game tile never grabs your mouse and keyboard: the game waits behind a frosted layer until you click it. Ctrl+Esc releases them again, and the game keeps its tile.
Floating
For apps that need free placement, like Zoom. The app's windows and dialogs each get their own title bar and move and resize freely, inside the tile: they never leave it. A new window opens on top, and clicking a window raises it.

Moving tiles

Hold Super and drag a tile: drop it on another tile to reorder them, on a row in the vertical panel, or on another screen or monitor. While you hold it, Super+W A S D still moves around, so the layout slides under the tile to a place that wasn't on screen. From the keyboard, Super+Shift+W A S D takes the current app with you.

Monitors and screens

Monitors and screens sound alike, but in Veshell they are two things: the monitor is the device, and a screen is a layout of rows shown on it.

  • By default, a monitor shows a single screen, but you can split a monitor into several screens: very handy on an ultra-wide monitor.
  • With several monitors, each one holds its own screen configuration, which you can swap or change at any time.
  • When a monitor is disconnected, its apps live on in its screens, which stay accessible from the Screen menu.
  • A monitor can also mirror another one.
  • The display settings cover the resolution, fractional scaling, rotation and the arrangement of your monitors.

Interface

The Overview: search, quick apps and the Helm dashboard

Veshell provides a complete interface to interact with your system.

The Shell

The panels give an at-a-glance view of where everything is and let you navigate with a mouse or on a touchscreen.

  • The vertical panel lists the rows. Each icon shows either the apps in the row or the row's category, determined automatically. It also holds the Screen menu, to switch between screen configurations or split your monitor into several screens.
  • The horizontal panel, at the top, shows the tiles of the current row as tabs, and the control for how many tiles share the screen.

The Overview

The Overview gives you quick access to the Helm, an Ephemeral Application Launcher, a file manager and a set of settings to customize your experience. Tap Super to open it.

  • The Helm, your system dashboard. Its widgets show the state of your computer and let you act on it right there:
    • Sound: the volume, and the output and input devices to choose from
    • Connections: Ethernet, Wi-Fi and Bluetooth, each with its switch and its devices
    • Power: the batteries, wireless mice and headsets included
    • Performance: CPU, memory, GPU and disks
    • Media players: playback controls for every app that supports MPRIS
    • Notification history: all your notifications in one place, read ones included, kept across sessions until you clear it
    • Background apps: the apps running without a window, like chat clients, sync tools and game launchers, each with its menu
    • Session: lock, log out, sleep, restart and power off
  • Ephemeral Application Launcher: your layout is for the apps you work in. A quick calculation, a setting to change or a password to look up shouldn't move it around, so the Overview opens apps outside your layout.
  • The file manager: search your files, then browse and preview them in place.
  • The settings, searchable like apps and files (Super+Tab switches the search).

The interface follows Material Design, tinted with a colour you choose.

Hotkeys

The defaults. The arrow keys work everywhere instead of W A S D, and every hotkey can be changed in the keyboard settings.

Moving around

Super+WRow above
Super+SRow below
Super+ATile on the left
Super+DTile on the right
SuperOpen or close the Overview (tap it alone)

Moving apps

Super+Shift+AMove the app one tile left
Super+Shift+DMove the app one tile right
Super+Shift+WSend the app to the row above, and follow it
Super+Shift+SSend the app to the row below, and follow it
Super+dragDrop a tile on another tile, row or monitor
Super+QClose the app

In the Overview

Super+WPrevious result
Super+SNext result
Super+AFocus the search pane
Super+DFocus the content pane (the Helm, a window, a preview)
EnterOpen the selected result (the first one if none is selected)
Super+TabSwitch search: apps, files, settings
EscClose the Overview

System

Super+LLock the session
Super+SpaceNext keyboard layout
Ctrl+EscRelease a game that holds the keyboard and mouse

Screenshots and recordings

PrtScScreenshot: drag an area; it's copied and saved to Pictures
Shift+PrtScRecord: drag an area, press PrtSc again to stop; saved to Videos

Installation

Veshell is packaged by the community for these distributions.

Arch · Manjaro

Three AUR packages: veshell-bin (prebuilt), veshell (built from source) and veshell-git (development). With an AUR helper:

yay -S veshell-bin

Fedora

From COPR:

sudo dnf copr enable @free-explorers/veshell
sudo dnf install veshell-bin

openSUSE

From OBS, on Tumbleweed:

sudo zypper addrepo -f \
  https://download.opensuse.org/repositories/home:/PapyElGringo/openSUSE_Tumbleweed/ veshell
sudo zypper --gpg-auto-import-keys refresh
sudo zypper install veshell-bin

On Slowroll or Leap 16.0, replace openSUSE_Tumbleweed with openSUSE_Slowroll or 16.0.

Debian · Ubuntu

From OBS, on Ubuntu 26.04:

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://download.opensuse.org/repositories/home:/PapyElGringo/xUbuntu_26.04/Release.key \
  | sudo gpg --batch --no-tty --yes --dearmor -o /etc/apt/keyrings/veshell.gpg
echo "deb [signed-by=/etc/apt/keyrings/veshell.gpg] https://download.opensuse.org/repositories/home:/PapyElGringo/xUbuntu_26.04/ ./" \
  | sudo tee /etc/apt/sources.list.d/veshell.list
sudo apt update && sudo apt install veshell-bin

On Debian 13, replace xUbuntu_26.04 with Debian_13 (twice).

NixOS

A flake. It needs flakes and the Veshell binary cache enabled first, see the NixOS guide in the repository. Then:

nix run github:free-explorers/veshell

Then log out, choose Veshell in your login screen's session list, and log in. To build it yourself, see building from source.

Get involved

Veshell is developed in the open by the Free Explorers, a collective that funds open-source work through Open Collective, where every income and expense is public.

Veshell is free software under the GPL-3.0, a Free Explorers project. This site's source is on GitHub.