Basic Usage

Learn the most important parts of Regolith first.

While we’ll cover everything in greater detail in other areas of the documentation, this page covers the very basics.

The Super Key

Most keybindings you’ll be using with Regolith start with the super key. This key typically says “WIN” or has a MS Windows logo on it. On a Mac it is the Command key. Going forward, this key will simply be referred to as super but keep in mind that you can change which physical button super maps to in your configuration if you choose to.

Launchers

Regolith provides several launchers as the primary way of interacting with your system. Each of these launchers has a consistent look and feel but provides access to a specific entity. Default launchers are provided for applications super space , commands super shift space , notifications super n , windows super ctrl space , and files super alt space .

Launch an Application

After logging in, you’ll be at a blank screen with the bar at the bottom and some keyboard shortcuts on the right. To launch an application, press super space and a menu will be presented with all of the applications installed on the system. If you begin typing the name of the application you wish to launch, the list will filter down to only matching names. You can also scroll through the list with the arrow keys.

Launch an application

To focus on a running application, the super ctrl space keybinding can be used to show a dialog of all running windows. Simply select the desired window and the system will move to the window’s containing workspace and set its focus.

Dialog for moving to another open window

Create a new Workspace

Workspaces (also known as virtual desktops in some desktop environments) are the primary way by which windows can be managed. Each workspace provides a screen for an independent set of windows. To create a workspace, super ` will create and move to a new workspace. super 0-9 allows for navigation to specific workspaces.

Find and Launch a File

Searching your local computer for a specific file can be achieved in a variety of ways. Regolith provides a file search dialog via super alt space to quickly seek and optionally load a file with its default application. If the file path exceeds the width of the dialog, alt . will toggle text justification. Pressing enter on a selection will cause the file to be invoked with the xdg-open command.

Open file dialog

Terminal

The terminal is a special application that has its own keybinding, super enter .

Browser

The preferred browser is also special and can be launched with super shift enter .

Quit an Application

super shift q will quit the focused application. For misbehaving apps, super alt q will force quit the focused application, but note that any unsaved data will likely be lost.

Switching Workspaces

A primary way of managing how applications occupy the screen is by the usage of workspaces. A workspace is in essence a group of zero or more applications that all present windows on the same virtual display. Users can switch workspaces to “gain” more space for applications to occupy. Windows can be moved across workspaces. Workspaces can be tied to physical display or be moved to other displays as needed. To switch workspaces, hold down the super key and press one of the number keys. This will navigate to that workspace. If any windows exist in a given workspace, it will show in the bar as being active. Thus, by referring to the bar the user can know in which workspaces active applications live.

Workspaces can also be paged forward and backward via super tab and super shift tab .

Configuring the System

The Settings app (also known as gnome-control-center) is the primary interface for common configuration tasks, such as changing the desktop wallpaper, configuring WiFi and Bluetooth, configuring app associations and setting up users. The app can be launched via the super c keybinding or from the launcher via the Settings app.

The GNOME settings app

Further Reading

More keybindings are listed in Remontoire, the shortcut application. This app is loaded automatically on the first session, but not on successive logins. The window can be toggled at any time by clicking the circled i icon in the bar, or pressing super shift ? .


Last modified September 19, 2023: Add Japanese announce (#175) (2ad65c4)