Regolith Linux

Getting Started

Key Bindings

Regolith is designed for keyboard interaction. The first time you log into a Regolith session, youโ€™ll see a listing of the most useful key bindings on the right-hand side of the screen. This helper will not appear by default on subsequent logins, but you can view them at any time with the โŠž Win-? sequence while on an empty workspace. A full list of keybindings is available here.

Launching Programs

In Regolith Linux, applications are launched via the โŠž Win-space sequence. A full screen dialog is presented. Begin typing the app or command and the list will filter as you type. Launch the app by selecting it and pressing enter.

The terminal, browser, and settings applications are special because they can be directly launched from a keybinding as well as from the application launcher.

Application Key Binding
Terminal โŠž Win-enter
Browser โŠž Win-shift-enter
Configure Bluetooth โŠž Win-b
Configure Displays โŠž Win-d
Configure Network โŠž Win-n
Configure Power โŠž Win-p
Configure Sound โŠž Win-s
Configure Wifi โŠž Win-w

Installing Software

Running the software from app launcher will load the Ubuntu app store. The terminal can also be used to install software, for example sudo apt install vim will install the vim editor.

Terminal Commands

To page up past the top of the screen to see the buffered text, use shift-page up. To adjust the font size in the active terminal, use shift-ctrl-page up shift-ctrl-page down.


Stacks of overlapping windows is something Regolith avoids by default. In tiling window systems, it is common to arrange windows into groupings of workspaces. These can be thought of as virtual screens. These workspaces are used to group and organize work, depending on how you prefer it. Perhaps by program, task, or mood ~ itโ€™s up to you! In traditional window systems, you would search out the window you need from the stack, or use a dock application. In Regolith, you navigate to the workspace that contains the window, or use โŠž Win-w to explicitly select the window from the dialog.

The currently active workspace and all workspaces that you have open will be visible as a series of indexed colored boxes at the lower left part of the screen. The active workspace will be highlighted. To switch to a specific workspace, enter โŠž Win-<workspace number>. For example, to move to workspace 3, enter โŠž Win-3. Relative navigation can be performed with โŠž Win-tab (next) and โŠž Win-shift-tab (previous).

Managing Windows

As you launch more applications in a given workspace, the window manager will re-arrange the existing windows such that all windows are visible without overlap, also known as โ€˜tiledโ€™. The window manager has a strategy for determining the size and position relative to the other active windows. Layout mode can be toggled between horizontal and vertical modes with โŠž Win-backspace. Flipping between horizontal and vertical layouts before launching new windows is a simple way of building the window layout you desire. Resizing and moving windows can also be needed for an exact layout. See below for resize mode. To adjust the distance between windows (gaps) on the active workspace, use โŠž Win-- and โŠž Win-+.

Resizing Windows

โŠž Win-r will cause Regolith to enter window size mode. Youโ€™ll note a text message on the bar, โ€œresizeโ€ when this mode is active. After pressing โŠž Win-r use the arrow keys to change the size of the active window. Press enter or escape to exit resize mode.

Moving Windows

โŠž Win-shift-<arrow key> is used to move the active window on the screen relative to other windows on the same screen. โŠž Win-shift-<workspace number> is used to move windows among workspaces.

System Status

On the right side of the bar are a few system statistics that are periodically updated. From left to right; first is system load, then battery status, (if a battery is detected on the system) followed by the date and time.

System Configuration and Management

The Setting app can be launched via โŠž Win-c (or โŠž Win-space and then typing โ€œsettingsโ€ to launch the control pannel by name). This application is the UI for configuring the computer. Connecting to wifi access points, configuring monitors, configuring power saving policy, and similar tasks can be achieved from this application.

Logging In and Out

When logging in, if Regolith was installed via the PPA rather than the LiveCD, upon the first login after installation you must specify the Regolith session at the login screen. This is done by clicking the small gear icon near the login button and selecting โ€œRegolithโ€. This step isnโ€™t required when using Regolith from the LiveCD as the default Ubuntu session has been removed. To log out, โŠž Win-shift-e will cause you to immediately log out of your session. โŠž Win-escape will lock the screen. โŠž Win-shift-s will cause the system to enter sleep mode.

Regolith Interface Tour

Desktop Bar

The only UI widget persistently on screen. This shows your workspace state as well as some system information such as CPU load and the date.


Essentially as is in other graphical windowing environments such as Mac OS X or Windows, but without titles or decorations. Their size and position are generally managed via the keyboard, although you can use a mouse of you prefer. More details below about window management.


A workspace is simply a computer screenโ€™s worth of windows. By default Regolith provides 19 workspaces to manage your work in.


A full-screen dialog that allows you to launch programs or select windows is available via keybindings.


A transient window overlay at the top right of the screen shows notifications from applications.

Keybinding Helper

Upon first login, a cheat-sheet of keybindings is launched on the right side of the screen. Subsequent logins do not show the shortcuts, but they can be viewed on the desktop with the โŠž Win-? key sequence.

Customizing Regolith

This topic is covered in depth on the Configuration page.

Digging Deeper

i3-wm provides an excellent user manual for those wishing to customize their keybindings or other window behavior. Additionally the i3-wm FAQ page on Reddit is a great resource for asking questions and searching for answers.