How To

Show your user how to work through some end to end examples.

More examples and tutorials are available in the Regolith Desktop wiki on GitHub.

Using the Terminal

This section provides examples of how to change Regolith to suit your needs. Most of them will specify commands to be run in the terminal. If using the terminal is new to you or you'd just like to refresh your memory, this guide from Ubuntu is recommended. Another tutorial from linuxcommand.org goes into some more advanced territory.

i3-wm User Guide

In addition to general command-line abilities, having a basic understanding of what options are available in the i3 user guide is recommended to get the most out of the interface.


Override Xresources

Learn how to stage user copies of Regolith configuration files.

Stage Config Files

Learn how to stage user copies of Regolith configuration files.

Change the Default Terminal

Change which terminal Regolith loads by default.

Find and Install Packages

Search for packages and install them on your system.

Support Multiple Batteries

Display status of the batteries per instance.

Change the Bar Date and Time Format

Change the date/time format used in the bar.

Change Bar Status indicators

Make changes to the status indicators in the bar.

Change Workspace Icons and Labels

Learn how to customize each workspace in the bar.

Manage a To-Do List

Create and manage a to-do list from status bar

Change the lock screen program

Configure Regolith to use a lockscreen other than gnome-flashback.

Switch between Regolith PPAs

Changing Regolith PPA allows to get a different set of package versions.

Upgrade Regolith Linux 1.4 to 1.4.1

Updating a Regolith Linux 1.4 ISO install to 1.4.1.

Change Notification Systems

Disable Rofication and add another notification system.

Change the Terminal Font Size

Change the font used in the terminal.

Update packages selectively

Install or upgrade packages selectively from the unstable PPA.

Change the Default Window Gap

Change the pixels between windows.

Assign a workspace to a specific Output (Display)

Specify that a given workspace should always be displayed on a specific monitor.

Wallpaper Configuration

Change wallpaper via GNOME or Xresources

Launch Default i3 Session

Install package i3-gaps-session to keep using i3 without uninstalling Regolith.