Basics

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 basic users need to know in order to use Regolith.

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.

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.

Terminal

The terminal is a special application that has it's 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 send the kill signal to the focused application. Additionally, depending on the app, one of the following keybindings may cause it to exit:

  • ctrl w
  • ctrl W
  • ctrl q
  • ctrl Q
  • ctrl d
  • alt F4

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 physical 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 known of which workspaces active applications live.

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 ?.