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 modelApps on a grid: rows of tiles, a tile per app.
- NavigationMove by direction, from the keyboard, the mouse or a touchscreen.
- PersistenceYour layout is saved as you go and comes back after a reboot.
- Application tilesMaximized, fullscreen, game and floating display modes.
- Monitors and screensEach monitor has its own rows; an ultra-wide one can be split.
- InterfaceTwo small panels, and an Overview for search and the system.
Spatial model
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.
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
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
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+W | Row above |
| Super+S | Row below |
| Super+A | Tile on the left |
| Super+D | Tile on the right |
| Super | Open or close the Overview (tap it alone) |
Moving apps
| Super+Shift+A | Move the app one tile left |
| Super+Shift+D | Move the app one tile right |
| Super+Shift+W | Send the app to the row above, and follow it |
| Super+Shift+S | Send the app to the row below, and follow it |
| Super+drag | Drop a tile on another tile, row or monitor |
| Super+Q | Close the app |
In the Overview
| Super+W | Previous result |
| Super+S | Next result |
| Super+A | Focus the search pane |
| Super+D | Focus the content pane (the Helm, a window, a preview) |
| Enter | Open the selected result (the first one if none is selected) |
| Super+Tab | Switch search: apps, files, settings |
| Esc | Close the Overview |
System
| Super+L | Lock the session |
| Super+Space | Next keyboard layout |
| Ctrl+Esc | Release a game that holds the keyboard and mouse |
Screenshots and recordings
| PrtSc | Screenshot: drag an area; it's copied and saved to Pictures |
| Shift+PrtSc | Record: 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-binFedora
From COPR:
sudo dnf copr enable @free-explorers/veshell
sudo dnf install veshell-binopenSUSE
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-binOn 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-binOn 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/veshellThen 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.