Regolith Linux

How To

This page contains instructions on how to make commonly requested changes.

Change the default meta keybinding

  1. Open ~/.config/i3-regolith/config in your editor of choice.
  2. The first non-comment line should read set $mod Mod4 .
  3. Replace Mod4 with one of these options.
  4. Reload i3 with ⊞ Win-shift-r.

If you would like this to be easier to change, please vote for this issue

Change the default terminal from st to gnome-terminal

  1. Install gnome-terminal (or whatever terminal you prefer): sudo apt install gnome-terminal. (NOTE: this is not necessary if you already have your terminal installed.)
  2. Remap the i3-wm config to launch gnome-terminal instead of st by editing ~/.config/i3-regolith/config and changing the following line: From: bindsym $mod+Return exec st To: bindsym $mod+Return exec gnome-terminal
  3. Save file and reload i3 with ⊞ Win-shift-r
  4. (Optional) Update your system to default to your terminal of choice by running sudo update-alternatives --config x-terminal-emulator (See this page for more details)

Restore the Regolith default i3-wm configuration file

  1. Delete or copy to another location the file ~/.config/i3-regolith/config
  2. Log out and log back in. A fresh default copy will be installed at ~/.config/i3-regolith/config.

Hide the bar until ⊞ Win is pressed

  1. Open ~/.config/i3-regolith/config in your editor of choice.
  2. After the line bar {, add the following entry: mode hide. (See here for details)
  3. Reload i3 with ⊞ Win-shift-r.

If you would like this to be easier to change, please vote for this issue

Add Stock Ubuntu Session to Login

If Regolith is installed from the LiveCD installer, the stock Ubuntu session is removed due to the finicky way that users must specify sessions in the login screen. Users may wish to add this session back in to access some UI features that Regolith removes. NOTE: This howto does not apply to users installing Regolith on an existing Ubuntu system.

  1. In a terminal, install the Ubuntu session: sudo apt install ubuntu-session
  2. Reboot and when when presented with the login screen, select “Ubuntu” from the “gear” drop-down menu.