From 274cc42dd814defe832f453dc6a2c76701bcd4cd Mon Sep 17 00:00:00 2001 From: kgilmer <> Date: Sat, 10 Feb 2024 18:59:45 +0000 Subject: [PATCH] kgilmer published a site update --- 404.html | 2 +- categories/index.html | 2 +- .../howtos/add-remove-blocklets/index.html | 4 +- de/docs/howtos/index.html | 4 +- de/docs/index.html | 2 +- de/docs/reference/configurations/index.html | 4 +- de/docs/reference/xresources/index.html | 4 +- de/docs/using-regolith/basics/index.html | 4 +- .../using-regolith/configuration/index.html | 4 +- .../using-regolith/first-launch/index.html | 4 +- de/index.html | 44 +---------------- de/sitemap.xml | 2 +- docs/howtos/add-remove-blocklets/index.html | 4 +- docs/howtos/change-lockscreen/index.html | 4 +- docs/howtos/change-terminal/index.html | 4 +- docs/howtos/change-workspace-icons/index.html | 4 +- docs/howtos/customize-compositor/index.html | 4 +- .../customize-i3-configuration/index.html | 4 +- docs/howtos/default-gap/index.html | 4 +- docs/howtos/disable-unclutter/index.html | 4 +- docs/howtos/find-install-packages/index.html | 4 +- docs/howtos/floating-window/index.html | 4 +- .../howtos/gnome-flashback-session/index.html | 4 +- docs/howtos/hide-i3-bar-by-default/index.html | 4 +- docs/howtos/index.html | 4 +- docs/howtos/install-sway/index.html | 4 +- docs/howtos/minimal-ubuntu-install/index.html | 4 +- docs/howtos/multiple-batteries/index.html | 4 +- docs/howtos/override-xres/index.html | 4 +- docs/howtos/remove-unneeded-deps/index.html | 4 +- .../replace-notification-system/index.html | 4 +- docs/howtos/stage-configs/index.html | 4 +- docs/howtos/tdcli-blocklet/index.html | 4 +- docs/howtos/terminal-font/index.html | 4 +- docs/howtos/time-format/index.html | 4 +- docs/howtos/vanilla-i3-gaps/index.html | 4 +- docs/howtos/workspace-on-output/index.html | 4 +- docs/index.html | 2 +- docs/reference/Releases/index.html | 4 +- docs/reference/Releases/index.xml | 2 +- .../regolith-1.3-release-notes/index.html | 4 +- .../regolith-1.3.1-release-notes/index.html | 4 +- .../regolith-1.4-release-notes/index.html | 4 +- .../regolith-1.4.1-release-notes/index.html | 4 +- .../regolith-1.5-release-notes/index.html | 4 +- .../regolith-1.5.1-release-notes/index.html | 4 +- .../regolith-1.5.2-release-notes/index.html | 4 +- .../regolith-1.5.3-release-notes/index.html | 4 +- .../regolith-1.6.0-release-notes/index.html | 4 +- .../regolith-2.0-release-notes/index.html | 4 +- .../regolith-2.1-release-notes/index.html | 4 +- .../regolith-2.2-release-notes/index.html | 4 +- .../regolith-3.0-release-notes/index.html | 4 +- .../regolith-3.1-release-notes/index.html | 16 +++--- docs/reference/build-system/index.html | 4 +- docs/reference/configurations/index.html | 4 +- docs/reference/index.html | 4 +- docs/reference/keybindings/index.html | 4 +- docs/reference/xresources/index.html | 4 +- docs/using-regolith/basics/index.html | 4 +- docs/using-regolith/configuration/index.html | 4 +- docs/using-regolith/first-launch/index.html | 4 +- docs/using-regolith/index.html | 4 +- docs/using-regolith/index.xml | 4 +- docs/using-regolith/install/index.html | 22 ++++----- ...4427d3b0c69f9e886ba0dd4dc5642506fd7eb.json | 1 + ...bf3ddce3fc8db382da89eeb4c2cafb56b0809.json | 1 - ...07e236372d5645e25d06b23125c3ea37eea1d25.js | 2 +- en/sitemap.xml | 2 +- .../howtos/add-remove-blocklets/index.html | 4 +- .../howtos/customize-compositor/index.html | 4 +- .../customize-i3-configuration/index.html | 4 +- fr/docs/howtos/index.html | 4 +- fr/docs/howtos/override-xres/index.html | 4 +- fr/docs/index.html | 2 +- fr/docs/reference/configurations/index.html | 4 +- fr/docs/reference/index.html | 2 +- fr/docs/reference/keybindings/index.html | 4 +- fr/docs/reference/xresources/index.html | 4 +- fr/docs/using-regolith/basics/index.html | 4 +- .../using-regolith/configuration/index.html | 4 +- .../using-regolith/first-launch/index.html | 4 +- fr/docs/using-regolith/index.html | 2 +- fr/index.html | 49 +------------------ fr/sitemap.xml | 2 +- index.html | 6 +-- index.xml | 6 +-- ...44baea3536329dab2f4dce657785812e16cca.json | 1 + ...c00a2f2640782960c93b5f2f4c0426cf49911.json | 1 - ...8844e6ed3376434b1cbfe8e2262b33fbfb9cac0.js | 2 +- ja/404.html | 2 +- ja/categories/index.html | 2 +- .../howtos/add-remove-blocklets/index.html | 4 +- .../howtos/customize-compositor/index.html | 4 +- .../customize-i3-configuration/index.html | 4 +- ja/docs/howtos/index.html | 4 +- ja/docs/howtos/override-xres/index.html | 4 +- ja/docs/index.html | 2 +- ja/docs/reference/configurations/index.html | 4 +- ja/docs/reference/index.html | 4 +- ja/docs/reference/xresources/index.html | 4 +- ja/docs/using-regolith/basics/index.html | 4 +- .../using-regolith/configuration/index.html | 4 +- .../using-regolith/first-launch/index.html | 4 +- ja/docs/using-regolith/index.html | 4 +- ja/docs/using-regolith/index.xml | 4 +- ja/docs/using-regolith/install/index.html | 20 ++++---- ja/index.html | 4 +- ja/index.xml | 4 +- ja/sitemap.xml | 2 +- ja/tags/index.html | 2 +- posts/announce-regolith-2/index.html | 4 +- posts/attribution/index.html | 4 +- posts/index.html | 4 +- posts/localization/index.html | 4 +- posts/repo-url-change-2.1/index.html | 4 +- posts/status_update_11_23/index.html | 4 +- posts/sway_integration_gsoc/index.html | 4 +- sitemap.xml | 2 +- tags/index.html | 2 +- 120 files changed, 241 insertions(+), 322 deletions(-) create mode 100644 en.search-data.min.41ab4306ed57301a15c9950c9004427d3b0c69f9e886ba0dd4dc5642506fd7eb.json delete mode 100644 en.search-data.min.602c0b4a954cbb227ae880e0765bf3ddce3fc8db382da89eeb4c2cafb56b0809.json rename en.search.min.e64675e449080f8366e8582e7684ade6e028038db999332dacdde305c9465aec.js => en.search.min.62225031cff9cd9e1b18bcd0e07e236372d5645e25d06b23125c3ea37eea1d25.js (92%) create mode 100644 ja.search-data.min.852eb95d32f338517103db8ed8644baea3536329dab2f4dce657785812e16cca.json delete mode 100644 ja.search-data.min.cac02e143c7f76779e865878cefc00a2f2640782960c93b5f2f4c0426cf49911.json rename ja.search.min.f196e0e042db6e9d3e49978a4242c5115b45bc08ee71ba9b79b1c7d5ab29b5a8.js => ja.search.min.b1e39b073d25383dac37ee94a8844e6ed3376434b1cbfe8e2262b33fbfb9cac0.js (93%) diff --git a/404.html b/404.html index cf4dfd24..69a73146 100644 --- a/404.html +++ b/404.html @@ -1,2 +1,2 @@ -404 Page not found | Regolith Desktop

404

Page Not Found

Regolith Desktop

\ No newline at end of file diff --git a/categories/index.html b/categories/index.html index 411c2da8..69f76436 100644 --- a/categories/index.html +++ b/categories/index.html @@ -1,4 +1,4 @@ -Categories | Regolith Desktop
\ No newline at end of file diff --git a/de/sitemap.xml b/de/sitemap.xml index bf03d5e9..5422100e 100644 --- a/de/sitemap.xml +++ b/de/sitemap.xml @@ -1 +1 @@ -https://regolith-desktop.com/de/docs/reference/configurations/2024-02-09T18:13:02-08:00https://regolith-desktop.com/de/docs/using-regolith/first-launch/2024-02-09T18:13:02-08:00https://regolith-desktop.com/de/docs/using-regolith/basics/2024-02-09T18:13:02-08:00https://regolith-desktop.com/de/docs/using-regolith/configuration/2024-02-09T18:13:02-08:00https://regolith-desktop.com/de/docs/howtos/2024-02-09T18:13:02-08:00https://regolith-desktop.com/de/docs/reference/xresources/2024-02-09T18:13:02-08:00https://regolith-desktop.com/de/docs/2024-02-09T18:13:02-08:00https://regolith-desktop.com/de/categories/https://regolith-desktop.com/de/docs/howtos/add-remove-blocklets/2024-02-09T18:13:02-08:00https://regolith-desktop.com/de/2024-02-09T18:13:02-08:00https://regolith-desktop.com/de/tags/ \ No newline at end of file +https://regolith-desktop.com/de/docs/reference/configurations/2024-02-10T10:59:15-08:00https://regolith-desktop.com/de/docs/using-regolith/first-launch/2024-02-10T10:59:15-08:00https://regolith-desktop.com/de/docs/using-regolith/basics/2024-02-10T10:59:15-08:00https://regolith-desktop.com/de/docs/using-regolith/configuration/2024-02-10T10:59:15-08:00https://regolith-desktop.com/de/docs/howtos/2024-02-10T10:59:15-08:00https://regolith-desktop.com/de/docs/reference/xresources/2024-02-10T10:59:15-08:00https://regolith-desktop.com/de/docs/2024-02-10T10:59:15-08:00https://regolith-desktop.com/de/categories/https://regolith-desktop.com/de/docs/howtos/add-remove-blocklets/2024-02-10T10:59:15-08:00https://regolith-desktop.com/de/2024-02-10T10:59:15-08:00https://regolith-desktop.com/de/tags/ \ No newline at end of file diff --git a/docs/howtos/add-remove-blocklets/index.html b/docs/howtos/add-remove-blocklets/index.html index 1a722ad1..bdcf42bb 100644 --- a/docs/howtos/add-remove-blocklets/index.html +++ b/docs/howtos/add-remove-blocklets/index.html @@ -1,4 +1,4 @@ -Change Bar Status indicators | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/change-lockscreen/index.html b/docs/howtos/change-lockscreen/index.html index d88a045e..c321e499 100644 --- a/docs/howtos/change-lockscreen/index.html +++ b/docs/howtos/change-lockscreen/index.html @@ -1,4 +1,4 @@ -Change the lock screen program | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/change-terminal/index.html b/docs/howtos/change-terminal/index.html index c7b62ac0..7acc3e83 100644 --- a/docs/howtos/change-terminal/index.html +++ b/docs/howtos/change-terminal/index.html @@ -1,4 +1,4 @@ -Change the Default Terminal | Regolith Desktop
Change the Default Terminal -

The default terminal that ships with Regolith R1.4 is gnome-terminal, but any X terminal emulator can be used. To update Regolith to use your already installed terminal of your choice, use update-alternatives to specify it as default:

  1. Run update-alternatives --config x-terminal-emulator to see all available terminals installed on your system.
  2. Select the terminal you prefer.
\ No newline at end of file diff --git a/docs/howtos/change-workspace-icons/index.html b/docs/howtos/change-workspace-icons/index.html index f8ffa5c8..e4d5c10c 100644 --- a/docs/howtos/change-workspace-icons/index.html +++ b/docs/howtos/change-workspace-icons/index.html @@ -1,4 +1,4 @@ -Change Workspace Icons and Labels | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/customize-compositor/index.html b/docs/howtos/customize-compositor/index.html index 33ec71c6..40d33be9 100644 --- a/docs/howtos/customize-compositor/index.html +++ b/docs/howtos/customize-compositor/index.html @@ -1,4 +1,4 @@ -Customize Compositor | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/customize-i3-configuration/index.html b/docs/howtos/customize-i3-configuration/index.html index 2bf38af1..5f6fd9ca 100644 --- a/docs/howtos/customize-i3-configuration/index.html +++ b/docs/howtos/customize-i3-configuration/index.html @@ -1,4 +1,4 @@ -Customize i3 Configuration | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/default-gap/index.html b/docs/howtos/default-gap/index.html index d2f5d44a..cc0dd908 100644 --- a/docs/howtos/default-gap/index.html +++ b/docs/howtos/default-gap/index.html @@ -1,4 +1,4 @@ -Change the Default Window Gap | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/disable-unclutter/index.html b/docs/howtos/disable-unclutter/index.html index 15e02900..689b60ef 100644 --- a/docs/howtos/disable-unclutter/index.html +++ b/docs/howtos/disable-unclutter/index.html @@ -1,4 +1,4 @@ -Disable Mouse Hiding (unclutter) | Regolith Desktop
Disable Mouse Hiding (unclutter)
NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information.

By default the mouse cursor disappears if unused for a few seconds. If you prefer that the mouse cursor always remains visible on the screen, follow these steps:

  1. Specify an empty value for the unclutter launcher program with an Xresources override:
$ echo "i3-wm.program.unclutter: :" >> ~/.config/regolith3/Xresources
-
  1. Log out and back in for changes to take effect.
\ No newline at end of file diff --git a/docs/howtos/find-install-packages/index.html b/docs/howtos/find-install-packages/index.html index a4789187..9168fe7d 100644 --- a/docs/howtos/find-install-packages/index.html +++ b/docs/howtos/find-install-packages/index.html @@ -1,4 +1,4 @@ -Find and Install Packages | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/floating-window/index.html b/docs/howtos/floating-window/index.html index c0890b79..42c7caee 100644 --- a/docs/howtos/floating-window/index.html +++ b/docs/howtos/floating-window/index.html @@ -1,4 +1,4 @@ -Launch an app in a Floating Window | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/gnome-flashback-session/index.html b/docs/howtos/gnome-flashback-session/index.html index cd5b2b8f..69b53127 100644 --- a/docs/howtos/gnome-flashback-session/index.html +++ b/docs/howtos/gnome-flashback-session/index.html @@ -1,4 +1,4 @@ -Verify behavior against upstream | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/hide-i3-bar-by-default/index.html b/docs/howtos/hide-i3-bar-by-default/index.html index f56cd64c..928652fe 100644 --- a/docs/howtos/hide-i3-bar-by-default/index.html +++ b/docs/howtos/hide-i3-bar-by-default/index.html @@ -1,4 +1,4 @@ -How to Hide i3-bar by default | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/index.html b/docs/howtos/index.html index 695a711c..2e320d08 100644 --- a/docs/howtos/index.html +++ b/docs/howtos/index.html @@ -1,4 +1,4 @@ -How To | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/install-sway/index.html b/docs/howtos/install-sway/index.html index 08f69a23..84adb883 100644 --- a/docs/howtos/install-sway/index.html +++ b/docs/howtos/install-sway/index.html @@ -1,4 +1,4 @@ -Install the Sway Compositor | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/minimal-ubuntu-install/index.html b/docs/howtos/minimal-ubuntu-install/index.html index 4c9bc34e..99bb81ed 100644 --- a/docs/howtos/minimal-ubuntu-install/index.html +++ b/docs/howtos/minimal-ubuntu-install/index.html @@ -1,4 +1,4 @@ -Minimal Ubuntu Install | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/multiple-batteries/index.html b/docs/howtos/multiple-batteries/index.html index ed9f8feb..ba68a033 100644 --- a/docs/howtos/multiple-batteries/index.html +++ b/docs/howtos/multiple-batteries/index.html @@ -1,4 +1,4 @@ -Support Multiple Batteries | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/override-xres/index.html b/docs/howtos/override-xres/index.html index 11d30ff1..9b1bdc7e 100644 --- a/docs/howtos/override-xres/index.html +++ b/docs/howtos/override-xres/index.html @@ -1,4 +1,4 @@ -Override Xresources | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/remove-unneeded-deps/index.html b/docs/howtos/remove-unneeded-deps/index.html index fe70a49f..2ae08ada 100644 --- a/docs/howtos/remove-unneeded-deps/index.html +++ b/docs/howtos/remove-unneeded-deps/index.html @@ -1,4 +1,4 @@ -Remove Unneeded Dependencies | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/replace-notification-system/index.html b/docs/howtos/replace-notification-system/index.html index e75a3429..59b59fe2 100644 --- a/docs/howtos/replace-notification-system/index.html +++ b/docs/howtos/replace-notification-system/index.html @@ -1,4 +1,4 @@ -Change Notification Systems | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/stage-configs/index.html b/docs/howtos/stage-configs/index.html index 2ec6ff98..eccc37fb 100644 --- a/docs/howtos/stage-configs/index.html +++ b/docs/howtos/stage-configs/index.html @@ -1,4 +1,4 @@ -Stage Config Files | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/tdcli-blocklet/index.html b/docs/howtos/tdcli-blocklet/index.html index a3a05724..b924538f 100644 --- a/docs/howtos/tdcli-blocklet/index.html +++ b/docs/howtos/tdcli-blocklet/index.html @@ -1,4 +1,4 @@ -Manage a To-Do List | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/terminal-font/index.html b/docs/howtos/terminal-font/index.html index dc560871..e0bc88eb 100644 --- a/docs/howtos/terminal-font/index.html +++ b/docs/howtos/terminal-font/index.html @@ -1,4 +1,4 @@ -Change the Terminal Font Size | Regolith Desktop
\ No newline at end of file diff --git a/docs/howtos/time-format/index.html b/docs/howtos/time-format/index.html index 514846a1..1a8b2a27 100644 --- a/docs/howtos/time-format/index.html +++ b/docs/howtos/time-format/index.html @@ -1,4 +1,4 @@ -Change the Bar Date and Time Format | Regolith Desktop
Change the Bar Date and Time Format -
NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information.

The time format (12 or 24 hour) can be specified in Settings:

The date format can be specified by selecting the appropriate region in Settings. A preview of the date format is provided, and logging back in is required for changes to take effect.

The date and time formats can also be explicitly set via Xresources. To do so, override the i3xrocks.date.format2 Xresource key. The format specification for date is simply the arguments that would be passed to the date command on the command line. For example, to print the year in 4 digits, specify +%Y.

\ No newline at end of file diff --git a/docs/howtos/vanilla-i3-gaps/index.html b/docs/howtos/vanilla-i3-gaps/index.html index 11d8cbf9..cf27afc9 100644 --- a/docs/howtos/vanilla-i3-gaps/index.html +++ b/docs/howtos/vanilla-i3-gaps/index.html @@ -1,4 +1,4 @@ -Launch Default i3 Session | Regolith Desktop
Launch Default i3 Session
NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information.

To do so on Ubuntu, run sudo apt install i3-gaps-session to add an option on login that starts vanilla i3-gaps without regolith.

Use Case -#

This is useful for, say, running an application that does not integrate well with GNOME. For example, Spotify’s unmaintained official Linux client mishandles its file selection dialogue and crashes when

  1. Setting user profile photo
  2. Setting album cover photo
  3. Adding a local directory to the library paths

under GNOME and Regolith. Switching to vanilla i3 solves the crash.

Source: Ken’s comment on the relevant issue on GitHub.

\ No newline at end of file diff --git a/docs/howtos/workspace-on-output/index.html b/docs/howtos/workspace-on-output/index.html index 76cd2dcc..9ac77ed4 100644 --- a/docs/howtos/workspace-on-output/index.html +++ b/docs/howtos/workspace-on-output/index.html @@ -1,4 +1,4 @@ -Assign a workspace to a specific Output (Display) | Regolith Desktop
\ No newline at end of file diff --git a/docs/index.html b/docs/index.html index 4e189c4f..983a5c2b 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,4 +1,4 @@ -Docs | Regolith Desktop
\ No newline at end of file diff --git a/docs/reference/build-system/index.html b/docs/reference/build-system/index.html index 8ff65dc1..fbdf3b84 100644 --- a/docs/reference/build-system/index.html +++ b/docs/reference/build-system/index.html @@ -1,4 +1,4 @@ -Build System | Regolith Desktop
\ No newline at end of file diff --git a/docs/reference/configurations/index.html b/docs/reference/configurations/index.html index e48f4241..29579c30 100644 --- a/docs/reference/configurations/index.html +++ b/docs/reference/configurations/index.html @@ -1,4 +1,4 @@ -Config Files | Regolith Desktop
\ No newline at end of file diff --git a/docs/reference/index.html b/docs/reference/index.html index 391f1fef..f1468df6 100644 --- a/docs/reference/index.html +++ b/docs/reference/index.html @@ -1,4 +1,4 @@ -Reference | Regolith Desktop
Reference -

This section contains reference material that may help you with Regolith.

\ No newline at end of file diff --git a/docs/reference/keybindings/index.html b/docs/reference/keybindings/index.html index c1b44dac..d71164d2 100644 --- a/docs/reference/keybindings/index.html +++ b/docs/reference/keybindings/index.html @@ -1,4 +1,4 @@ -Keybindings | Regolith Desktop
Keybindings -
ActionKey Binding
Launch - Application⊞ Win Space
Launch - Browser⊞ Win Shift Enter
Launch - Command⊞ Win Shift Space
Launch - File Browser⊞ Win Shift n
Launch - File Search⊞ Win Alt Space
Launch - Notification Viewer⊞ Win n
Launch - Terminal⊞ Win Enter
Launch - This Dialog⊞ Win Shift ?
Modify - Bluetooth Settings⊞ Win b
Modify - Carry Window to Workspace 1 - 10⊞ Win Alt 0..9
Modify - Carry Window to Workspace 11 - 19⊞ Win Alt Ctrl 1..9
Modify - Containing Workspace⊞ Win Ctrl Shift ↑ ↓ ← →
Modify - Display Settings⊞ Win d
Modify - Load Window Layout⊞ Win .
Modify - Move Window to Workspace 1 - 10⊞ Win Shift 0..9
Modify - Move Window to Workspace 11 - 19⊞ Win Ctrl Shift 1..9
Modify - Move to Scratchpad⊞ Win Ctrl m
Modify - Next Window Orientation⊞ Win Backspace
Modify - Save Window Layout⊞ Win ,
Modify - Settings⊞ Win c
Modify - Tile/Float Focus Toggle⊞ Win Shift t
Modify - Toggle Bar⊞ Win i
Modify - Wifi Settings⊞ Win w
Modify - Window Floating Toggle⊞ Win Shift f
Modify - Window Fullscreen Toggle⊞ Win f
Modify - Window Layout Mode⊞ Win t
Modify - Window Position⊞ Win Shift k j h l
Modify - Window Position⊞ Win Shift ↑ ↓ ← →
Navigate - Next Workspace⊞ Win Tab
Navigate - Next Workspace⊞ Win Alt →
Navigate - Previous Workspace⊞ Win Alt ←
Navigate - Previous Workspace⊞ Win Shift Tab
Navigate - Relative Window⊞ Win k j h l
Navigate - Relative Window⊞ Win ↑ ↓ ← →
Navigate - Scratchpad⊞ Win Ctrl a
Navigate - Window by Name⊞ Win Ctrl Space
Navigate - Workspace 11 - 19⊞ Win Ctrl 1..9
Navigate - Workspaces 1-10⊞ Win 0..9
Resize - Enter Resize Mode⊞ Win r
Session - Exit App⊞ Win Shift q
Session - Lock Screen⊞ Win Escape
Session - Logout⊞ Win Shift e
Session - Power Down⊞ Win Shift p
Session - Reboot⊞ Win Shift b
Session - Refresh Session⊞ Win Shift r
Session - Reload i3 Config⊞ Win Shift c
Session - Restart i3⊞ Win Ctrl r
Session - Sleep⊞ Win Shift s
Session - Terminate App⊞ Win Alt q
\ No newline at end of file diff --git a/docs/reference/xresources/index.html b/docs/reference/xresources/index.html index 8a10d129..76bf9d68 100644 --- a/docs/reference/xresources/index.html +++ b/docs/reference/xresources/index.html @@ -1,4 +1,4 @@ -Xresources | Regolith Desktop
Xresources
Regolith version 3.0 onward replaces “i3-wm” with “wm” in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use “i3-wm” instead of “wm” in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x.
Xresources KeyDescription
gtk.theme_nameGTK Theme (“Legacy Applications” in gnome-tweaks)
gtk.icon_theme_nameGTK Icon Theme
gnome.terminal.audible-bellEnables audible bell in gnome-terminal (true / false)
gtk.document_font_nameGTK Document Font Name
gtk.font_nameGeneral purpose font for GTK apps and the desktop
gtk.monospace_font_nameFont for monospace areas such as i3bar and the terminal
gnome.terminal.background-transparency-percentBackground transparency value for gnome-terminal (0 - 100). See also gnome.terminal.use-transparent-background.
gnome.terminal.fontFont definition for gnome-terminal
gnome.terminal.scrollbarFlag to enable/disable scrollbar (never / always)
gnome.terminal.use-transparent-backgroundEnables transparent background in gnome-terminal (true / false). See also gnome.terminal.background-transparency-percent.
gnome.wallpaperGNOME Wallpaper (can be overridden in Settings)
gnome.wm.themeGNOME Window Manager Theme (unused)
wm.altKey mapping for Alt key. See the i3 User Guide for details.
wm.bar.background.colorBar Background Color
wm.bar.positionBar Screen Position
wm.bar.separator.colorColor of seperator between blocks
wm.bar.separatorcharCharacter to display between blocks
wm.bar.statusline.color
wm.bar.trayoutputEnable or disable the app tray in i3bar
wm.bar.workspace.active.background.color
wm.bar.workspace.active.border.color
wm.bar.workspace.active.text.color
wm.bar.workspace.focused.background.color
wm.bar.workspace.focused.border.color
wm.bar.workspace.focused.text.color
wm.bar.workspace.inactive.background.color
wm.bar.workspace.inactive.border.color
wm.bar.workspace.inactive.text.color
wm.bar.workspace.urgent.background.color
wm.bar.workspace.urgent.border.color
wm.bar.workspace.urgent.text.color
wm.client.focused.color.background
wm.client.focused.color.border
wm.client.focused.color.child_border
wm.client.focused.color.indicator
wm.client.focused.color.text
wm.client.focused_inactive.color.background
wm.client.focused_inactive.color.border
wm.client.focused_inactive.color.child_border
wm.client.focused_inactive.color.indicator
wm.client.focused_inactive.color.text
wm.client.unfocused.color.background
wm.client.unfocused.color.border
wm.client.unfocused.color.child_border
wm.client.unfocused.color.indicator
wm.client.unfocused.color.text
wm.client.urgent.color.background
wm.client.urgent.color.border
wm.client.urgent.color.child_border
wm.client.urgent.color.indicator
wm.client.urgent.color.text
wm.floatingwindow.border.sizeWindow border size in pixels for floating windows
wm.fontWindow manager font
wm.gaps.inner.sizeDefault gap size between windows in pixels
wm.gaps.outer.sizeDefault gap size at screen edge in pixels
wm.modKey mapping for Super key. See the i3 User Guide for details.
wm.window.border.sizeDefault border size in pixels
wm.workspace.01.name .. wm.workspace.19.nameWorkspace Labels
wm.workspace.01.key .. wm.workspace.10.keyWorkspace Shortucts
i3xrocks.action.volume.leftCommand to execute when volume indicator is left clicked (default: none)
i3xrocks.action.volume.middleCommand to execute when volume indicator is middle clicked (default: none)
i3xrocks.action.volume.rightCommand to execute when volume indicator is right clicked (default: mute through amixer)
i3xrocks.action.volume.scrollupCommand to execute when scroll wheel up is used on volume indicator (default: increase volume through amixer)
i3xrocks.action.volume.scrolldnCommand to execute when scroll wheel down is used on volume indicator (default: decrease volume through amixer)
i3xrocks.error.colorColor for bar module in error mode
i3xrocks.label.battery0Bar icon glyph
i3xrocks.label.battery100Bar icon glyph
i3xrocks.label.battery20Bar icon glyph
i3xrocks.label.battery50Bar icon glyph
i3xrocks.label.battery80Bar icon glyph
i3xrocks.label.batteryacBar icon glyph
i3xrocks.label.batterychargingBar icon glyph
i3xrocks.label.batteryunknownBar icon glyph
i3xrocks.label.capslockBar icon glyph
i3xrocks.label.colorBar icon glyph
i3xrocks.label.cpuBar icon glyph
i3xrocks.label.diskBar icon glyph
i3xrocks.label.dnBar icon glyph
i3xrocks.label.helpBar icon glyph
i3xrocks.label.mediapausedBar icon glyph
i3xrocks.label.mediaplayingBar icon glyph
i3xrocks.label.memoryBar icon glyph
i3xrocks.label.muteBar icon glyph
i3xrocks.label.notify.errorBar icon glyph
i3xrocks.label.notify.noneBar icon glyph
i3xrocks.label.notify.someBar icon glyph
i3xrocks.label.numlockBar icon glyph
i3xrocks.label.offBar icon glyph
i3xrocks.label.onBar icon glyph
i3xrocks.label.soundBar icon glyph
i3xrocks.label.thermometerBar icon glyph
i3xrocks.label.timeBar icon glyph
i3xrocks.label.upBar icon glyph
i3xrocks.label.wifiBar icon glyph
i3xrocks.label.wiredBar icon glyph
i3xrocks.nominalDefault bar icon color
i3xrocks.value.colorColor of numerical value in bar module
i3xrocks.value.fontFont for numerical value in bar module
i3xrocks.warningWarning color for bar module

Optional Xresources keys -#

The following Xresources keys are undefined by default but can be used by users to change behavior as desired.

Xresources KeyDescription
wm.gaps.focus_follows_mouseThe window under the mouse has focus if enabled
wm.program.launcher.appCommand i3 executes from the app launcher keybinding
wm.program.launcher.cmdCommand i3 executes from the command launcher keybinding
wm.program.launcher.windowCommand i3 executes for the window navigation keybinding
wm.program.helpCommand to launch from the help keybinding
wm.program.file_searchCommand to launch from the file search keybinding
wm.program.refresh_uiCommand to launch from the session refresh keybinding
wm.program.logoutCommand to launch from the logout keybinding
wm.program.rebootCommand to launch from the reboot keybinding
wm.program.shutdownCommand to launch from the shutdown keybinding
wm.program.lockCommand to launch from the lock screen keybinding
wm.program.sleepCommand to launch from the sleep keybinding
wm.program.settingsCommand to launch from the Control Panel keybinding
wm.program.displayCommand to launch from the Display Settings keybinding
wm.program.wifiCommand to launch from the Wifi Settings keybinding
wm.program.bluetoothCommand to launch from the Bluetooth Settings keybinding
wm.program.filesCommand to launch from the file browser keybinding
wm.program.notification_uiCommand to launch from the notification UI keybinding
wm.program.1…wm.program.3Optional programs to start with i3
i3xrocks.media-player.player-argsOptional arguments used by the media-player i3xrocks block. These arguments are fed straight into playerctl, eg. setting this value to -p spotify only makes the bar display/control spotify.
i3xrocks.action.mic.leftOptional command to run on left button click of microphone status indicator.
i3xrocks.action.mic.middleOptional command to run on middle button click of microphone status indicator.
i3xrocks.action.mic.rightOverride command to run on right button click of microphone status indicator.
i3xrocks.action.mic.scrollupOverride command to run on scroll up of microphone status indicator.
i3xrocks.action.mic.scrolldnOverride command to run on scroll down of microphone status indicator.
i3xrocks.action.volume.leftOptional command to run on left button click of microphone status indicator.
i3xrocks.action.volume.middleOptional command to run on middle button click of microphone status indicator.
i3xrocks.action.volume.rightOverride command to run on right button click of microphone status indicator.
i3xrocks.action.volume.scrollupOverride command to run on scroll up of microphone status indicator.
i3xrocks.action.volume.scrolldnOverride command to run on scroll down of microphone status indicator.
i3xrocks.action.disk-capacityOverride command to run on disk capacity status indicator.
i3xrocks.action.cpu-usageOverride command to run on cpu usage status indicator.
i3xrocks.action.memoryOverride command to run on memory status indicator.
i3xrocks.action.wifiOverride command to run on wifi status indicator.
i3xrocks.action.weatherOverride command to run on weather status indicator.
i3xrocks.action.media-player.leftOptional command to run on left button click of media player status indicator.
i3xrocks.action.media-player.middleOptional command to run on middle button click of media player status indicator.
i3xrocks.action.media-player.rightOverride command to run on right button click of media player status indicator.
i3xrocks.action.timeOverride command to run on date time status indicator.
i3xrocks.action.batteryOverride command to run on battery status indicator.
\ No newline at end of file diff --git a/docs/using-regolith/basics/index.html b/docs/using-regolith/basics/index.html index 6aec9995..08bdbe21 100644 --- a/docs/using-regolith/basics/index.html +++ b/docs/using-regolith/basics/index.html @@ -1,4 +1,4 @@ -Basic Usage | Regolith Desktop
\ No newline at end of file diff --git a/docs/using-regolith/configuration/index.html b/docs/using-regolith/configuration/index.html index bc7951e1..926d02f8 100644 --- a/docs/using-regolith/configuration/index.html +++ b/docs/using-regolith/configuration/index.html @@ -1,4 +1,4 @@ -Configuration | Regolith Desktop
\ No newline at end of file diff --git a/docs/using-regolith/first-launch/index.html b/docs/using-regolith/first-launch/index.html index 0e25949b..2c2f02d9 100644 --- a/docs/using-regolith/first-launch/index.html +++ b/docs/using-regolith/first-launch/index.html @@ -1,4 +1,4 @@ -First Launch | Regolith Desktop
\ No newline at end of file diff --git a/docs/using-regolith/index.html b/docs/using-regolith/index.html index af2488e8..a3f5f023 100644 --- a/docs/using-regolith/index.html +++ b/docs/using-regolith/index.html @@ -1,4 +1,4 @@ -Using Regolith | Regolith Desktop
Using Regolith -
\ No newline at end of file diff --git a/docs/using-regolith/index.xml b/docs/using-regolith/index.xml index 989c136a..3dc60d23 100644 --- a/docs/using-regolith/index.xml +++ b/docs/using-regolith/index.xml @@ -1,5 +1,5 @@ -Using Regolith on Regolith Desktophttps://regolith-desktop.com/docs/using-regolith/Recent content in Using Regolith on Regolith DesktopHugo -- gohugo.ioInstallhttps://regolith-desktop.com/docs/using-regolith/install/Mon, 01 Jan 0001 00:00:00 +0000https://regolith-desktop.com/docs/using-regolith/install/Get Regolith 3.0 # If you&rsquo;re upgrading from an earlier version of Regolith, you may be interested in reading the release notes and most specifically, the migration guide. -Packages Specified at Install Time # In Regolith 3.0 it is now possible to select from multiple sessions (X11: regolith-session-flashback, Wayland: regolith-session-sway). Due to this, when installing Regolith 3.0 also specify one or both sessions that you wish to use. Additionally, it&rsquo;s now possible to specify the Regolith Look at install time, which saves a setup of having to configure it later.First Launchhttps://regolith-desktop.com/docs/using-regolith/first-launch/Mon, 01 Jan 0001 00:00:00 +0000https://regolith-desktop.com/docs/using-regolith/first-launch/First Launch # Regolith&rsquo;s default interface lacks any visual hint as to how to launch applications or perform other common tasks. This can make the first time experience a bit confusing. However using the Regolith interface is relatively simple by only committing the following two keybindings to memory: +Using Regolith on Regolith Desktophttps://regolith-desktop.com/docs/using-regolith/Recent content in Using Regolith on Regolith DesktopHugo -- gohugo.ioInstallhttps://regolith-desktop.com/docs/using-regolith/install/Mon, 01 Jan 0001 00:00:00 +0000https://regolith-desktop.com/docs/using-regolith/install/Get Regolith 3.1 # If you&rsquo;re upgrading from an earlier version of Regolith, you may be interested in reading the release notes and if coming from 2.x, the migration guide. +Packages Specified at Install Time # Starting with Regolith 3.0 it is now possible to select from multiple sessions (X11: regolith-session-flashback, Wayland: regolith-session-sway). Due to this, when installing Regolith 3.1 also specify one or both sessions that you wish to use.First Launchhttps://regolith-desktop.com/docs/using-regolith/first-launch/Mon, 01 Jan 0001 00:00:00 +0000https://regolith-desktop.com/docs/using-regolith/first-launch/First Launch # Regolith&rsquo;s default interface lacks any visual hint as to how to launch applications or perform other common tasks. This can make the first time experience a bit confusing. However using the Regolith interface is relatively simple by only committing the following two keybindings to memory: Action Keybinding Purpose Keybinding Viewer super shift ? View and execute available keybindings App Launcher super space Launch a desktop application The Super Key # Most keybindings you&rsquo;ll be using with Regolith start with the super key.Basic Usagehttps://regolith-desktop.com/docs/using-regolith/basics/Mon, 01 Jan 0001 00:00:00 +0000https://regolith-desktop.com/docs/using-regolith/basics/Usage # Launch an Application # After the first login, the screen will contain a bar at the bottom and some keyboard shortcuts in a dialog. This dialog, ilia, provides assistance for finding keybindings for various actions in the desktop environment. It may be dismissed with the esc key and invoked again with super shift ? . To launch an application, press super space and a similar dialog will load with the applications installed on the system.Configurationhttps://regolith-desktop.com/docs/using-regolith/configuration/Mon, 01 Jan 0001 00:00:00 +0000https://regolith-desktop.com/docs/using-regolith/configuration/Recommended Packages for New Users # Looks # Install all of the official Regolith looks: sudo apt install regolith-look-* Alternatively, apt will list available looks that may be installed: apt list | grep regolith-look- NOTE: this may pull in fonts, themes, and wallpapers. For users looking to minimize disk usage, uninstalling looks that are unused is recommended. diff --git a/docs/using-regolith/install/index.html b/docs/using-regolith/install/index.html index 40711f29..a10cd994 100644 --- a/docs/using-regolith/install/index.html +++ b/docs/using-regolith/install/index.html @@ -1,4 +1,4 @@ -Install | Regolith Desktop
Install -

Get Regolith 3.0 -#

If you’re upgrading from an earlier version of Regolith, you may be interested in reading the release notes and most specifically, the migration guide.

Packages Specified at Install Time -#

In Regolith 3.0 it is now possible to select from multiple sessions (X11: regolith-session-flashback, Wayland: regolith-session-sway). Due to this, when installing Regolith 3.0 also specify one or both sessions that you wish to use. Additionally, it’s now possible to specify the Regolith Look at install time, which saves a setup of having to configure it later. Here is the recommended base install for X11 on Debian-based systems:

sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille
+

Get Regolith 3.1 +#

If you’re upgrading from an earlier version of Regolith, you may be interested in reading the release notes and if coming from 2.x, the migration guide.

Packages Specified at Install Time +#

Starting with Regolith 3.0 it is now possible to select from multiple sessions (X11: regolith-session-flashback, Wayland: regolith-session-sway). Due to this, when installing Regolith 3.1 also specify one or both sessions that you wish to use. Additionally, it’s now possible to specify the Regolith Look at install time, which saves a setup of having to configure it later. Here is the recommended base install for X11 on Debian-based systems:

sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille
 #                ^-- base package ^-- session                ^ -- look
  • For the session, you may chose one or both of: regolith-session-flashback (X11), regolith-session-sway (Wayland)
  • For the look, you may chose one from any available look package:
regolith-look-ayu-dark
 regolith-look-ayu-mirage
@@ -28,11 +28,11 @@

Supported Operating Systems #

Below are sections devoted to installing the Regolith Desktop on specific Linux-based operating systems.

Ubuntu #

-

Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps describe how +

Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps describe how to configure your system to read packages from the Regolith package repository and install the desktop package.

  1. Register the Regolith public key to your local apt:

    wget -qO - https://regolith-desktop.org/regolith.key | \
 gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg > /dev/null

  2. Add the repository URL to your local apt:

    echo deb "[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \
-https://regolith-desktop.org/release-3_0-ubuntu-lunar-amd64 lunar main" | \
+https://regolith-desktop.org/release-3_1-ubuntu-mantic-amd64 mantic main" | \
 sudo tee /etc/apt/sources.list.d/regolith.list

  3. Update apt and install Regolith

    sudo apt update
 sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille
@@ -41,14 +41,14 @@
 to configure your system to read packages from the Regolith package repository and install the desktop package.
    1. Register the Regolith public key to your local apt:
      wget -qO - https://regolith-desktop.org/regolith.key | \
 gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg > /dev/null
 
    2. Add the repository URL to your local apt:
      echo deb "[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \
-https://regolith-desktop.org/release-3_0-ubuntu-jammy-amd64 jammy main" | \
+https://regolith-desktop.org/release-3_1-ubuntu-jammy-amd64 jammy main" | \
 sudo tee /etc/apt/sources.list.d/regolith.list
 
    3. Update apt and install Regolith
      sudo apt update
 sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille
 
    4. System Restart
    The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.
    Replace amd64 with arm64 in the two places in the above line to install on ARM-based systems.

Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps (also available as a downloadable script) describe how to configure your system to read packages from the Regolith package repository and install the desktop package.

  1. Register the Regolith public key to your local apt:

    wget -qO - https://regolith-desktop.org/regolith.key | sudo apt-key add -
-

  2. Add the repository URL to your local apt:

    echo deb "[arch=amd64] https://regolith-desktop.org/release-3_0-ubuntu-focal-amd64 focal main" | \
+

  3. Add the repository URL to your local apt:

    echo deb "[arch=amd64] https://regolith-desktop.org/release-3_1-ubuntu-focal-amd64 focal main" | \
 sudo tee /etc/apt/sources.list.d/regolith.list

  4. Update apt and install Regolith

    sudo apt update
 sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille
@@ -59,7 +59,7 @@
 to configure your system to read packages from the Regolith package repository and install the desktop package.
    1. Register the Regolith public key to your local apt:
      wget -qO - https://regolith-desktop.org/regolith.key | \
 gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg > /dev/null
 
    2. Add the repository URL to your local apt:
      echo deb "[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \
-https://regolith-desktop.org/release-3_0-debian-bookworm-amd64 bookworm main" | \
+https://regolith-desktop.org/release-3_1-debian-bookworm-amd64 bookworm main" | \
 sudo tee /etc/apt/sources.list.d/regolith.list
 
    3. Update apt and install Regolith
      sudo apt update
 sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille
@@ -68,11 +68,11 @@
 to configure your system to read packages from the Regolith package repository and install the desktop package.
      1. Register the Regolith public key to your local apt:
        wget -qO - https://regolith-desktop.org/regolith.key | \
 gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg > /dev/null
 
      2. Add the repository URL to your local apt:
        echo deb "[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \
-https://regolith-desktop.org/release-3_0-debian-bullseye-amd64 bullseye main" | \
+https://regolith-desktop.org/release-3_1-debian-bullseye-amd64 bullseye main" | \
 sudo tee /etc/apt/sources.list.d/regolith.list
 
      3. Update apt and install Regolith
        sudo apt update
 sudo apt install regolith-desktop regolith-compositor-picom-glx
 
      4. System Restart
      The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.
      Replace amd64 with arm64 in the two places in the above line to install on ARM-based systems.
      The regolith-desktop package installs a reasonable minimal configuration that should work on most hardware. To add additional package for a richer and more functional environment read Recommended Packages for New Users.
      The regolith-compositor-picom-glx compositor should work on most computers. If you experience driver or visual issues, try another compositor.

Release Change Policy -#

From Regolith 3.0 onward, all releases will use unique names in the package repo URL. This means that users will be in full control of when they wish to upgrade to a new release. Users wishing to have their package manager always install the latest version, a special stage called release-current is provided.

Calendar +#

From Regolith 3.0 onward, all releases will use unique names in the package repo URL. This means that users will be in full control of when they wish to upgrade to a new release. Users wishing to have their package manager always install the latest version, a special stage called release-current is provided.

\ No newline at end of file diff --git a/en.search-data.min.41ab4306ed57301a15c9950c9004427d3b0c69f9e886ba0dd4dc5642506fd7eb.json b/en.search-data.min.41ab4306ed57301a15c9950c9004427d3b0c69f9e886ba0dd4dc5642506fd7eb.json new file mode 100644 index 00000000..08499410 --- /dev/null +++ b/en.search-data.min.41ab4306ed57301a15c9950c9004427d3b0c69f9e886ba0dd4dc5642506fd7eb.json @@ -0,0 +1 @@ +[{"id":0,"href":"/posts/status_update_11_23/","title":"Status Updates Nov 2023","section":"Blog","content":"Regolith 3.1 \u0026amp; Ubuntu Mantic Support # Due to an issue associated with the Desktop Portal system and the GNOME implementation, that results in a severe usability regression, Ubuntu Mantic support has been delayed until it can be resolved. This change came into Regolith with the inclusion of GNOME 45 into Ubuntu Mantic. It looks like we\u0026rsquo;re getting some help from upstream, but it may be some time until we\u0026rsquo;re able to support GNOME 45-based distros if the solution ends up being that we need to implement our own portal backend to coexist with GNOME\u0026rsquo;s backend.\nAdditionally, Ubuntu 24.04 will be an LTS release and the people behind Ubuntu are putting extra work into it to ensure it\u0026rsquo;s a great one. We may end up forgoing Mantic support altogether if a short term solution does not present itself.\nUbuntu Summit 2023 # Soumya and I had the opportunity to travel to Riga, Latvia earlier this month to attend the Ubuntu Summit, graciously hosted by Canonical. There were a lot of great sessions and it was fantastic to reconnect with some familiar faces and collaborators from the previous year. So many brilliant and friendly people in one place!\nIn particular PapyElGringo announced a new project Veshell as a successor to the Material Shell project. I enjoyed learning about the spacial approach to app and workspace management, and look forward to seeing how the new project progresses.\nSoumya and I attended the Ubuntu Flavor sync session and were given several helpful contacts to work with as the Regolith project gets a closer association to upstream projects Debian and Ubuntu. Stay tuned for future news on this front.\nChat System Migration: Slack -\u0026gt; Matrix # Long-time Regolith contributor Leo had setup a Slack instance in the early days of the Regolith project. It was a great help and it was an effective tool for collaboration. Over time though, I and others in the project had a desire to move to an open platform. In part this is simply due to the risky nature of relying on \u0026ldquo;free\u0026rdquo; versions of commercial, proprietary platforms. Partly due to the Ubuntu\u0026rsquo;s adoption of the Matrix protocol for some community collaboration, I found it to be functional and easy to use. A Matrix \u0026ldquo;Space\u0026rdquo; for the Regolith project has been setup, any everyone is welcome to join. At some point in the next month or so we\u0026rsquo;ll retire the Slack server entirely.\n"},{"id":1,"href":"/docs/howtos/customize-i3-configuration/","title":"Customize i3 Configuration","section":"How To","content":"How to work with Regolith\u0026rsquo;s defaults # The default configurations are stored in /usr/share/regolith/i3/config.d. These are loaded alphabetically. Then user configurations in ~/.config/regolith3/i3/config.d are loaded, also in alphabetical order. Regolith\u0026rsquo;s default configuration is built to be customized by setting Xresources variables, adding user configuration, and adding or removing default configurations via apt. For this reason, there are several approaches to customization of i3 in Regolith that can be used separately or in combination to achieve your configuration cleanly:\n Use Xresources to override variables, e.g. keybindings, strings, program names, colors, etc. Add or remove Regolith default configuration files with apt Add your own user configuration files Replace Regolith\u0026rsquo;s configuration wholesale How to set an Xresources variable # The following configuration example (from /usr/share/regolith/i3/config.d/80_compositor) can be customized to load whatever compositor you want, without editing or overriding the existing i3 configuration file, by setting $wm.program.compositor.\nRegolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. set_from_resource $wm.program.compositor wm.program.compositor /usr/share/regolith-compositor/init exec_always --no-startup-id $wm.program.compositor To do this, simply add a line to ~/.config/regolith3/Xresources like:\n# Use my own home-made compositor wm.program.compositor: /usr/local/bin/my-compositor Similarly, you can override other i3 options with Xresources based on the variable names found in /usr/share/regolith/i3/config.d files:\n## Gap configuration wm.gaps.inner.size: 1 ## Border configuration wm.window.border.size: 3 wm.client.focused.color.child_border: #AAD3E9 ## Workspace names wm.workspace.01.name: 1:FOO For more, please read a more in-depth discussion on Xresources\nHow to uninstall a default partial # If you want to wholly replace or remove settings provided by a default partial, you can use apt to remove the package which provides that partial.\nTo identify the name of the package that provides the partial you want to remove:\ndpkg -S /usr/share/doc/regolith-i3-workspace-config The output contains the name of the package:\nregolith-i3-workspace-config: /usr/share/doc/regolith-i3-workspace-config Validate the full list of files provided by this package so you know what you\u0026rsquo;re removing:\ndpkg -L regolith-i3-workspace-config Remove the partial:\nsudo apt remove regolith-i3-workspace-config How to customize a default partial # WARNING: To customize only one of Regolith\u0026rsquo;s default partials, you must first ensure that the file ~/.config/regolith3/i3/config does not exist. This overrides Regolith\u0026rsquo;s defaults entirely, which is incompatible with this how-to. First, ensure that a directory exists for user config partials.\nmkdir -p ~/.config/regolith3/i3/config.d Then, copy the default configuration into your user configuration directory:\ncp /usr/share/regolith/i3/config.d/40_workspace-config ~/.config/regolith3/i3/config.d/ Make your desired changes:\nvim ~/.config/regolith3/i3/config.d/40_workspace-config Clean up the package containing the defaults:\nsudo apt remove regolith-i3-workspace-config Finally, restart i3 or log out and back in.\nHow to replace Regolith\u0026rsquo;s defaults completely # If you don\u0026rsquo;t want to keep any of Regolith\u0026rsquo;s defaults (for example, you\u0026rsquo;re an experienced i3 user with a complete personal config you want to use), you can either uninstall all of Regolith\u0026rsquo;s config partials, and/or create your own root config at ~/.config/regolith3/i3/config.\n"},{"id":2,"href":"/docs/using-regolith/install/","title":"Install","section":"Using Regolith","content":"Get Regolith 3.1 # If you\u0026rsquo;re upgrading from an earlier version of Regolith, you may be interested in reading the release notes and if coming from 2.x, the migration guide.\nPackages Specified at Install Time # Starting with Regolith 3.0 it is now possible to select from multiple sessions (X11: regolith-session-flashback, Wayland: regolith-session-sway). Due to this, when installing Regolith 3.1 also specify one or both sessions that you wish to use. Additionally, it\u0026rsquo;s now possible to specify the Regolith Look at install time, which saves a setup of having to configure it later. Here is the recommended base install for X11 on Debian-based systems:\nsudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille # ^-- base package ^-- session ^ -- look For the session, you may chose one or both of: regolith-session-flashback (X11), regolith-session-sway (Wayland) For the look, you may chose one from any available look package: regolith-look-ayu-dark regolith-look-ayu-mirage regolith-look-ayu regolith-look-blackhole regolith-look-default-loader regolith-look-default regolith-look-dracula regolith-look-gruvbox regolith-look-i3-default regolith-look-lascaille regolith-look-nevil regolith-look-nord regolith-look-solarized-dark An an example and alternative to the recommendation above, here is the apt line to install the Sway session with the Nord Look:\nsudo apt install regolith-desktop regolith-session-sway regolith-look-nord Supported Operating Systems # Below are sections devoted to installing the Regolith Desktop on specific Linux-based operating systems.\nUbuntu # Ubuntu 23.10 Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | \\ gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg \u0026gt; /dev/null Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/release-3_1-ubuntu-mantic-amd64 mantic main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. Ubuntu 22.04 Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps (also available as a downloadable script) describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | \\ gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg \u0026gt; /dev/null Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/release-3_1-ubuntu-jammy-amd64 jammy main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. Ubuntu 20.04 Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps (also available as a downloadable script) describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | sudo apt-key add - Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64] https://regolith-desktop.org/release-3_1-ubuntu-focal-amd64 focal main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. Regolith Linux 2.2 ISO Regolith Linux is the Regolith Desktop environment installed into a customized Ubuntu 22.10 installer image. It allows one to boot from a USB drive to run Regolith without having to install it. It also allows to install the system onto a computer\u0026rsquo;s drive. Regolith Linux has the following features in addition to the Regolith Desktop:\n Regolith-branded boot and login screens Uses the lightdm display manager over gdm3 to avoid unneeded dependencies The following packages are not installed: gdm3, gnome-shell, ubuntu-session, evolution-data-server, snapd. These packages may be installed as needed by the user. Download Regolith Linux 2.2 See the Regolith 2.2 release notes for more information.\nThe ISO can be written to a USB drive on Linux using dd, GNOME Disk Utility, or the KDE ISO Image Writer. On macOS, use Etcher. On Windows, use Rufus and write in DD mode.\n Debian # Debian Bookworm Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps (also available as a downloadable script) describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | \\ gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg \u0026gt; /dev/null Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/release-3_1-debian-bookworm-amd64 bookworm main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. The regolith-desktop package installs a reasonable minimal configuration that should work on most hardware. To add additional package for a richer and more functional environment read Recommended Packages for New Users. The regolith-compositor-picom-glx compositor should work on most computers. If you experience driver or visual issues, try another compositor. Debian Bullseye Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps (also available as a downloadable script) describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | \\ gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg \u0026gt; /dev/null Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/release-3_1-debian-bullseye-amd64 bullseye main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-compositor-picom-glx System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. The regolith-desktop package installs a reasonable minimal configuration that should work on most hardware. To add additional package for a richer and more functional environment read Recommended Packages for New Users. The regolith-compositor-picom-glx compositor should work on most computers. If you experience driver or visual issues, try another compositor. Release Change Policy # From Regolith 3.0 onward, all releases will use unique names in the package repo URL. This means that users will be in full control of when they wish to upgrade to a new release. Users wishing to have their package manager always install the latest version, a special stage called release-current is provided.\n"},{"id":3,"href":"/docs/reference/keybindings/","title":"Keybindings","section":"Reference","content":" Action Key Binding Launch - Application ⊞ Win Space Launch - Browser ⊞ Win Shift Enter Launch - Command ⊞ Win Shift Space Launch - File Browser ⊞ Win Shift n Launch - File Search ⊞ Win Alt Space Launch - Notification Viewer ⊞ Win n Launch - Terminal ⊞ Win Enter Launch - This Dialog ⊞ Win Shift ? Modify - Bluetooth Settings ⊞ Win b Modify - Carry Window to Workspace 1 - 10 ⊞ Win Alt 0..9 Modify - Carry Window to Workspace 11 - 19 ⊞ Win Alt Ctrl 1..9 Modify - Containing Workspace ⊞ Win Ctrl Shift ↑ ↓ ← → Modify - Display Settings ⊞ Win d Modify - Load Window Layout ⊞ Win . Modify - Move Window to Workspace 1 - 10 ⊞ Win Shift 0..9 Modify - Move Window to Workspace 11 - 19 ⊞ Win Ctrl Shift 1..9 Modify - Move to Scratchpad ⊞ Win Ctrl m Modify - Next Window Orientation ⊞ Win Backspace Modify - Save Window Layout ⊞ Win , Modify - Settings ⊞ Win c Modify - Tile/Float Focus Toggle ⊞ Win Shift t Modify - Toggle Bar ⊞ Win i Modify - Wifi Settings ⊞ Win w Modify - Window Floating Toggle ⊞ Win Shift f Modify - Window Fullscreen Toggle ⊞ Win f Modify - Window Layout Mode ⊞ Win t Modify - Window Position ⊞ Win Shift k j h l Modify - Window Position ⊞ Win Shift ↑ ↓ ← → Navigate - Next Workspace ⊞ Win Tab Navigate - Next Workspace ⊞ Win Alt → Navigate - Previous Workspace ⊞ Win Alt ← Navigate - Previous Workspace ⊞ Win Shift Tab Navigate - Relative Window ⊞ Win k j h l Navigate - Relative Window ⊞ Win ↑ ↓ ← → Navigate - Scratchpad ⊞ Win Ctrl a Navigate - Window by Name ⊞ Win Ctrl Space Navigate - Workspace 11 - 19 ⊞ Win Ctrl 1..9 Navigate - Workspaces 1-10 ⊞ Win 0..9 Resize - Enter Resize Mode ⊞ Win r Session - Exit App ⊞ Win Shift q Session - Lock Screen ⊞ Win Escape Session - Logout ⊞ Win Shift e Session - Power Down ⊞ Win Shift p Session - Reboot ⊞ Win Shift b Session - Refresh Session ⊞ Win Shift r Session - Reload i3 Config ⊞ Win Shift c Session - Restart i3 ⊞ Win Ctrl r Session - Sleep ⊞ Win Shift s Session - Terminate App ⊞ Win Alt q "},{"id":4,"href":"/docs/reference/Releases/regolith-3.1-release-notes/","title":"3.1 Release Notes","section":"Releases","content":"Regolith 3.1 Release Notes # Regolith 3.1 is a minor release focusing on Ubuntu 23.10 support and bug fixes.\nFeatures # Ubuntu 23.10 (Mantic) support Debian Testing support for Wayland session i3-next-workspace ported to Sway regolith-control-center rebased from GNOME 45 (for supported disto releases) Sway session promoted from alpha to beta status Installation Instructions # Follow the standard installation instructions, but substitute testing instead of release-3_0. For example, this is the apt line for Ubuntu Mantic:\necho deb \u0026#34;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/testing-ubuntu-mantic-amd64 mantic main\u0026#34; | \\ sudo tee /etc/apt/sources.list.d/regolith.list After apt upgrade is complete, verify that Regolith 3.1 is installed by:\n$ cat /etc/regolith/version REGOLITH_VERSION=3.1 A reboot is required for the new version to load.\nChangelog Delta from Regolith 3.0 # Changes in regolith-control-center # 8545068e7 chore: add Regolith-Wayland in OnlyShowIn 08a8514db fix: disable whoopsie for debian compat Changes in regolith-displayd # aa3d572 fix: cannot reenable monitors c4ebc88 fix: disabled monitors should reflect in mointors instead of logical_monitors 5cdb6df feat: add support for builtin monitor Changes in regolith-i3xrocks-config # 320980c fix: relax dependency on control center. Changes in regolith-session # dafa3b7 fix: add (soft) dependency to xdg-desktop-portal-regolith due to gnome 45 interop issues. 1a1c5e0 fix: set XDG_CURRENT_DESKTOP, overriding previous value if already set 8f5da99 fix: set XDG_CURRENT_DESKTOP for wayland session (fixes screencasting) Changes in regolith-wm-config # ea53b18 fix: make all non-root config partials soft dependendencies for more flexibility 6bd920a chore: rename resources namespaced in regolith.clamshell.* to wm.clamshell.* 04eee9b feat: implement clamshell functionality for sway db38632 fix: force removal of deprecated ilia integration package 7f1bae9 fix: enable carry mode in childe b9d42e8 fix: prevent broken legacy package from remaining installed for next-workspace 6992986 fix: properly segment i3 and say versions of next-workspace partial b36e821 feat: add next-workspace feature to sway session, copied from x11 i3-next-workspace 6356077 [15_base_launchers] add vm.program.browser a777246 [15_base_launchers] add vm.program.terminal 9b1706d Move default-style to soft dep for both sessions. demote 3 more for sway session to soft per PR feedback d21c32c fix: remove (redundant) hard dependency from sway session to rofication. Soft dependency comes via regolith-wm-config. Changes in sway-regolith # 75311f9a update patch filename for consistency b94bd17b fix: do not ship wallpaper, provided by sway-wallpaper package 6e56e53f fix: remove git versioning and fix c warning to appease debian builder on mantic 8dd63940 feat: upgrade packaging to sway v1.8.1 2a2e3b93 fix: include wl_protos_src in sway_sources 9160dab1 feat: apply patch for dbus tray menu 34f5363c Applied patch for regolith compatibility 227ac44a debian: import packaging from v1.7 Changes in sway-audio-idle-inhibit # 162c01f chore: bump libwlroots dependency version Changes in trawl # dfcabfb chore: pin zvariant version to 3.4.1 Changes in xdg-desktop-portal-regolith # * Initial implementation, forked from `xdg-desktop-portal-elementary`. "},{"id":5,"href":"/docs/reference/configurations/","title":"Config Files","section":"Reference","content":"Config file quick reference # Component Default Config User Config Notes i3 / i3-gaps /etc/regolith/i3/config, /usr/share/regolith/i3/config.d ~/.config/regolith3/i3 Extend Regolith2 config by creating config.d and partials in the user config dir, or globally override it by creating config. More Xresources /usr/share/regolith-look/default ~/.config/regolith3/Xresources ~/.Xresources is also loaded but intended for properties that may also be required in other desktop sessions. More Bar status indicators /usr/share/i3xrocks/conf.d/ ~/.config/regolith3/i3xrocks/conf.d Each block has it\u0026rsquo;s own file. Configs loaded in filename alphabetical order. More Picom (Compton) Compositor /etc/regolith/picom/config ~/.config/regolith3/picom/config More WARNING: Adding an i3 config file in ~/.config/regolith3/i3/config will essentially override all Regolith configuration including Xresources and looks. History # Config partials # Regolith 2.0 adds support for config partials, as this feature came to i3 recently in 4.20. This is done by includes. This support for includes enables Regolith 2.0\u0026rsquo;s use of the package manager to add or remove default configuration partials. By installing and removing packages, i3 configuration can be customized for specific preferences while still allowing to track upstream changes for aspects of the configuration that need not vary.\nThe root Regolith configuration file at /etc/regolith/i3/config loads partials like so:\n# Include any regolith i3 partials include /usr/share/regolith/i3/config.d/* # Include any user i3 partials include $HOME/.config/regolith2/i3/config.d/* "},{"id":6,"href":"/docs/using-regolith/first-launch/","title":"First Launch","section":"Using Regolith","content":"First Launch # Regolith\u0026rsquo;s default interface lacks any visual hint as to how to launch applications or perform other common tasks. This can make the first time experience a bit confusing. However using the Regolith interface is relatively simple by only committing the following two keybindings to memory:\n Action Keybinding Purpose Keybinding Viewer super shift ? View and execute available keybindings App Launcher super space Launch a desktop application The Super Key # Most keybindings you\u0026rsquo;ll be using with Regolith start with the super key. This key typically says \u0026ldquo;WIN\u0026rdquo; 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.\n Entering one of these keybindings will cause a launcher dialog to pop up on the focused monitor. Both of these dialogs have the same general interface:\n The interface, a program called ilia, has a text entry widget at the top, followed by a list selection widget. The general usage pattern for these dialogs is to select an item from the displayed list. Begin typing to filter the selections, and use the arrow keys to make a selection. Pressing enter will cause the selected item to be activated. For keybindings, this means a keybinding will be manually executed. For apps, the selected application will be launched.\nKeybinding Viewer # The keybinding viewer\u0026rsquo;s purpose is to make finding and learning the Regolith keybindings quick and easy. A reference to the keybindings is available on this site, however it\u0026rsquo;s faster to simply bring up the dialog and search for the action you are looking for. Once found, the keybinding can be executed either with the keyboard or by selecting the item in the dialog.\nApplication Launcher # A fundamental task of any desktop environment is to enable users to launch applications. In Regolith this is done via the app launcher dialog. As with keybindings, the dialog first shows a list of all available desktop applications. Begin typing to filter the selection and use the arrow keys to specify a specific selection. Press enter to launch the selected application.\nNext Steps # Have a look at the basics page to learn more about the Regolith interface.\n"},{"id":7,"href":"/posts/repo-url-change-2.1/","title":"Package URL change for 2.1","section":"Blog","content":"Summary # For the Regolith 2.1 release, the host name of the URL from which apt pulls packages has changed. The new hostname is regolith-desktop.org. In order to update to Regolith 2.1 and get fixes and upgrades going forward kindly update your apt configuration.\nThe old apt URL:\n/etc/apt/sources.list.d/regolith.list:\ndeb [arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] https://regolith-desktop.io/release-ubuntu-jammy-amd64 testing main ^ | (this changes to '.org') The new apt URL:\n/etc/apt/sources.list.d/regolith.list:\ndeb [arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] https://regolith-desktop.org/release-ubuntu-jammy-amd64 testing main All other aspects of the package configuration remain the same including the key used to verify packages.\nAdditional Info # The Regolith 2.1 release reintroduced the ISO form of distribution. In order to generate the ISO with the production apt URL the packages needed to be published first. This essentially required a way of publishing the release before we wish users to get access to the packages. In order to achieve this the idea of using a URL and switching the host seemed like a good idea. Problems occurred when the realities of TLS cert management became apparent. When the domain was remapped to the new host, the TLS certificates were not. Later, when the problem became known, the hosting provider gave advice on how to resolve the problem. However, the original source domain name (regolith-desktop.io) somehow is not able to take a new cert registration from the new host. Some remedies have been suggested by users, but due to the nature of the production host we opted to leave the system as-is and migrate to the new domain to prevent further churn for users.\nWhen the 2.1 release was published, the URL was updated to regolith-desktop.org. Users still using regolith-desktop.io will most likely be stuck on the 2.0 release unless the TLS certificate issue is ignored or in some way resolved.\n"},{"id":8,"href":"/docs/reference/Releases/regolith-3.0-release-notes/","title":"3.0 Release Notes","section":"Releases","content":"Regolith 3.0 Release Notes # Regolith 3.0 is a major release focusing on a new Wayland-based session, Debian 12, and Ubuntu 23.04 support.\nNew Major Features # Ubuntu 23.04 (lunar) support Debian 12 (Bookworm) support Alpha release of Wayland session based on the Sway compositor (See migration guide) Migration Guide # Important information for existing Regolith users The directory for user-staged configuration files has changed from ~/.config/regolith2 to ~/.config/regolith3. To generalize across X11 and Wayland sessions, Xresource keys have been renamed to remove \u0026ldquo;i3-\u0026rdquo;. This means that users with XResource overrides on earlier versions of Regolith will need to update the key names. Specifically, keys starting with i3-wm now start with wm. For example, in Regolith 2.x to change gaps size, i3-wm.gaps.inner.size is being renamed to wm.gaps.inner.size in Regolith 3.0. Some functionality may now require you to install certain packages manually. An example here is the regolith-wm-user-programs package that runs programs defined in your Regolith configuration declared by wm.program.\u0026lt;N\u0026gt;:. Changelog Delta from beta 3 to beta 4 # Changes in regolith-displayd: # 4e2606b feat: add fractional scaling for resolutions greater than 1920 x 1080 0ea712d chore: linting changes Changes in regolith-i3xrocks-config: # 3eed9da Package changes 7f25895 Use a … instead of ... to show more of the artist and title (#143) 2f73725 Use value colors for battery percentage and charge (#148) Changes in regolith-session: # 37f0773 fix: add conflicts to avoid collision on ext package c0bf9b8 move autostart file to new package 76d8d1d fix: move idle autostart file to seperate package as soft dep to maintain compat w/ upstream flashback c072b4f fix: path to idle monitor daemon incorrect e092d1d fix: Ship idle monitor autostart desktop file. Addresses https://github.com/regolith-linux/regolith-session/pull/15 7f76fdf fix: install picom compositor by default on x11 session 59120ee feat: enable loading of last installed theme on first session install in xorg session fe33317 fix: changelog version invalid b8c6564 fix: on first lanch of sway session, call load_look() function to setup environment 9c9c42b add error handling in case that Xres/trawl look path is invalid f67e8ac feat: if a look is not set in xres/trawl, load the most recently installed look instead of default 0389967 fix: push regolith-default-settings down to x11 session, possibly unneeded for wayland (experiemental) Changes in regolith-wm-config: # f5892dc fix: inconsistent behavious of XF86AudioPlay ba26d1f chore: update homepage d85be5a fix: add i3 gaps to debian control Changes in regolith-desktop: # 821c31c fix: push regolith-default-settings down to x11 session, possibly unneeded for wayland (experiemental) Changelog Delta from beta 2 to beta 3 # Changes in regolith-wm-config: # d95e330 fix: inconsistent behavious of XF86AudioPlay 9d98515 fix: add i3 gaps to debian control 32fd6d4 Remove deprecated dependency i3-gaps 21da9b6 Fix conflict between deprecated regolith-wm-ilia and wm specific updates 6e697ad fix: add missing package declaration in control 05b8e9d fix: use 'bindsym --to-code' on sway for more consistent key mapping behavior with i3 Changes in regolith-session: # e0012a4 feat: add additional diagnostic infor about the current session Changes in ilia: # 62aef17 fix(wayland): ilia returns empty keybindings page if a directory included in the configs doesn't exist c3a03f8 more window manager agnostic renames 8cfc7e3 rename I3Client to IPCClient c78fa1b rename read_i3_config to read_config Changes in regolith-i3xrocks-config: # 7f25895 Use a … instead of ... to show more of the artist and title 2f73725 Use value colors for battery percentage and charge Changelog Delta from beta 1 to beta 2 # Changes in regolith-wm-config: # 445edee feat: add common directory for shared configs between i3 and sway d3c5ca2 fix(#866): incorrect path for i3 user config directory Changelog Delta from Regolith Desktop 2.2 to 3.0 # Changes in regolith-session: # 41dbd95 Making regolith-look-default hard dependency f17a946 Migrate to wm agnostic packages in x11 c5e7900 version bump f5a9901 Minor cleanup of package metadata 14e41f7 Changed source package format 3f042ff Add ilia and rofication and associated config to sway session recommends for usable setup 765ba57 Add dependency on virt look package to ensure resources are loaded a98da23 Change package format 385c478 Fixed workspace naming for resource cleanup e78230a Added gnome-terminal to recommends c4e17b3 Prevent loading the incorrect look 49b09f7 Added gnome-settings-daemon as dependency for regolith-session-sway 9968419 Move desktop dep to flashback session to keep desktop wm indenpendent 5aba956 cleanup 5f9f1d0 Update package deps for wayland 32f9eb9 Use quilt packaging format in hopes of resolving build error be04b61 Update package metadata, attempt fix of regolith-diagnostic confict 5e80731 Fix version so package will build into repo a6b7daa Send tick before reload on sway c1bdf0f Remove RfKill from required components 4c5aa9d Add regolith-sway-config as dependency 71d906a Updated depends for regolith-session-sway 9ee4d88 Fix look not loading on startup 03ab9a4 Load environment variables from systemd-environment-d 933ccbf Fixed typo 9c9a33a Added support for unsupported GPU Changes in i3-wm: # b85da284 release i3 4.22 Changes in regolith-look-default: # d1f8351 Update upstream theme package for lunar 403c89a Remove i3 from wm filename 57af57f Refactor xres namespace to be x11 agnostic. i3-wm -\u0026gt; wm Changes in regolith-look-extra: # e7c9247 Remove i3 from wm filename 8076d02 Refactor xres namespace to be x11 agnostic. i3-wm -\u0026gt; wm ad3ec5f Lighten borders of inactive/unfocused tabs d33d503 Add README placeholders for testing workflow 7d78827 Style unfocused/inactive tabs the same way as inactive workspaces 0f88ed5 Revert change to original theme palette 67c946e Use darker color for nord base02 cbfd4e6 Cleanup deprecated picom options a6ea33d Misc tweaks to extra looks Changes in i3-next-workspace: # fc40c1f Relax search on workspace name to work with Regolith 3.0 Changes in regolith-i3xrocks-config: # e70a24b fix(keyboard-layout): open keyboard menu instead (#145) Changes in regolith-desktop: # e44a757 Update dependencies for support of x11 and wayland (#812) 291c3be Version bump for next release Changes in regolith-ftue: # 017a50b Update sig for build Changes in regolith-compositor-picom-glx: # 0d7ad22 Remove deprecated picom options Changes in ilia: # 86f5694 Bump version to sync w/ jammy branch b8ea9d6 add keybings to help 5e096d6 add missing vim keybinding to navegation fe91a57 Fix all page mode curor navigation. 490ef9e Fix inconsistent widget focus init with new page function. bd977ec Remove async app loading for https://github.com/regolith-linux/ilia/issues/51 Changes in regolith-rofication: # 399b528 Remove wm dependencies for wayland support Changes in regolith-wm-config: # cbe6f87 fix: incorrect arguments to hide_cursor 7b3149b fix: add missing control entry for regolith-sway-unclutter 7ce2e40 fix: add missing .install file for regolith-sway-unclutter cf333da fix: XF86AudioPrev didnt play the previous track e36deff Remove duplicate \u0026quot;Shift\u0026quot; 59d2dba Add regolith-sway-polkit to depends ed5ccfa Packaging changes 88cca6b Fix gtklock binding not working when wallpaper not set 7d7550c Added regolith-sway-gtklock to recommends of regolith-sway-root-config 702d92d Remove unknown information fields 4ed1662 Added config for regolith-sway-audio-idle-inhibit 4f8c2e5 Fix typo e42d548 Add expected packages to recommends 3a11528 Removed redundant variable initialization c943500 Add locked flag to some keybindings 447498c removed self-conflict and self-replace for regolith-wm-control-center e437d32 Added packages to regolith-sway-root-config 'Recommends' 8ca9ab3 Updated package version 11a12bf Replace source package regolith-i3-config with regolith-wm-config f258e51 Remove regolith-wm-session dependency from regolith-wm-config binary package fc23d0c Fixed workspace names on initial load, sway 9117eeb Config fixes 5b9b7fe Fixed packaging daebaf4 Updated sway/config.d/81_gsd_integrations and added regolith-powerd as dependency 6b1e430 Exec regolith-powerd on wm_startup, regolith-displayd 324da56 Added config partial for gtklock 01127a5 Add config partials and i3status-rust config 46d09bb Fixed dependencies 9bf981f More whitespace cleanup in debian control b81cde0 Debian package fixups. Add changelog entry c02c847 Renamed conf.d directories to config.d f31cd23 Added packages to configure sway session 1905f46 Changed variable naming for sway configs ccf73eb Add root config files and packages for the root config files for i3 and sway. 01b139c Update file packages based on feedback from PR. d89da22 Initial import of debian and wm config from legacy regolith-i3-config repo 09fd304 Initial commit from regolith-i3-config "},{"id":9,"href":"/docs/using-regolith/basics/","title":"Basic Usage","section":"Using Regolith","content":"Usage # Launch an Application # After the first login, the screen will contain a bar at the bottom and some keyboard shortcuts in a dialog. This dialog, ilia, provides assistance for finding keybindings for various actions in the desktop environment. It may be dismissed with the esc key and invoked again with super shift ? . To launch an application, press super space and a similar dialog will load with 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 those that match. You can also scroll through the list with the arrow keys.\nNavigate to a Window # 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\u0026rsquo;s containing workspace and set its focus.\nCreate a new Workspace # Workspaces (also known as \u0026ldquo;virtual desktops\u0026rdquo; in some desktop environments) are a primary way by which windows can be managed. Each workspace provides a screen for an independent set of windows. To create or navigate to an existing workspace, specify it\u0026rsquo;s index with keys super 0-9 .\nFind 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. Pressing enter on a selection will cause the file to be invoked with the xdg-open command.\nTerminal # The terminal is a special application that has its own keybinding, super enter .\nBrowser # The preferred browser is also special and can be launched with super shift enter .\nQuit an Application # super shift q will quit the focused application. For misbehaving apps, super alt q will force quit (kill) the focused application, but note that any unsaved data may be lost.\nSwitch 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.\nWorkspaces can also be paged forward and backward via super tab and super shift tab .\nConfiguring the System # The Settings app (also known as regolith-control-center) is the primary interface for common configuration tasks, such as 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 Regolith Settings app.\nView Keybindings # All keybindings used by the Regolith desktop can be viewed, sorted, and executed by ilia. This dialog is launched with super shift ? .\nManage Notifications # Regolith\u0026rsquo;s desktop notification system is designed to prevent pop-ups that may distract the user from their work. Notifications can be viewed and managed in ilia via super n . Specific keybindings such as deleting one or groups of notifications may be found on the help tab of the dialog. For users wishing for more visibility of current notifications, the status indicator i3xrocks-rofication may be installed via the system package manager. This will show the number of critical and normal unread notifications on the bar.\n"},{"id":10,"href":"/docs/reference/Releases/regolith-2.2-release-notes/","title":"2.2 Release Notes","section":"Releases","content":"Regolith 2.2 is a minor release focusing on bug fixes and Ubuntu 22.10 support.\nNew Features # Ubuntu 22.10 (kinetic) support Wallpaper may be changed in regolith-control-center on Ubuntu Kinetic and Debian Bookworm. Bug Fixes # i3-swap-focus now available as released in 2.1 Numerous fixes and polish added to ilia Known Issues # No localization for ilia Changelog Delta from Regolith Desktop 2.1 to 2.2 # Changes in regolith-session: # 0ce56b5 Remove no longer shipped file eb699d6 Depend on virtualized config ui package c15ced1 Move default ui packages from default look to flashback session since default doesn't need to be installed 82424f8 Revert changes to Xsession. Due to field variance ilia will manage app path list external to XDG_DATA_DIRS 7262b91 Consistently specify search path for xres loading 0047f4d File checks allow symlinks. Address https://github.com/regolith-linux/regolith-desktop/issues/732 Changes in i3-wm: # 39afa033 release i3 4.21.1 Changes in i3-gaps-wm: # a8546a08 release i3-gaps 4.21 Changes in regolith-i3-config: # 7c0663c Fix dep decl for retired package 321220f Virtualize control center bindings to support both upstream and regolith-control-center 9acba1a Add work around for border issue https://github.com/i3/i3/issues/5149 72045f8 Add padding to workspace indicator on bar for simple looks 7865f93 Simplify font spec in i3 workspace label. Allow xres override of bar font to address https://github.com/regolith-linux/regolith-desktop/issues/730 b1cf838 Allow resize increment to be specified via xres. Address https://github.com/regolith-linux/regolith-i3-config/issues/11 3deafab Change float modifier due to change in gtk4 cfe26d7 Fix keybinding comment for swap focus Changes in regolith-look-default: # 2f1ab33 Add border around ilia dialog for better contrast c2cb660 Remove recommends from default, moving upstream so avoid issues when users do not opt to install the default look 0577cbe Simplify font spec in i3 workspace label. Allow xres override of bar font to address https://github.com/regolith-linux/regolith-desktop/issues/730 deba53b Add conflicts to prevent package install failure ff98eb4 Decompose look and loader script for cleaner dependency. Use virtual package for resource loading to generalize between x11 and wayland 1942cee Added support for wayland Changes in regolith-look-extra: # 3c35ea5 Add border around ilia dialog for better contrast fa39ffe More color mapping fixes e5e786b Fix missing color specs add5508 Simplify font spec in i3 workspace label. Allow xres override of bar font to address https://github.com/regolith-linux/regolith-desktop/issues/730 408fa51 Cleanup dependencies to default look f3da9b9 Fix package metadata for regolith-look-2 virtual package, found by Matt Fischer c3076f0 Make gruvbox i3xrocks values a brighter color e0e049a Fix paths to compositor a7018ec Decouple picom from looks. relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 f70c4de Remove picom as a dependency of Nord and Nevil looks 632c175 updated Debian package metadata to install moka-icon-theme 1287be9 Add missing regolith-look-ayu-mirage look to debian packaging Changes in i3-next-workspace: # e886bf5 Predicate list building on presence of seperator character. Attempt building from anon workspace Changes in regolith-i3xrocks-config: # c524c6e Remove floating flags for gtk4 breaking change in regolith-control-center 963c2b8 Add scrolling as inputs to media-player (#141) 425fe9e Try to use bluetooth device alias instead of name (#142) f3e9e48 Depend on netcat-openbsd due to bsd specific options used. Address https://github.com/regolith-linux/regolith-desktop/issues/635 e7d7c3f volume: extract toggle, volume_up, volume_down functions for easy rebinding (#140) 7ec4e6c Exit 0 if network device unfound to avoid spamming logs 659f13e Fixed volume and microphone mixer_value to display values below 10 and (#137) 2d09694 Rename install file for tailscale (#138) Changes in regolith-ftue: # b8255d6 Add missing dependency Changes in regolith-compositor-compton-glx: # 7980eb1 Allow config to be specified by Xres. Relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 Changes in regolith-compositor-picom-glx: # ee673f1 Allow config to be specified by Xres. Relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 Changes in ilia: # fe610d8 Fix unicode support in tracker 936ef27 Fix all page mode cursor navigation 1634bfc Fix inconsistent widget focus init with new page function 1359f9b Remove async icon loading to fix intermittent missing icons. 0612d2c Revise app launch logic based on available APIs on focal bb5549e Implement emacs and vim key nav. Misc cleanup f9defff Add version param 27b4682 Refactor app launching to use a context to track launch status. 0ed7873 Add slight border to window in cases where background does not provide contrast 164b0a6 Experimental change to app dialog to delegate to glib for desktop app source. Better local performance 3a8ced2 Follow symlinks to desktop apps. Misc cleanup 881358d Add flatpack dir to scan for desktop apps to address https://github.com/regolith-linux/ilia/issues/49 675c63d Add snap app dir to default paths to enable firefox to be found on kinetic d1573ff Update version in build. Do not sort textlist entries. Add flag for no icon in textlist. 6e4de4a Update selection logic to address https://github.com/regolith-linux/ilia/issues/44. Misc cleanup 4683479 Simply use URI to launch selected app from tracker page. Address https://github.com/regolith-linux/regolith-desktop/issues/716 f9eacc0 Move from XDG_DATA_DIRS to dconf source for desktop app paths f1dd370 Ignore i3bar explicitly with looser filter d151347 Include windows in window list containing empty value for 'window_type'. Addresses https://github.com/regolith-linux/ilia/issues/43 753160d Close dialog on selection for tracker page. exit regardless of error state in desktop app and tracker pages. Address https://github.com/regolith-linux/ilia/issues/39 Changes in xrescat: # bd6a6cb Add virtual package regolith-resource-loader for future wayland support "},{"id":11,"href":"/docs/using-regolith/configuration/","title":"Configuration","section":"Using Regolith","content":"Recommended Packages for New Users # Looks # Install all of the official Regolith looks:\nsudo apt install regolith-look-* Alternatively, apt will list available looks that may be installed:\napt list | grep regolith-look- NOTE: this may pull in fonts, themes, and wallpapers. For users looking to minimize disk usage, uninstalling looks that are unused is recommended.\nSee below for details on how to select a look.\nStatus Indicators # The following snippet installs status indicator packages recommended for new users:\nsudo apt install i3xrocks-focused-window-name i3xrocks-rofication i3xrocks-info i3xrocks-app-launcher i3xrocks-memory To remove any of these indicators later, simply uninstall them from your system. Example:\nsudo apt remove i3xrocks-info Laptop Battery Status # View the current battery status on a laptop:\nsudo apt install i3xrocks-battery Compositors # Compositors add visual effects to the windowing environment. By default, Regolith 3 installs the picom compositor. Users experiencing graphical issues due to specific hardware or driver limitations may want to install one of the following compositors instead:\n Package Notes regolith-compositor-picom-glx Default regolith-compositor-compton-glx An older compositor that may work better on some hardware regolith-compositor-xcompmgr An older compositor that may work better on some hardware regolith-compositor-none A pass-through package that does not run a compositor See this How To for more details.\nWallpaper # Most Regolith Looks provide a default desktop color or image. The wallpaper can be set by specifying the path to the wallpaper image via the Xresources key regolith.wallpaper.file.\nExample, assuming the file /usr/share/backgrounds/hardy_wallpaper_uhd.png is present:\necho \u0026quot;regolith.wallpaper.file: /usr/share/backgrounds/hardy_wallpaper_uhd.png\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh To change the image treatment (zoom, scale, etc.) of the wallpaper image, set regolith.wallpaper.options. Options are: none, wallpaper, centered, scaled, stretched, zoom, spanned\nExample:\necho \u0026quot;regolith.wallpaper.options: zoom\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh To specify a color rather than an image use the Xresource key regolith.wallpaper.color.primary:\necho \u0026quot;regolith.wallpaper.file: \u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.primary: blue\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh To specify a secondary color and gradient:\necho \u0026quot;regolith.wallpaper.file: \u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.primary: blue\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.secondary: green\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.shading.type: vertical\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh Lockscreen Wallpaper # The lockscreen wallpaper can be managed in the same way as the desktop wallpaper. The keys are the same as desktop wallpaper, but with lockscreen prefixed to wallpaper, like so: regolith.lockscreen.wallpaper.... For example, to specify a lockscreen image:\necho \u0026quot;regolith.lockscreen.wallpaper.file: /usr/share/backgrounds/hardy_wallpaper_uhd.png\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh Disable Wallpaper handling # If you wish to manage wallpaper externally to Regolith, simply specify empty values for wallpaper image and color:\necho \u0026quot;regolith.wallpaper.file: \u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.primary: \u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources Status Bar Indicators # Status indicators such as CPU load, date and time, notifications, weather, and other system info can be added or removed by installing packages. For example, to show a status indicator for your laptop battery, simply run sudo apt install i3xrocks-battery and then refresh the session using regolith-look refresh. To find what indicators are available, run apt search ^i3xrocks- or search for i3xrocks- in your favorite package manager GUI, such as Synaptic. There is more documentation available for configuring status indicators, also called \u0026ldquo;blocklets\u0026rdquo;. Here is a table of status indicators as of Regolith 2.2:\n Package Status Function i3xrocks-app-launcher Shortcut to app launch dialog i3xrocks-battery Battery status i3xrocks-bluetooth Bluetooth status i3xrocks-cpu-usage CPU utilization i3xrocks-disk-capacity Disk utilization i3xrocks-focused-window-name Title of focused window i3xrocks-info Shortcut to Keybindings viewer i3xrocks-key-indicator Keyboard toggle status i3xrocks-keyboard-layout Keyboard layout i3xrocks-media-player Media player status i3xrocks-memory Memory utilization i3xrocks-microphone Microphone status i3xrocks-net-traffic Network status i3xrocks-next-workspace Shortcut to create new workspace i3xrocks-nm-vpn VPN status i3xrocks-openvpn OpenVPN status i3xrocks-rofication Notification status i3xrocks-tailscale Tailscale status i3xrocks-temp System temperature i3xrocks-time System time i3xrocks-updates System package status i3xrocks-volume Audio volume status i3xrocks-weather Local weather i3xrocks-wifi Name of connected wifi AP Looks # Colors, wallpaper, window and bar layouts and other visual factors are bundled together in Regolith and called \u0026ldquo;looks\u0026rdquo;. Looks provide a simple way of changing the entire look of the desktop. Like status bar indicators, looks are packaged and are installed and removed like any other software package. By convention, Look packages use the following naming format regolith-look-\u0026lt;name\u0026gt;. apt or a GUI package manager can be used to search for available looks. To select an installed look the keybinding super alt l presents a dialog:\nAlternatively, the terminal command regolith-look can be used to change looks and refresh the active session with the selected look. Here\u0026rsquo;s an example that switches to the gruvbox look:\napt search ^regolith-look- [...] regolith-look-gruvbox/unknown,now 0.4.6-1regolith amd64 [...] sudo apt install regolith-look-gruvbox regolith-look set gruvbox regolith-look refresh To simply install all available looks:\nsudo apt install regolith-look-* i3 Features # Starting with Regolith 2.0, many aspects of i3 configuration are managed via the package manager. Regolith provides all of its i3 configuration via \u0026ldquo;config partials\u0026rdquo;. These packages install their i3 config partials into /usr/share/regolith/i3/config.d. By installing and removing packages, i3 configuration can be customized for specific preferences. By default, when the regolith-desktop package is installed, these configuration elements are also installed as soft dependencies:\n Package Function File regolith-i3-base-launchers Launch terminal and browser /usr/share/regolith/i3/config.d/15_base_launchers regolith-i3-default-style Window behavior /usr/share/regolith/i3/config.d/40_default-style regolith-i3-navigation Navigation keybindings /usr/share/regolith/i3/config.d/30_navigation regolith-i3-networkmanager Network and wifi functions /usr/share/regolith/i3/config.d/88_network-manager regolith-i3-next-workspace Workspace utility /usr/share/regolith/i3/config.d/40_next-workspace regolith-i3-resize Resize keybindings /usr/share/regolith/i3/config.d/50_resize-mode regolith-i3-session Session keybindings /usr/share/regolith/i3/config.d/55_session_keybindings regolith-i3-unclutter Hide mouse cursor when unused /usr/share/regolith/i3/config.d/86_unclutter regolith-i3-user-programs Optionally launch user programs specified in Xresources /usr/share/regolith/i3/config.d/90_user-programs regolith-i3-workspace-config Workspace keybindings /usr/share/regolith/i3/config.d/40_workspace-config Soft dependencies can be removed without causing packages that depend upon it to be removed. This means that any of the listed packages can be removed. Users can make tweaks to configuration in a more stable manner by replacing a default configuration partial with their own version. This can be achieved by copying the partial to be customized into ~/.config/regolith3/i3/config.d/ and removing the original file in /usr/share/regolith/i3/config.d via apt. In this way, the unmodified config partials can continue to get updates and bug fixes without impacting user-specific configuration.\nSee the i3 configuration customization how-to for examples.\nAll i3 Configuration Packages # The following contains a list of all i3 configuration packages available in Regolith 2.1:\n Package Function File regolith-i3-base-launchers Launch terminal and browser /usr/share/regolith/i3/config.d/15_base_launchers regolith-i3-compositor Compositor integration (delegates to regolith-compositor-\u0026lt;variant\u0026gt;) /usr/share/regolith/i3/config.d/80_compositor regolith-i3-default-style Window behavior /usr/share/regolith/i3/config.d/40_default-style regolith-i3-ftue First time user experience /usr/share/regolith/i3/config.d/84_ftue regolith-i3-gaps-partial i3-gaps configuration (if installed, i3-gaps will replace i3) /usr/share/regolith/i3/config.d/35_i3-gaps regolith-i3-gnome Regolith Settings keybindings /usr/share/regolith/i3/config.d/60_config_keybindings regolith-i3-i3xrocks i3 bar status indicators configuration /usr/share/regolith/i3/config.d/70_bar regolith-i3-ilia ilia integration /usr/share/regolith/i3/config.d/20_ilia regolith-i3-navigation Navigation keybindings /usr/share/regolith/i3/config.d/30_navigation regolith-i3-networkmanager Network and wifi functions /usr/share/regolith/i3/config.d/88_network-manager regolith-i3-next-workspace Workspace utility /usr/share/regolith/i3/config.d/40_next-workspace regolith-i3-remontoire Legacy keybindings view integration /usr/share/regolith/i3/config.d/45_remontoire regolith-i3-resize Resize keybindings /usr/share/regolith/i3/config.d/50_resize-mode regolith-i3-rofi Legacy desktop launcher integration /usr/share/regolith/i3/config.d/20_rofi regolith-i3-rofication Legacy notification viewer integration /usr/share/regolith/i3/config.d/82_rofication regolith-i3-rofication-ilia Notification viewer integration /usr/share/regolith/i3/config.d/82_rofication-ilia regolith-i3-session Session keybindings /usr/share/regolith/i3/config.d/55_session_keybindings regolith-i3-snapshot i3 workspace persistence /usr/share/regolith/i3/config.d/75_i3-snapshot regolith-i3-swap-focus Toggle back to last focused window /usr/share/regolith/i3/config.d/40_i3-swap-focus regolith-i3-unclutter Hides mouse when not in use /usr/share/regolith/i3/config.d/86_unclutter regolith-i3-user-programs Optionally launch user programs specified in Xresources /usr/share/regolith/i3/config.d/90_user-programs regolith-i3-workspace-config Workspace keybindings /usr/share/regolith/i3/config.d/40_workspace-config Keybindings # Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. The most common keybinding change is the super key. Regolith uses Xresources as the canonical source of truth for settings, which are read by various UI components. The table of Xresources keys open to user configuration is available elsewhere. To change the default super binding from the \u0026ldquo;windows\u0026rdquo; key to \u0026ldquo;alt\u0026rdquo;, add the following line to the file ~/.config/regolith3/Xresources:\nwm.mod: Mod1 wm.alt: Mod4 Note: GNOME also has its own set of keybindings. When the Regolith session is first initialized, the conflicting GNOME keybindings are removed from the user settings. GNOME keybindings can be managed in the Regolith Settings app.\nSystem Management # The regolith-control-center app is the tool to configure locale, date, displays, networking and various other settings. Launch it via the app launcher with super space , type settings, and hit enter to launch the app. The direct keybinding is super c . The application may also be launched from a terminal with command regolith-control-center.\nFurther Reading # To dig deeper, find which Howtos are available, or read the Xresources reference. Become an i3 power user by reading their user guide.\n"},{"id":12,"href":"/docs/howtos/","title":"How To","section":"Docs","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. 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\u0026rsquo;d just like to refresh your memory, this guide from Ubuntu is recommended. Another tutorial from linuxcommand.org goes into some more advanced territory.\ni3-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.\n"},{"id":13,"href":"/docs/reference/Releases/regolith-2.1-release-notes/","title":"2.1 Release Notes","section":"Releases","content":"Regolith 2.1 is a minor release including several improvements, bug fixes, and optimizations.\nNew Features # Regolith Linux 2.1 ISOs (based from Ubuntu 22.04) Looks dracula, ayu, ayu-dark, ayu-mirage, i3-default, and lascaille added Looks can be loaded from user directories (~/.config/regolith3/looks) i3-swap-focus is now available. Navigate to last window with keybinding \u0026lt;super\u0026gt; . Bug Fixes # Ilia\u0026rsquo;s file search dialog was broken on Jammy, this has been fixed PtrSc hotkeys working as in 1.6 Numerous small fixes listed below Known Issues # No localization for ilia Inconsistent GTK theme in some dialogs in Jammy (gnome-flashback fix in progress, will be available from Ubuntu repos) Bug Fix Releases # 2.1.1 # The Regolith Linux ISO was rebuilt as 2.1.1 due to a packaging mistake. The md5sum that may be used to verify the download was incorrect. The 2.1.1 release fixes this by including the correct md5sum file. While the 2.2.1 ISO was freshly built, it includes no package changes over 2.1.\nChangelog Delta from Regolith Desktop 2.0 to 2.1 # See the GitHub 2.1 release for additional details.\nChanges in regolith-lightdm-config: # b8d4503 Add attribution for NASA Juno image fdbd150 Switch to Papirus icon theme. Set regolith as default session. 0910bd8 Add all configuration items to slick-greeter file e95bd47 move from gtk greeter to slick. Update background Changes in regolith-session: # d1e21b9 Remove old look comment declarations d2bee02 Add ability to stage looks in user directory ~/.config/regolith3/looks ac6eb70 Check if user's directory does not exist before appending Changes in i3-wm: # 937549f2 Merge tag '4.20.1' Changes in i3-gaps-wm: # b451b2a6 Merge tag '4.20.1' Changes in regolith-i3-config: # 3f12389 Package changes 1e4f88c Switch to super-. for swap-focus based on user feedback c5b43ff Package changes 6881ba4 Switch swap-focus to easier keybinding 6ab7598 Package changes 47c0545 Fix copypasta in i3-swap-focus dff03ff Package changes 7f9ae0b Add new integration i3-swap-focus 647a658 Package changes d7aeb82 Merge pull request #6 from jjsearle/default-border-style-option df223f1 allow titlebar to be enabled via Xresources Changes in regolith-look-default: # 3fba280 Reduce dependencies in default look, conform to adwaita 24ffab7 move to hicolor icon theme for default to reduce overhead c187a2f Use colors in workspace labels 06841a8 Set titlebar style settings 589b264 Specify glyph for app laucher. Better glyph for help Changes in regolith-look-extra: # e0e049a Fix paths to compositor a7018ec Decouple picom from looks. relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 1d33fb1 Merge pull request #8 from mfisher87/consider-picom-deps 210c2d3 Merge pull request #6 from regolith-linux/nevil-icon-theme-default-switch f70c4de Remove picom as a dependency of Nord and Nevil looks 632c175 updated Debian package metadata to install moka-icon-theme 1287be9 Add missing regolith-look-ayu-mirage look to debian packaging 13d125d Update looks to include lockscreen settings 17afcb7 Port lascaille from default look 7b5fb2e Add i3-default look 8ac4b27 Add window border styles to existing looks 883e434 Changed default nevil icon theme to Moka 493c746 Update workspace glyph icons across a few looks for more flair b63b75a Add Ayu, Ayu-Mirage \u0026amp; Ayu-Dark a600730 Specify glyph for app laucher. Better glyph for help b3e6295 Add dracula look by @jjsearle 92f844a s/nord/nevil in composer-init Changes in i3-swap-focus: # c04ad13 Fixes for newer deb build tools ccb5ce6 Add debian packaging Changes in regolith-i3xrocks-config: # 11c7516 replace reboot command with saner default (#134) 086d0a2 Add control entry for i3xrocks-update 1d09bb8 Add tailscale IP (#132) 7f70e0a Add support for wireguard interface/tunnel (#118) 38da9e1 Add support to temp script for Tctl (#124) 0fe5a12 Remove extra space in output (#130) e06b955 Add updates block (#131) 56ed590 move dynamic block window-name to the left-most position due to horizontal variance ce6cebd Remove unneeded script for app launch action 86abc8c Load ilia over remontoire for help action d400913 Adding a fix to not show anything on empty workspace (#129) 25fd18d Add support for bond interface in net-traffic (#128) Changes in regolith-compositor-compton-glx: # 7980eb1 Allow config to be specified by Xres. Relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 Changes in regolith-compositor-picom-glx: # ee673f1 Allow config to be specified by Xres. Relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 Changes in ilia: # 84687f2 Sync project versions 149d4e6 Filter on both summary and keybinding text in keybinding page to address https://github.com/regolith-linux/ilia/issues/34 eaf40b6 Revert to using x-terminal-emulator over gdk in support of https://github.com/regolith-linux/ilia/issues/31 156d478 Clean up page key event handling. Exit on system key events to address https://github.com/regolith-linux/ilia/issues/24 c0e4bd1 Fix double filtering in tracker page. Address https://github.com/regolith-linux/ilia/issues/23 3948bc8 Cleanup icon handing across pages. Fix icon handing for window view 52d350c Read floating node members of i3 tree response. Addresses https://github.com/regolith-linux/ilia/issues/21 64943d8 Remove unused dependency, causing errors on ISO release 157df07 Remove default sorting of items from textlist page Changes in regolith-default-settings: # 366893e Update default settings to match default look Changes in remontoire: # ab00f14 Fix version returned by program to match package version Changes in plymouth-theme-regolith: # b14a39f Use final logo image "},{"id":14,"href":"/docs/reference/Releases/regolith-2.0-release-notes/","title":"2.0 Release Notes","section":"Releases","content":"Regolith 2.0 is a major release with some breaking changes to looks and i3 configuration, and includes several improvements and optimizations.\nNew Features # Adding Debian Bullseye to the list of supported OS\u0026rsquo;s including Ubuntu Focal and Jammy. The desktop UI component rofi was replaced with desktop executor designed specifically for Regolith: ilia. The desktop UI component gnome-control-center was replaced with a settings app designed specifically for Regolith: regolith-control-center. The Regolith i3 config file has been destructured into partials and packaged to provide better configuration management. The Regolith Look XResource scheme has been updated to be simpler, more flexible, and consistent. The keybindings viewer remontoire was replaced by ilia to provide better support for keyboard-driven workflow and easier searching. Regolith supports both i3 and i3-gaps based on user preference. Fonts from the open source project Nerd Fonts have been packaged for Regolith, simplifying font management. A command-line utility for managing notifications, lago is available. A command-line utility for collecting Regolith diagnostic info, regolith-diagnostic is available. Usability Fixes # Alt and Super can now be swapped easily with an Xresources override. Alternate languages can be selected from in the desktop executor. regolith-control-center prevents some pop-ups from being hidden and locking UI Known Issues # No localization for ilia Changelog Delta from Regolith 2.0 Beta 3 to General Release # Changes in regolith-session: # 1061f67 Re-apply user Xres after look is applied. Resolves https://github.com/regolith-linux/regolith-desktop/issues/644 Changes in regolith-i3-config: # e25d88c Add missing newlines at end of config files from @buck10 da5615f Add conflicts relationship between ilia and rofi i3 config 244547e Add descriptions for bin packages a11ff93 Allow look-selector icon to be overridden. Specify better default icon Changes in regolith-look-default: # fa7fb24 Update ilia CSS style 659d545 Add docs to Xresources Changes in regolith-look-extra: # d7b784b Update ilia CSS style bc88936 Fix look descriptions fd84e99 Fix incorrect path to ilia css Changes in regolith-i3xrocks-config: # b35690d fixed xml escaping (#127) Changes in ilia: # fa548a8 Remove hard code style. Squelch right-click context menu to avoid hang. 9ed0020 Extract hard coded style to CSS 16d088b Add rofi reference 05dcaee Fix code sections 018deb4 Updates to readme for release Changes in regolith-control-center: # e85c3ced1 Fix crash on power panel (jammy only) 6a584746b Update regolith logo from final revision Changelog Delta from Regolith 2.0 Beta 2 to Beta 3 # Changes in regolith-session: # 87919c5 Revert strategy that creates merged Xresource. Simplify by just loading one override or using default look. Looks become top-down definitions of UI, and bottom up extension model deprecated. 975c542 Cleanup Changes in regolith-i3-config: # 4d0d5b2 polish look selector ui Changes in regolith-look-default: # 557d76d Add lockscreen wallpaper functionality Changes in regolith-look-extra: # 8c211ba Package changes b8188d3 Visual tweaks to nevil Changes in regolith-ftue: # ce16a93 Use stylesheet for proper font rendering on ftue help Changes in ilia: # 4512ba1 Add separator between category and action in keybindings view b8373fd Exit if super pressed to prevent blocking i3 85f7041 Fix warning in socket close a870a2b Better icon for window page 647b1bb Add missing dependency e2c19c1 Update textlist to render icons fb59b13 Plumb cmdline args to each page via DialogPage. Add title and icon parameters for TextList customization b83fbcb Update dialog resize keys to use alt to allow keyboard entry. Specify max bounds of window size when possible. Changes in regolith-control-center: # 3eb9dea29 Re-add some install files for shortcuts and gschema Changelog Delta from Regolith 2.0 Beta 1 to Beta 2 # New light look: regolith-look-nevil Updated wallpaper for regolith-look-nord and regolith-look-gruvbox by @GMFranceschini Ilia now has multi-tab mode Ilia launches app from notification Changes in regolith-session: # f57f66b Add script to collect diagnostic info for troubleshooting 4494e68 Fix broken refresh logic after Xres file change introduced in previous version cdaa330 Fix regolith look update logic to write to Regolith-specific Xresource file Changes in regolith-i3-config: # 406b428 Add docs about config partials 521016c Add OR dependency on i3-gaps-wm to resolve packaging issue found on Bullseye a6b6fea Load all pages in ilia when users load the keybindings dialog 0f6a018 Add networkmanager, next-workspace, and unclutter as soft dependencies 7921136 Require i3-gaps version with config partials in regolith 2 a2390bd Require i3 version with config partials in regolith 2 2711991 Fix typo of new mapping for Xres mono font to i3 bar font 1238b4a Fix typo of new mapping for Xres font to i3 font Changes in whitesur-gtk-theme: # cc591d7 Initial commit. Built from release 2022-02-21 Changes in regolith-look-default: # fcb288e Default terminal profile update to true c849879 make the check for invalid path to wallpaper more robust 5c2c402 removed left-over bracket ca61239 fixed regression in #2 + fixed other possible bug ad6691b Merge pull request #2 from georglauterbach/main c9df3c7 updated `default_loader.sh` | style, formatting \u0026amp; refactoring Changes in regolith-look-extra: # 2e700f0 Use new wallpapers from GMFranceschini in nord and gruvbox looks a2ca36b Fix dependency 5c7f3ed Tweaks and fixes to nevil ec1a158 Add nevil look 429863c Add updated solarized-dark look 3511556 Give rounded corners to Nord w/ custom picom config. Misc tweaks f1e0088 Specify ilia stylesheet in all looks Changes in regolith-i3xrocks-config: # 0b12b5a Use /proc/net/route for interface detection (#126) Changes in regolith-ftue: # e155b96 Remove unneeded sleep and launch shortcuts in all page mode Changes in ilia: # 91e74dd Update docs ab57873 Add page keybindings in all-page mode 050eac7 document page interface e5e8a5a Add option -a for all page mode to address https://github.com/regolith-linux/ilia/issues/17. Misc cleanup cc80bc3 Fix icon in files page a2f29f0 Change label to 'Commands' from 'Terminal' 3df2ca9 Add ability to launch host app to address https://github.com/regolith-linux/ilia/issues/18. Fix icon loading of notification view. d451b54 Minor simplification to command launching Changes in regolith-control-center: # 1be590f260444f80661db29d2566f072b5b69300 Remove unused power_saver_low_battery option in power panel 8310cf2bdd8463ce90b0e33f3f0aeffa8f76f3d4 Remove battery percentage toggle 0caac0d47 Update logo Changelog Delta from Regolith 1.6 to Regolith 2.0 Beta 1 # Changes in regolith-lightdm-config: # 8a0d5c7 Switch font from jetbrainsmono to dejavusansmono 3eac0ff Update dependencies for Regolith 2 Changes in regolith-session: # a939fad UI refresh logic moves to looks cd72a50 gnome Xresource moves to looks 4f67559 Add Xsession file to add user desktop app dir to XDG_DATA_DIR to enable ilia to index desktop files there e3c83d5 Remove unimplemented 'stage' command. Misc cleanup 79cb6b1 Fix font spec from i3 to gnome f776087 Only set gnome theme properties if defined by xres 870303f Set gnome interface font from look during refresh 9a9d98f Fix reference to term profile script and add soft dep to address problem in https://github.com/regolith-linux/regolith-look-extra/pull/1. 0ef3f55 Re-apply root Xresources after regolith Xres to ensure user values are set a844012 Create new virtual package 'regolith-look-2' to specify a look. Version bump for cleaner upgrades from 1.x d4bec14 Test that wallpaper file exists before setting 5c78271 Move Xresources.d from /etc to /usr/share/regolith due to apt policy issues with files in /etc. 2612147 Add breaking package from Regolith 1.6 due to file conflict 3a6b087 Fix sessoin init issue reported in https://github.com/regolith-linux/voulage/issues/2 c24ed0d Move to regolith2 config dir db8953b Fix session init bug with invalid look path root e89a150 Several bug fixes for Regolith 2 Xresource merging/loading daf7368 Extract common session logic to lib file. Fix regolith-look refresh and list 5f54d14 Add user defined post logoff script 614f6e3 Import regolith-look script from deprecated package regolith-styles. Add build automation. 06f8c79 Fix path to renamed default look eb85712 Depend on updated look package, add virtual look package. Changes in regolith-i3-config: # 96c4762 Decompose navigation, workspace config, and base launchers from i3 config file. Misc fixes cf78c9d Add ability to specify custom stylesheet to ilia 8cad4c9 Remove unneeded dep from i3-gaps to i3-snapshot. Cleanup f8aec01 Remove session, resize, and user programs from hard dependencies in i3 config 0b7aa04 Extract i3 style config to optional partial fa0e452 Allow resize mode keybinding to be overridden to address https://github.com/regolith-linux/regolith-desktop/issues/627 967fb85 remontoire and ilia keybindings conflict because they both specify help. Set 'conflicts' in debian accodringly. Addresses https://github.com/regolith-linux/regolith-desktop/issues/628. 09eb0e2 Add label for gaps 72af37e Move i3 partials from /etc to /usr e58e1d7 Move i3xrocks conf.d from /etc to /usr/share/regolith due to apt policy issues with files in /etc. aa1ff5c Migrate from gnome-control-center to regolith-control-center 2b4e580 Fix ftue dependency 64fd601 Add breaking package from Regolith 1.6 due to file conflict cdbb722 looks will host i3wm xres files, not here fd0974e Move to regolith2 config dir 8e50f48 Add '--no-startup-id' when exec launchers 72a3636 Conditionally apply i3 xresources, allowing looks to override b9072d5 Make rofi and ilia versions of rofication ui mutually exclusive bf61321 Add seperate rofications for rofi and ilia front ends 1c23f65 Update alt variable to always occur on lhs due to i3 variable expansion constraints. Related to https://github.com/regolith-linux/regolith-i3-gaps-config/pull/39 486151b Use ilia for look selector 118f557 use var for alt rather than hardcode. based from https://github.com/regolith-linux/regolith-i3-gaps-config/pull/39. 5880f98 Remove i3-next-workspace from common config 641f9d3 Switch to ilia for rofication UI 09765da Add all next-workspace bindings 6384067 add configurable workspace movement, from https://github.com/regolith-linux/regolith-i3-gaps-config/pull/37. 22815c6 Add keybinding viewer (ilia), replacing remontoire 73fda78 Add ilia i3 config ac206fc Consolidate some partials to handle variable access limitations w/ i3 partials d17ee44 build automation 2c5091f Update partials for i3 4.20 Changes in regolith-look-default: # 422a36b Specify custom stylesheet for ilia to fix Debian issue with incorrect font used in keybindings view 68041dc Wallpaper fixes to default loader. Misc tweaks and cleanup 37ce868 Fix missing default_loader.sh in package 555f857 Fix bug when single background color is specified. 77d3d40 tweaks to font sizes. Fix debian control b2adcdb Refactor looks to be more consistent, own refresh logic, and better represent gtk theme elements ed8cc44 Fix typeface for volume glyph f6460f3 Create new virtual package 'regolith-look-2' to specify a look. Version bump for cleaner upgrades from 1.x 7381999 Alt char for temp 63f4fd1 Use alternate temp glphy to fix mystery ordering issue 0ccb167 Add missing icon theme dependency 5ef662a Move i3wm xres here. Fix non-active workspace color in bar 6d37a7f Fix glyphs in typeface not specified by font 1bf39d8 Update default look to use nerdfonts version of jetbrains mono. update glyphs. 5b1973b Make looks non-exclusive d778c94 Add rofication-ilia 0cc844b Switch from rofi to ilia 5cabe6e Fix gnome theme key 902a01b Add virtual package for a look 68d072b Change from minimal to default Changes in regolith-look-extra: # f1e0088 Specify ilia stylesheet in all looks efe94ba Fatter borders in gruvbox for upcoming rounded corners baaace4 Add hardy wallpaper to gruvbox. Publish gruvbox look db7f92e Fix missed mapping from gtk monospace font to bar workspacce font. Reduce blackhole font size. Assocated with https://github.com/regolith-linux/regolith-look-extra/issues/2 e572851 Add gruvbox look 7703e34 Tweaks polish and fixes to looks 066907f Sort glpyhs 67de712 Depend on default look for loader script 0ef9875 Merge branch 'main' of github.com:regolith-linux/regolith-look-extra into main 791321a Move blackhole to new Xres scheme 6944d7d Move nord to new Xres scheme b8736b0 correct description and dependencies for blackhole 9da8e9c Package @ploum look blackhole. Related https://github.com/regolith-linux/regolith-look-extra/pull/1 fdbbd77 Fix font on wifi and workspace glyph to address https://github.com/regolith-linux/regolith-desktop/issues/631 4420393 Fix font on volume indicator to address https://github.com/regolith-linux/regolith-desktop/issues/631 8c7656f Create new virtual package 'regolith-look-2' to specify a look. Version bump for cleaner upgrades from 1.x 3cddd15 More tweaks to term colors for nord 1f4bd7f Tweaks to term colors for nord 094fc90 visual refresh to nord look 9c956e1 Move nord to use nerdfonts version of sourcecodepro. Misc fixes for Regolith 2 xres 965eac1 use original i3-wm Xres def for nord. Disable gruvbox package. 4503a80 Fix def names for Regolith 2 0203187 Make looks non-exclusive e2c9a3a Remove redundant look. Add nord adapted from 1.x 2e15aa8 Add docs, changelog acb101f Initial commit. Ported from regolith-look-default Changes in regolith-i3xrocks-config: # 7b2e609 Fix typo in media player script ad20e67 i3xrocks Xresource moves into looks 9f73ef5 Specify font for both label and value after transition to nerdfonts 674e498 Fix celcius degree postfix on temp 87ab5d2 Migrate configuration from /etc to /usr/share due to problematic apt policy in /etc directories 885be5f Swap gnome-control-center for regolith-control-center e8fd320 Add missing dep on rofication block 9170923 Fix ilia launch from notification 1b24e7b Deprecate python rofication status block for shell script. Launch ilia on click by default Changes in regolith-desktop: # 2bf8c77 Push look dependencies down to regolith-look f2f4435 Fix typo in packaging, use proper symver e82a954 Revise package architecture. Remove -small desktop package, go back to single base package. 12e39b6 Regolith 2 package model adf1a53 Sync changelog to distro a7c6444 Update versioning Changes in regolith-ftue: # 6c5e76f Cleanup, better font default a7bbfbb Add delay when loading ftue keybindings view in attempt to avoid race w/ i3 config loading 820a297 Use new conf directory for regolith2 1b542ed Add missing dependency 1135876 Switch to ilia over remontoire for keybinding viewer 0be6a48 Rename term profile script for consistency eefcb55 Depend on uuid-runtime to fix debian ftue Changes in regolith-compositor-xcompmgr: # 593c3e0 Move to regolith2 config dir Changes in regolith-compositor-compton-glx: # 94cf43a Move to regolith2 config dir 6a234bf Add new name for zoom window, from https://github.com/regolith-linux/regolith-compositor-compton-glx/issues/3 454c5d6 Do not fade ilia Changes in picom: # e96a7b2 Package v9.0 release Changes in regolith-compositor-picom-glx: # 49ddcf9 Move to regolith2 config dir 2ee5b27 Add new name for zoom window, from https://github.com/regolith-linux/regolith-compositor-compton-glx/issues/3 d27bbab Do not fade ilia 9fe5b87 Update to use @Filip-K picom config from https://github.com/regolith-linux/regolith-desktop/issues/578. Changes in remontoire: # f72a575 Cleanup source formatting 96090d5 Add scrollable parent to flowbox to allow vertical scrolling of content when exceeds bounds of flowbox dc210de Don't draw scroll hints for horizontal scrolling Changes in ilia: # 8443061 Tolerate empty css override. Add class name to keybindings view b7ffa94 Numerous tweaks to help facility. Misc cleanup 6954aa1 Do not hardcode font in stylesheet 6f19ef1 Cleaner simpler approach to help content 761c5a8 Customize style via hardcoded CSS. Enable command line options for specifying css file or no styling. Misc fixes. Addresses https://github.com/regolith-linux/ilia/issues/12 and https://github.com/regolith-linux/ilia/issues/8 57b2037 Add ability to specify custom stylesheet 7ac9bda Add help feature, enabled by default f64cc2e Better error message for invalid page 6967488 Fix array size for pages 66f6127 Update heuristic to grab resources at start time (experimental) 6130e48 Use XDG_DATA_DIRS to source desktop files to address https://github.com/regolith-linux/ilia/issues/11 83081f0 Load config partials for keybindings e0a0c46 Update dev branches for automation ec11206 Only grab keyboard and mouse f5ac6f2 terminal page cleanup 0612e62 Add feature to resize dialog 499a084 Fix window launcher to close after action. Misc cleanup c4b0658 Add help flag to print all page types 9bc1b97 Add sleep after app launch to prevent intermittent failures fa5163f Retry to grab inputs if fails 47dfe97 Use GTK POPUP window to avoid fullscreen window management of i3. Relates to https://github.com/i3/i3/issues/4749 c1434d0 Fix textlist return selected value cfa437d remove/disable debug output a72ffc4 Add tracker dependency 8c040ca Tracker page functionally complete 5b8ff8f WIP: tracker partially working. 35637ec Update build files and add tracker dep f67ede6 Window selection causes focus 00af209 Read windows from i3 and display 843bef4 Add partial parser for i3 tree struct 2adf24e Add working textlist page 97b1234 Fix message truncation bug a979865 Do not handle any key events 4f3d557 Enable delete notification function 425c1b1 Allow pages to handle key events e5af321 Icon and layout for notifications f006839 parse i3 config file to extract default values for variables ec55468 Keybindings viewable 961eda0 autovala updates 611fdb0 Add classes from remontoire to read i3 config a76e39a WIP: icon/detail view. waiting for model changes from rofication before proceeding 082f659 Can read/display notifications 1fc0c56 Add ability to specify primary page on command line fec9a81 Use hashtable for app launch frequency lookups 3e93feb Prefer apps that start with query string. Misc cleanup. 05c0989 Add UI polish 6450a6f WIP: terminal page f0c2d4a Add spinner UI to clean up app launch lifecycle 5dc43f0 WIP, bug w/ intermittant launch failure 4e2db83 Extract desktop app loading into class. Introduce general interface for pages. b51bf40 Add app metadata files. Add build support for gsettings schema. 6517de8 Improve startup ux. Load apps from user dirs. Close dialog before launching app. 35a1d08 Ignore whitespace in filter 111241d Support pg up/down. Configurable window and icon size. 8c78649 Add unused cmake files to appease autovala/meson bbe2851 Selected apps rise to top of list 25a447d add gsettings schema 579c8d6 Can launch apps b58252a Initial import from autovala creation Changes in lago: # 960c8a0 Refactor rofication client to be sessionless. 6313183 More legible output from ls 31f495e Add empty files to appease autovala generated build files b5bda93 Add usage to readme 1117188 Add readme 084b41d Add packaging 57939e8 clean up cli 43419b5 format source 03132a4 Add source format config f85a450 fix src filename bf452d8 Add rm and clear functions fd4d765 CP: retrieve something from rofication dameon Changes in regolith-rofication: # a75b21a Fix ImportError exception for Python 3.10 or higher (#20) 7481617 Add command to delete list of notifications by id (#17) 6d4673b Merge pull request #16 from cfsmp3/master cd1ecc8 Fix parsing hints dab5dae Change path of queue storage file so it's not directly in the home dir fb3d631 Merge pull request #15 from cfsmp3/master: Add timestamps to notifications 86285dc Undo unneeded changes in daemon 2be67af Made internal format a Python timestamp, convert to string in the UI 21b65d5 Fix conflicts 0ae8cca Read timestamp format from XResources faeb17f Feature: store the notification state of 'icon' (#13) 3f14e05 Fix some typos in README (#14) ffdc26e Add daemon 83f5b74 Make datetime format configurable via arg 1ed370a Add timestamp to notifications e45205f Fix some typos in README (#12) 02329b5 Package last change 29ff56c keep ui open if there are still notifications left (#10) Changes in regolith-control-center: # 6a39ca015 Add debug info for invalid panel id, related to https://github.com/regolith-linux/regolith-control-center/issues/2 cffbd8e1b Remove dim screen toggle db3357d3b Remove background panel. See https://github.com/regolith-linux/regolith-desktop/issues/630 87aab1ec1 For better i3 interop, all modal dialogs close if they lose focus, preventing poor UX from hidden window a17b0366d Swap ubuntu logo for regolith b60229237 Remove unneeded lock panel a5e34f04c Remove unneeded notifications panel 2cfbbb664 Remove unused fractional scaling 558309824 Remove ubuntu and connectivity panels for debian support 001a1e711 Remove patch that fails to build on debian 0f95095a0 Remove gnome-language-selector support, ubuntu specific 158dcd919 Remove whoopsie support, ubuntu specific bff27cc66 Update dbus service name to prevent collisiosn with gnome-control-center 2660efbf5 Rename desktop entry to avoid collision with gnome-control-center II 0c21d0d4b Rename desktop entry to avoid collision with gnome-control-center be157d991 Remove upstream file 5d934dc83 Rename cc-remote-login-helper to prevent collision w/ gnome-control-center 17421fbbd Ignore files not installed in removed packages 44784f21d Remove unshipped files a7a5a9fb7 Fix references to renamed schema aa55ad004 Remove -data and -faces packages, use upstream 185af0ddd Rename gnome-power-manager icons to prevent collision w/ gnome-control-center ffc1ed0f7 Update flatpack fields for regolith a9859968f Change filenames to avoid collision w/ gnome-control-center 8bd341a1d Tweak desktop file to differentiate from gnome-control-center 695219bc7 Change filenames to avoid collision w/ gnome-control-center 024a179f3 Move gettext files due to collision with gnome-control-center 4a3db8b67 Add context to readme 8c1b2c9fd Remove failing dep 55c3a8d0f Remove failing or redundant patches b160acbd3 Remove upstream readme 9b5bdb062 Regress polkit-gobject-1 dependency to match debian version in meson (experimental) 20bd1f69e Global rename from gnome-control-center to regolith-control-center a86c8ef7a Fix of issue with adjusting output volume Changes in regolith-default-settings: # 5aac9cb Remove texture from default wallpaper Changes in nordic: # 3577075 Add built themes from release 2.1.0 dbd6e31 Remove source files 6f1aea6 Add debian packaging Changes in fonts-source-code-pro-ttf: # 2fd5dfd Initial import from speedricer, debian cleanup Changes in fonts-nerd-fonts: # 96d4985 Remove noto as assets are too large for github policy a511489 add source file a63a1f9 remove script from debian branch 7842791 Commit from automation "},{"id":15,"href":"/docs/reference/","title":"Reference","section":"Docs","content":"This section contains reference material that may help you with Regolith.\n"},{"id":16,"href":"/docs/reference/Releases/regolith-1.6.0-release-notes/","title":"1.6 Release Notes","section":"Releases","content":"Regolith R1.6 is a feature release which includes several improvements and optimizations. Regolith 1.6\u0026rsquo;s primary feature is a return of the ISO installation method.\nFeatures # Feature Screenshot Description Return of Regolith Linux ISO Up to Regolith 1.4.1, we hand-built each ISO for major version releases. This became too brittle and time intensive, and so work began on build automation to generate the ISO. This took quite awhile to complete but is now available for the 1.6 release. New Look: Midnight Fabian (naib864) has provided a distinctive new look with new font, icons, and GTK theme. New Look: Solarized Light Ricardo Pérez (ricpelo) has provided a solarized light theme. New Status Indicator: app-launcher Regolith user Laurent provided the idea to add a status indicator to launch Rofi, and so i3xrocks-app-launcher was added for those that prefer to use the mouse to launch apps. Upgrades to i3-gaps and Rofi i3-gaps is updated to 4.19.1 and Rofi to 1.6.1. Fixes # Have a look at the R1.6 project page for a list of bug fixes.\nChangelog Delta from Regolith 1.5.3 to Regolith 1.6 # dracula-gtk (1.1.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add icons to dracula theme regolith-desktop (2.122-1bionic) bionic; urgency=medium [ Ken Gilmer ] * Add app launcher to complete desktop metapackage. Fix unneeded dep on mutter-common. regolith-desktop (2.118-1bionic) bionic; urgency=medium [ Ken Gilmer ] * Version bump to 1.6.0 regolith-ftue (1.1.2-1) bionic; urgency=medium [ Jordan Callicoat ] * More Xresources options for GNOME Terminal regolith-i3-gaps-config (2.8.6-1) bionic; urgency=medium [ Ken Gilmer ] * specify default workspace layout mode regolith-i3-gaps-config (2.8.5-1) bionic; urgency=medium [ Bence Ferdinandy ] * adding $mod+s for sound setting (#36) [ Ken Gilmer ] * Fix urls to howtos. Relates to https://github.com/regolith-linux/regolith-i3-config/pull/1. regolith-i3xrocks-config (3.6.4-1) bionic; urgency=medium [ Ken Gilmer ] * Remove invalid Xresource key segment from microphone block regolith-i3xrocks-config (3.6.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add missing dependency to net-traffic script on iproute2 regolith-i3xrocks-config (3.6.2-1) bionic; urgency=medium [ Ken Gilmer ] * Fix control file * Fix config for app-launcher, remove incorrect interval on next-workspace regolith-i3xrocks-config (3.6.1-1) bionic; urgency=medium [ Ken Gilmer ] * Take nicolas-lopez's contribution via gist as microphone status indicator. Related to https://github.com/regolith-linux/regolith-i3xrocks-config/issues/105. * Add app launcher status indicator regolith-rofication (1.3.3-1) bionic; urgency=medium [ Ken Gilmer ] * Remove debug logs that show up in /var/log/syslog (#9) regolith-rofication (1.3.2-1) bionic; urgency=medium [ Ken Gilmer ] * Require i3xrocks-rofication to be upgraded first, due to file collision between i3xrocks-rofication and regolith-rofication [ Carles Sala ] * Close window after deleting the last notification (#8) regolith-styles (2.9.7-1) bionic; urgency=medium [ Ken Gilmer ] * Rename midnight look background file to avoid collision w/ ubuntu-wallpapers-focal. regolith-styles (2.9.6-1) bionic; urgency=medium [ Ken Gilmer ] * Another attempt to fix pop-os wallpaper reference regolith-styles (2.9.5-1) bionic; urgency=medium [ Ken Gilmer ] * Fix pop os gnome settings regolith-styles (2.9.4-1) bionic; urgency=medium [ Ken Gilmer ] * Fix pop-os background. Change image filename to avoid conflicts regolith-styles (2.9.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add background image missing from midnight theme regolith-styles (2.9.2-1) bionic; urgency=medium [ Ken Gilmer ] * Fix color value unparsable by i3 regolith-styles (2.9.1-1) bionic; urgency=medium [ Ricardo Pérez ] * Fixes Gtk theme (SolArc-Dark -\u0026gt; SolArc) (#44) regolith-styles (2.9.0-1) bionic; urgency=medium [ Ricardo Pérez ] * New solarized-light theme (#43) [ Ken Gilmer ] * Package solarlized-light look contribution from @ricpelo * Add icon for app launcher shortcut regolith-styles (2.8.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add app launcher glyph regolith-styles (2.8.2-1) bionic; urgency=medium [ Ken Gilmer ] * Fix font specification for midnight look regolith-styles (2.8.1-1) bionic; urgency=medium [ Ken Gilmer ] * midnight theme package fixes regolith-styles (2.8.0-1) bionic; urgency=medium [ Fabian ] * Add midnight theme (#37) [ Ken Gilmer ] * Add dependencies to midnight look regolith-styles (2.7.1-1) bionic; urgency=medium [ Ken Gilmer ] * Specify different color for indicator to make window orientation indicator visible in dracula. Fixes https://github.com/regolith-linux/regolith-styles/issues/40. * Revert to single column mode in lascaille * Use accent color for orientation border decoration in lascaille regolith-styles (2.7.0-1) bionic; urgency=medium [ Ken Gilmer ] * Rofi app launcher in two columns regolith-styles (2.6.17-1) bionic; urgency=medium [ HieuTranTH ] * dracula: Fix a typo in i3-wm config file (#41) * ubuntu: Fix color_base2 incomplete hex code (#42) [ Ken Gilmer ] * Add highlight to bar for non-active focused windows for better multi-monitor experience (lascaille) regolith-system (1.5.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add recommends for Regolith system packages regolith-system (1.5.2-1) hirsute; urgency=medium [ Ken Gilmer ] * remove deprecated dependency rofi (1.6.1-1regolith1) bionic; urgency=medium * Adapted package metadata from Ubuntu for 1.6.1 release ubiquity-slideshow-regolith (168.5-regolith1) focal; urgency=medium [ Ken Gilmer ] * Update virtual package dependency for focal "},{"id":17,"href":"/docs/reference/xresources/","title":"Xresources","section":"Reference","content":"Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. Xresources Key Description gtk.theme_name GTK Theme (\u0026ldquo;Legacy Applications\u0026rdquo; in gnome-tweaks) gtk.icon_theme_name GTK Icon Theme gnome.terminal.audible-bell Enables audible bell in gnome-terminal (true / false) gtk.document_font_name GTK Document Font Name gtk.font_name General purpose font for GTK apps and the desktop gtk.monospace_font_name Font for monospace areas such as i3bar and the terminal gnome.terminal.background-transparency-percent Background transparency value for gnome-terminal (0 - 100). See also gnome.terminal.use-transparent-background. gnome.terminal.font Font definition for gnome-terminal gnome.terminal.scrollbar Flag to enable/disable scrollbar (never / always) gnome.terminal.use-transparent-background Enables transparent background in gnome-terminal (true / false). See also gnome.terminal.background-transparency-percent. gnome.wallpaper GNOME Wallpaper (can be overridden in Settings) gnome.wm.theme GNOME Window Manager Theme (unused) wm.alt Key mapping for Alt key. See the i3 User Guide for details. wm.bar.background.color Bar Background Color wm.bar.position Bar Screen Position wm.bar.separator.color Color of seperator between blocks wm.bar.separatorchar Character to display between blocks wm.bar.statusline.color wm.bar.trayoutput Enable or disable the app tray in i3bar wm.bar.workspace.active.background.color wm.bar.workspace.active.border.color wm.bar.workspace.active.text.color wm.bar.workspace.focused.background.color wm.bar.workspace.focused.border.color wm.bar.workspace.focused.text.color wm.bar.workspace.inactive.background.color wm.bar.workspace.inactive.border.color wm.bar.workspace.inactive.text.color wm.bar.workspace.urgent.background.color wm.bar.workspace.urgent.border.color wm.bar.workspace.urgent.text.color wm.client.focused.color.background wm.client.focused.color.border wm.client.focused.color.child_border wm.client.focused.color.indicator wm.client.focused.color.text wm.client.focused_inactive.color.background wm.client.focused_inactive.color.border wm.client.focused_inactive.color.child_border wm.client.focused_inactive.color.indicator wm.client.focused_inactive.color.text wm.client.unfocused.color.background wm.client.unfocused.color.border wm.client.unfocused.color.child_border wm.client.unfocused.color.indicator wm.client.unfocused.color.text wm.client.urgent.color.background wm.client.urgent.color.border wm.client.urgent.color.child_border wm.client.urgent.color.indicator wm.client.urgent.color.text wm.floatingwindow.border.size Window border size in pixels for floating windows wm.font Window manager font wm.gaps.inner.size Default gap size between windows in pixels wm.gaps.outer.size Default gap size at screen edge in pixels wm.mod Key mapping for Super key. See the i3 User Guide for details. wm.window.border.size Default border size in pixels wm.workspace.01.name .. wm.workspace.19.name Workspace Labels wm.workspace.01.key .. wm.workspace.10.key Workspace Shortucts i3xrocks.action.volume.left Command to execute when volume indicator is left clicked (default: none) i3xrocks.action.volume.middle Command to execute when volume indicator is middle clicked (default: none) i3xrocks.action.volume.right Command to execute when volume indicator is right clicked (default: mute through amixer) i3xrocks.action.volume.scrollup Command to execute when scroll wheel up is used on volume indicator (default: increase volume through amixer) i3xrocks.action.volume.scrolldn Command to execute when scroll wheel down is used on volume indicator (default: decrease volume through amixer) i3xrocks.error.color Color for bar module in error mode i3xrocks.label.battery0 Bar icon glyph i3xrocks.label.battery100 Bar icon glyph i3xrocks.label.battery20 Bar icon glyph i3xrocks.label.battery50 Bar icon glyph i3xrocks.label.battery80 Bar icon glyph i3xrocks.label.batteryac Bar icon glyph i3xrocks.label.batterycharging Bar icon glyph i3xrocks.label.batteryunknown Bar icon glyph i3xrocks.label.capslock Bar icon glyph i3xrocks.label.color Bar icon glyph i3xrocks.label.cpu Bar icon glyph i3xrocks.label.disk Bar icon glyph i3xrocks.label.dn Bar icon glyph i3xrocks.label.help Bar icon glyph i3xrocks.label.mediapaused Bar icon glyph i3xrocks.label.mediaplaying Bar icon glyph i3xrocks.label.memory Bar icon glyph i3xrocks.label.mute Bar icon glyph i3xrocks.label.notify.error Bar icon glyph i3xrocks.label.notify.none Bar icon glyph i3xrocks.label.notify.some Bar icon glyph i3xrocks.label.numlock Bar icon glyph i3xrocks.label.off Bar icon glyph i3xrocks.label.on Bar icon glyph i3xrocks.label.sound Bar icon glyph i3xrocks.label.thermometer Bar icon glyph i3xrocks.label.time Bar icon glyph i3xrocks.label.up Bar icon glyph i3xrocks.label.wifi Bar icon glyph i3xrocks.label.wired Bar icon glyph i3xrocks.nominal Default bar icon color i3xrocks.value.color Color of numerical value in bar module i3xrocks.value.font Font for numerical value in bar module i3xrocks.warning Warning color for bar module Optional Xresources keys # The following Xresources keys are undefined by default but can be used by users to change behavior as desired.\n Xresources Key Description wm.gaps.focus_follows_mouse The window under the mouse has focus if enabled wm.program.launcher.app Command i3 executes from the app launcher keybinding wm.program.launcher.cmd Command i3 executes from the command launcher keybinding wm.program.launcher.window Command i3 executes for the window navigation keybinding wm.program.help Command to launch from the help keybinding wm.program.file_search Command to launch from the file search keybinding wm.program.refresh_ui Command to launch from the session refresh keybinding wm.program.logout Command to launch from the logout keybinding wm.program.reboot Command to launch from the reboot keybinding wm.program.shutdown Command to launch from the shutdown keybinding wm.program.lock Command to launch from the lock screen keybinding wm.program.sleep Command to launch from the sleep keybinding wm.program.settings Command to launch from the Control Panel keybinding wm.program.display Command to launch from the Display Settings keybinding wm.program.wifi Command to launch from the Wifi Settings keybinding wm.program.bluetooth Command to launch from the Bluetooth Settings keybinding wm.program.files Command to launch from the file browser keybinding wm.program.notification_ui Command to launch from the notification UI keybinding wm.program.1\u0026hellip;wm.program.3 Optional programs to start with i3 i3xrocks.media-player.player-args Optional arguments used by the media-player i3xrocks block. These arguments are fed straight into playerctl, eg. setting this value to -p spotify only makes the bar display/control spotify. i3xrocks.action.mic.left Optional command to run on left button click of microphone status indicator. i3xrocks.action.mic.middle Optional command to run on middle button click of microphone status indicator. i3xrocks.action.mic.right Override command to run on right button click of microphone status indicator. i3xrocks.action.mic.scrollup Override command to run on scroll up of microphone status indicator. i3xrocks.action.mic.scrolldn Override command to run on scroll down of microphone status indicator. i3xrocks.action.volume.left Optional command to run on left button click of microphone status indicator. i3xrocks.action.volume.middle Optional command to run on middle button click of microphone status indicator. i3xrocks.action.volume.right Override command to run on right button click of microphone status indicator. i3xrocks.action.volume.scrollup Override command to run on scroll up of microphone status indicator. i3xrocks.action.volume.scrolldn Override command to run on scroll down of microphone status indicator. i3xrocks.action.disk-capacity Override command to run on disk capacity status indicator. i3xrocks.action.cpu-usage Override command to run on cpu usage status indicator. i3xrocks.action.memory Override command to run on memory status indicator. i3xrocks.action.wifi Override command to run on wifi status indicator. i3xrocks.action.weather Override command to run on weather status indicator. i3xrocks.action.media-player.left Optional command to run on left button click of media player status indicator. i3xrocks.action.media-player.middle Optional command to run on middle button click of media player status indicator. i3xrocks.action.media-player.right Override command to run on right button click of media player status indicator. i3xrocks.action.time Override command to run on date time status indicator. i3xrocks.action.battery Override command to run on battery status indicator. "},{"id":18,"href":"/docs/reference/Releases/regolith-1.5.3-release-notes/","title":"1.5.3 Release Notes","section":"Releases","content":"Regolith 1.5.3 is a bug fix release. The following list contains brief descriptions of fixes and updates per package since the Regolith 1.5.2 release:\nRelease Notes for i3xrocks # i3xrocks (1.3.5-1) bionic; urgency=medium\n[ Ken Gilmer ]\n Do not print system file error if user files do not exist. Addresses https://github.com/regolith-linux/regolith-i3xrocks-config/issues/114. Release Notes for regolith-desktop # regolith-desktop (2.111-1bionic) bionic; urgency=medium\n[ Ken Gilmer ]\n Move from i3xrocks-todo to regolith-todo to address https://github.com/regolith-linux/regolith-todo/issues/6. Version bump in version file for 1.5.3. Release Notes for regolith-i3xrocks-config # regolith-i3xrocks-config (3.5.7-1) bionic; urgency=medium\n[ Ken Gilmer ]\n remove debugging output flag in net-traffic script Release Notes for regolith-styles # regolith-styles (2.6.16-1) bionic; urgency=medium\n[ Ken Gilmer ]\n Tweak to width to better match pixel equivalent at 1080p. regolith-styles (2.6.15-1) bionic; urgency=medium\n[ Ken Gilmer ]\n Use relative width over pixels for better HiDPI support of Rofi dialog. Idea from @eduncan911 in https://github.com/regolith-linux/regolith-desktop/issues/417. Release Notes for regolith-todo # regolith-todo (1.2.1-1) bionic; urgency=medium\n[ Ken Gilmer ]\n Specify that regolith-todo replaces i3xrocks-todo. Addresses https://github.com/regolith-linux/regolith-todo/issues/6. Release Notes for remontoire # remontoire (1.4.1-1) bionic; urgency=medium\n[ Mark Stosberg ]\n Document -i, -p. (#11) [ Michael Vetter ]\n Add openSUSE install instructions [ Ken Gilmer ]\n Add fonts-font-awesome as soft dependency based on reference in CSS file and user feedback. Addresses https://github.com/regolith-linux/remontoire/issues/16. Cleanup "},{"id":19,"href":"/docs/reference/Releases/regolith-1.5.2-release-notes/","title":"1.5.2 Release Notes","section":"Releases","content":"Regolith 1.5.2 is a bug fix release. The following list contains brief descriptions of fixes and updates per package since the Regolith 1.5.1 release:\nRelease Notes for regolith-compositor-picom-glx # Remove manual fade flag passed to compositor in favor of specification in config file. Allows users to specify fade parameters via config file. Release Notes for regolith-ftue # Check update flag before changing gnome-terminal. Allows users to turn gnome-terminal profile generation off. Release Notes for regolith-i3xrocks-config # Added gawk specific testing for temp script (#108) Filter all interfaces associated with VPN traffic while determining default route (#110) Capture error cases involving invalid network device paths and sleep before returning to resolve CPU consuming loop due to interval type of i3blocks. "},{"id":20,"href":"/docs/reference/Releases/","title":"Releases","section":"Reference","content":"Release notes and other version-specific content can be found here.\n"},{"id":21,"href":"/docs/reference/Releases/regolith-1.5.1-release-notes/","title":"1.5.1 Release Notes","section":"Releases","content":"Regolith 1.5.1 is a bug fix release. The following list contains brief descriptions of fixes and updates per package since the Regolith 1.5 release:\nRelease Notes for i3-next-workspace # Initial copy from regolith-i3xrocks-config. Release Notes for regolith-compositor-picom-glx # Add xrender-sync-fence for better support of nvidia systems. Release Notes for regolith-default-settings # Add breaks declaration to deal w/ ISO upgrade issue Release Notes for regolith-desktop # ship version file with all desktop variants Update version to 1.5.1 Add new recommends for rofication status indicator that has been seperated from regolith-rofication Fix virtual package specification. Use look w/ less dependencies for minimal meta-package. Release Notes for regolith-ftue # Add some Xresources options for GNOME Terminal Release Notes for regolith-i3-gaps-config # Fix build files Fix path to i3-next-workspace Move some non-critical dependencies to Recommends. Add recommends to i3-next-workspace. Remove dep on FontAwesome. deprecating startnum fix adding a missing logic Fix \u0026lsquo;Carry Window to Next Free\u0026rsquo; binding, remove trailing whitespace. #31 Release Notes for regolith-i3xrocks-config # Add padding for net-traffic, extensive mocked tests #101 Migrate rofication status indicator i3xrocks conf file here from regolith-rofication. Remove button handling code as net-traffic cannot use them w/ repeat interval type. #100 Update net-traffic script to use \u0026lsquo;repeat\u0026rsquo; interval type. Rewrite weather blocklet #96 Remove todo scripts as migrated to regolith-todo package Fix disk-capacity button clicks, add tests #98 Change memory rock default full text #94 Fix name of next-workspace script from last change Remove next-workspace script as it\u0026rsquo;s moved to it\u0026rsquo;s own package: i3-next-workspace. format the connected device string using pango same as other rocks #89 Changed around a few release names Use git-buildpackage to build the deb instead of debuild, use auth for all containers reading from xresources now #82 Don\u0026rsquo;t sign packages for now, so the pipeline actually builds Only run packaging on tag releases for now Added tests for temp script and reworked temp script routine Also run the tests on PRs Match example with what the script is looking for #90 Rewrote net-traffic script, fixes #91 #92 Add extra location information to weather API request #88 set BUTTON variable #93 Added net-traffic tests and GitHub Actions workflow to run tests Switch to a separate container running to ensure we can run our tests Make sure we can actually run the job somewhere Fixed xrescat mock and test execution Fix for button handling of the net-traffic script #86 Make time interval configurable with Xresources #87 Restore original behavior of mouse actions on volume #85 Release Notes for regolith-rofication # Another approach to breaking status indicator from base functionality due to python build script mysteries: move the i3xrocks conf.d file to i3xrocks. Leave python scripts here for the python installer thing. Break status indicator for rofication into separate package: i3xrocks-rofication. Release Notes for regolith-styles # Check if gnome-terminal is installed before generating profile. Related to #522. Release Notes for regolith-todo # Add i3xrocks dependency in hopes of sidestepping package file conflicts during upgrades Rewrote syntax of todo script, added tests Add td-cli as dependency Package created from regolith-i3xrocks-config "},{"id":22,"href":"/docs/reference/Releases/regolith-1.5-release-notes/","title":"1.5 Release Notes","section":"Releases","content":"Regolith R1.5 is a feature release which includes several improvements and optimizations. To summarize, Regolith 1.5 ships simpler workspace management, a Rofi-based Look switcher, and numerous internal optimizations and cleanup. Read below for more details.\nFeatures # Feature Screenshot Description Next Free Workspace A typical part of managing workspaces in an i3-based desktop is moving to unused workspaces and then loading some applications. Before this feature, a user has to determine which unused workspace they prefer. This is done by scanning the list of existing used workspaces to determine an unused one. Now, the system can do this automatically. The super ` keybinding will move to the next free workspace. super alt ` will move the focused window into the next free workspace. View and Change Looks via Rofi Looks can be changed now via a Rofi dialog rather than having to configure the Xresources override via the command-line. To do this, use the keybinding super alt l and then select a look from the dialog. GSettings Overrides Regolith now uses GSettings overrides to configure various GNOME settings for use with Regolith. In previous versions, settings were written globally to the user session from within the Regolith startup code. This could cause issues if the user works in multiple desktop environments. Now, the Regolith GNOME settings are defined in an override file that is only in effect while using a Regolith session. This allows switching between desktop environments without settings from Regolith impacting other environments. New Looks Users have contributed some new Looks to Regolith: Dracula, Gruvbox, and PopOs. Each of these looks presents a distinctive color palate, typeface, and GTK theme. i3-gaps upgraded to 4.18.2 See the i3-gaps release notes for more information More Refined Customizations Numerous small changes allow more granular system customization, such as specifying the temperature unit, custom Compositor settings, and a more comprehensive way of changing i3 keybindings without having to copy the entire config file. More Desktop Environment Packages The following packages can be installed in place of regolith-desktop for specific sets of packages based on user needs: regolith-desktop-minimal, regolith-desktop-standard, regolith-desktop-mobile, and regolith-desktop-complete New default compositor: Picom version 8 See the Picom release notes for more information on what has changed. Remontoire upgraded to version 1.4 Includes better multi-monitor support and other bug fixes and enhancements. Optional integration with td-cli Access a simple todo app via Rofi. Documentation of development process The Regolith development process is now better documented for greater transparency and to foster inclusion. Fixes # Have a look at the R1.5 project page for a list of bug fixes.\nChangelog Delta from Regolith 1.4.1 to Regolith 1.5 # ######################################## # Release Notes for dracula-gtk ######################################## dracula-gtk (1.0.1-1) bionic; urgency=medium [ Ken Gilmer ] * Remove unnecessary files dracula-gtk (1.0-1) bionic; urgency=medium * [ Ken Gilmer ] * Packaging version add4f8c ######################################## # Release Notes for fonts-materialdesignicons-webfont ######################################## fonts-materialdesignicons-webfont (1.6.50-3regolith3) bionic; urgency=medium * Backporting to bionic for Regolith. ######################################## # Release Notes for gruvbox-gtk ######################################## gruvbox-gtk (1.0.1-1) bionic; urgency=medium [ Ken Gilmer ] * Rename root directory of theme to Gruvbox for consistency w/ other GTK themes. * Add gbp config for package management. gruvbox-gtk (1.0-1) bionic; urgency=medium [ Ken Gilmer ] * New upstream version 1.0 gruvbox-gtk (1.0-1) bionic; urgency=medium [ eximus ] * Initial commit * gruvbox theme ######################################## # Release Notes for i3-gaps-wm ######################################## i3-gaps-wm (4.18.2-1~regolith2) bionic; urgency=medium * Package source from upstream https://github.com/Airblader/i3/releases/tag/4.18.2 ######################################## # Release Notes for i3ipc-python ######################################## i3ipc-python (2.1.1-1ubuntu1~ppa6) bionic; urgency=medium * Update build dependencies hoping to resolve packaing problems. ######################################## # Release Notes for i3xrocks ######################################## i3xrocks (1.3.4-1) bionic; urgency=medium [ Ken Gilmer ] * Version bump to match changelog. Cleanup. i3xrocks (1.3.3-1) bionic; urgency=medium [ Will Winder ] * Add optional default resource value. * Minor cleanup. * Free resource allocated by xcb_xrm_resource_get_string * Fix possible truncated resource value. [ Ken Gilmer ] * Add gbp config file ######################################## # Release Notes for picom ######################################## picom (8-1~1.gbp353272ubuntu1) bionic; urgency=medium [ Ken Gilmer ] * Remove github files from debian branch. picom (8-1~1.gbp353272) bionic; urgency=medium [ Ken Gilmer ] * New upstream version 8 ######################################## # Release Notes for plano-theme ######################################## plano-theme (3.36-1-1regolith1) bionic; urgency=medium [ Ken Gilmer ] * New upstream version 3.36-1 ######################################## # Release Notes for plymouth-theme-regolith ######################################## plymouth-theme-regolith (1.0.3-1) focal; urgency=medium * Tweaks to config files. plymouth-theme-regolith (1.0.2-1) focal; urgency=medium * Ship grub file. plymouth-theme-regolith (1.0.1-1) focal; urgency=medium * Add package hooks. ######################################## # Release Notes for pop-fonts ######################################## pop-fonts (1.0.3~1555617065~18.04~a86eb73) bionic; urgency=medium * Auto Build ######################################## # Release Notes for python3-i3ipc ######################################## python3-i3ipc (2.1.1-1ubuntu1~ppa7) bionic; urgency=medium * Changes to python version. i3ipc-python (2.1.1-1ubuntu1~ppa6) bionic; urgency=medium * Update build dependencies hoping to resolve packaing problems. i3ipc-python (2.1.1-1ubuntu1~ppa4) eoan; urgency=medium * Add python-xlib dependency. i3ipc-python (2.1.1-1ubuntu1~ppa2) eoan; urgency=medium * Initial release from https://github.com/altdesktop/i3ipc-python/archive/v2.1.1.tar.gz. ######################################## # Release Notes for regolith-compositor-compton-glx ######################################## regolith-compositor-compton-glx (1.1.0-1) bionic; urgency=medium [ Ken Gilmer ] * Init script will kill pre-existing app instance before starting new. Part of fix for https://github.com/regolith-linux/regolith-desktop/issues/475. regolith-compositor-compton-glx (1.0.10-1) bionic; urgency=medium [ Ken Gilmer ] * Fix typo in compton config file, found by @gservat. regolith-compositor-compton-glx (1.0.9-1) bionic; urgency=medium [ Ken Gilmer ] * Add xrender-sync-fence to handle issue https://github.com/regolith-linux/regolith-desktop/issues/116. regolith-compositor-compton-glx (1.0.8-1) bionic; urgency=medium [ Ken Gilmer ] * Ship config file. regolith-compositor-compton-glx (1.0.7-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-compositor-none ######################################## regolith-compositor-none (1.0.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-compositor-picom-glx ######################################## regolith-compositor-picom-glx (1.1.1-1) bionic; urgency=medium [ Ken Gilmer ] * Fix typo found in https://github.com/regolith-linux/regolith-compositor-picom-glx/issues/1. * Init script will kill pre-existing app instance before starting new. Part of fix for https://github.com/regolith-linux/regolith-desktop/issues/475. regolith-compositor-picom-glx (1.0.1-1) bionic; urgency=medium [ Ken Gilmer ] * Fix typo found in https://github.com/regolith-linux/regolith-compositor-picom-glx/issues/1. regolith-compositor-picom-glx (1.0.0-1) bionic; urgency=medium * Initial release ######################################## # Release Notes for regolith-compositor-xcompmgr ######################################## regolith-compositor-xcompmgr (1.2.0-1) bionic; urgency=medium [ Ken Gilmer ] * Init script will kill pre-existing app instance before starting new. Part of fix for https://github.com/regolith-linux/regolith-desktop/issues/475. regolith-compositor-xcompmgr (1.1.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add ability to override xcompmgr defaults. Fixes https://github.com/regolith-linux/regolith-desktop/issues/382. regolith-compositor-xcompmgr (1.0.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-default-settings ######################################## regolith-default-settings (1.0-1bionic1) bionic; urgency=medium [ Ken Gilmer ] * Add bionic specific gsettings overrides. regolith-default-settings (1.0-1) focal; urgency=medium * Initial release, files moved from package regolith-gnome-flashback. ######################################## # Release Notes for regolith-desktop ######################################## regolith-desktop (2.78-1bionic) bionic; urgency=medium [ Ken Gilmer ] * Move from compton to picom as default compositor. regolith-desktop (2.75-1bionic) bionic; urgency=medium [ Ken Gilmer ] * Change unclutter to regolith-unclutter-fixes to address https://github.com/regolith-linux/speed-ricer/issues/14. regolith-desktop (2.72-1bionic1) bionic; urgency=medium [ Ken Gilmer ] * Version bump for next DE release regolith-desktop (2.71-1bionic1) bionic; urgency=medium [ Ken Gilmer ] * Depend on regolith-default-settings to migrate to gsettings overrides. * Update branch name to conform w/ gbp. regolith-desktop (2.68-1bionic1) bionic; urgency=medium * Package: Remove postinst to unblock upgrades (#432) regolith-desktop (2.60-1bionic1) bionic; urgency=medium * Package: Remove unclutter-startup, if installed regolith-desktop (2.59-1bionic1) bionic; urgency=medium * Bump version file for R1.4.1 release. ######################################## # Release Notes for regolith-ftue ######################################## regolith-ftue (1.0.11-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp config file. ######################################## # Release Notes for regolith-gnome-flashback ######################################## regolith-gnome-flashback (2.6.2-1) bionic; urgency=medium [ Ken Gilmer ] * Remove invalid component from desktop session file. * Cleanup regolith-gnome-flashback (2.6.1-1) bionic; urgency=medium [ Ken Gilmer ] * Rename files to make session work. regolith-gnome-flashback (2.6.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp config file. * Simply package, model directories in package and remove Makefile. * Update session files to refer to regolith over i3-gnome-flashback. Experimental. regolith-gnome-flashback (2.5.0-1) bionic; urgency=medium * Remove desktop files moved to regolith-default-settings. regolith-gnome-flashback (2.4.19-1focal1) focal; urgency=medium * Fix wallpaper gsettings override. regolith-gnome-flashback (2.4.18-1focal1) focal; urgency=medium * Remove non Regolith i3 config file load logic. regolith-gnome-flashback (2.4.17-1focal1) focal; urgency=medium * Move to gsettings overrides for static dconf changes. * Change session name from i3-gnome to regolith. * Remove wm theme setting. ######################################## # Release Notes for regolith-i3-gaps-config ######################################## regolith-i3-gaps-config (2.8.0-1) bionic; urgency=medium [ Bence Ferdinandy ] * adding bindings for next_on_output and prev_on_output (#29) regolith-i3-gaps-config (2.7.2-1) bionic; urgency=medium [ Ken Gilmer ] * Add nm-applet to launch by default. Enables better network connectivity workflow. regolith-i3-gaps-config (2.7.1-1) bionic; urgency=medium [ Ken Gilmer ] * Shorten look-selector to look for rofi menu. regolith-i3-gaps-config (2.7.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add launcher for look selector. regolith-i3-gaps-config (2.6.0-1) bionic; urgency=medium [ Ken Gilmer ] * Based on idea from @Ukaszg, extract all keybindings to Xres keys for easy overriding without i3 file copy. Fixes https://github.com/regolith-linux/regolith-i3-gaps-config/issues/25. * Restart compositor upon i3 restart. Part of fix for https://github.com/regolith-linux/regolith-desktop/issues/475. regolith-i3-gaps-config (2.5.1-1) bionic; urgency=medium [ Moritz Heiber ] * Set tray output to primary by default (#24) [ Ken Gilmer ] * Allow the bar mode (dock|hide|invisible) to be specified by xres overrides. regolith-i3-gaps-config (2.5.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add keybindings for 'next free workspace' feature. regolith-i3-gaps-config (2.4.18-1) bionic; urgency=medium [ Will Winder ] * Add missing keybind for moving the workspace with hjkl. (#19) [ Jordan Cohen ] * shortcuts for explicit window orientation and hierarchical focusing (#18) regolith-i3-gaps-config (2.4.17-1) bionic; urgency=medium [ Markus Bertheau ] * Allow customization of workspace_auto_back_and_forth (#20) regolith-i3-gaps-config (2.4.16-1) bionic; urgency=medium [ ukaszg ] * configurable workspace keys (#17) regolith-i3-gaps-config (2.4.15-1) bionic; urgency=medium [ Ken Gilmer ] * Cleanup from lintian warnings. regolith-i3-gaps-config (2.4.14-1) bionic; urgency=medium * Take smart-gaps fix from @winder. * Comment cleanup. ######################################## # Release Notes for regolith-i3xrocks-config ######################################## regolith-i3xrocks-config (3.2.6-1ubuntu2) bionic; urgency=medium [ Ken Gilmer ] * Fix todo icon from updated material design web icons change regolith-i3xrocks-config (3.2.5-1ubuntu1) bionic; urgency=medium [ Rafael Lacerda ] * Fix crash when focused window name is None (#81) [ Peter Mahnke ] * Remove decimal places from battery number (#80) regolith-i3xrocks-config (3.2.4-1) bionic; urgency=medium [ Ken Gilmer ] * Temp status indicator can be configured with sensor name via Xres value i3xrocks.temp.key. regolith-i3xrocks-config (3.2.3-1) bionic; urgency=medium [ Pedro Kostelec ] * [IMPR] Show aggregated battery percentage (#78) [ Ken Gilmer ] * Fix issue found in livecd enviroment w memory script [ Pedro Kostelec ] * [FIX] Fixes dissapearing indicator when value is 0 (#79) regolith-i3xrocks-config (3.2.2-1) bionic; urgency=medium [ Peter Mahnke ] * Make curl work for special characters (#76) [ Ken Gilmer ] * Remove debugging line mistakenly added by me in earlier fix. regolith-i3xrocks-config (3.2.1-1) bionic; urgency=medium [ Ken Gilmer ] * Fix cpu-usage script regolith-i3xrocks-config (3.2.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add ability to specify temperature unit via xres, and fallback to country locale if unspecified. Based on https://github.com/regolith-linux/regolith-desktop/issues/372. (#72) [ Joel Hoisko ] * Add option to define a specific media player (#63) regolith-i3xrocks-config (3.1.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add ability to override click commands via Xresources. Fixes https://github.com/regolith-linux/regolith-desktop/issues/352. regolith-i3xrocks-config (3.1.2-1) bionic; urgency=medium [ Leo Palmer Sunmo ] * Polish up media-player text splitting and pango formatting (#71) regolith-i3xrocks-config (3.1.1-1) bionic; urgency=medium [ Vipul Mathur ] * Use `MemAvailable` to indicate memory usage (#70) regolith-i3xrocks-config (3.1.0-1) bionic; urgency=medium [ Bence Ferdinandy ] * fixed an error with name somehow being None * adding next-workspace regolith-i3xrocks-config (3.0.34-1) bionic; urgency=medium [ Marten Lienen ] * Exit gracefully if the focused window does not have a name (#68) regolith-i3xrocks-config (3.0.33-1) bionic; urgency=medium [ Ken Gilmer ] * regress debhelper-compat version due to build failure in launchpad. regolith-i3xrocks-config (3.0.32-1) bionic; urgency=medium [ Ken Gilmer ] * Downgrade debhelper version to appease launchpad. * Remove compat file in attempt to appease debuild. regolith-i3xrocks-config (3.0.31-1) bionic; urgency=medium [ Ken Gilmer ] * Downgrade debhelper version to appease launchpad. regolith-i3xrocks-config (3.0.30-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. regolith-i3xrocks-config (3.0.29-1) bionic; urgency=medium [ Ken Gilmer ] * Package: @cheginit's new todo status indicator based on td-cli. regolith-i3xrocks-config (3.0.28-1) bionic; urgency=medium [ Ken Gilmer ] * Package: @buck10's major rework of keyboard-layout. regolith-i3xrocks-config (3.0.27-1) bionic; urgency=medium [ Ken Gilmer ] * Package: Removed verbose output from net-traffic script (#62) regolith-i3xrocks-config (3.0.26-2) bionic; urgency=medium [ Ken Gilmer ] * Update i3xrocks-focused-window-name to use consistent python library name. regolith-i3xrocks-config (3.0.26-1) bionic; urgency=medium [ Taher Chegini ] * Add todo blocklet (#54) [ Ken Gilmer ] * Initial upstream branch. * New upstream version 3.0.25 regolith-i3xrocks-config (3.0.25-2) bionic; urgency=medium * Trying w/ debhelper v11 based on build error. regolith-i3xrocks-config (3.0.25-1) bionic; urgency=medium * Package changes by @moritzheiber: ** Fix button clicks blocklets ** Also fix network bandwidth calculation/shellcheck errors in net-traffic script regolith-i3xrocks-config (3.0.24-1) bionic; urgency=medium * Package @moritzheiber's fixes for disk-capacity and other blocks. * Package @cjohnston1158 additions to net-traffic. regolith-i3xrocks-config (3.0.23-1) bionic; urgency=medium * Add info indicator missed when moving to conf.d config. regolith-i3xrocks-config (3.0.22-2) bionic; urgency=medium * Fixes to weather status for ambiguous city names and cities of multiple words. ######################################## # Release Notes for regolith-rofi-config ######################################## regolith-rofi-config (1.3.1-1) bionic; urgency=medium [ Ken Gilmer ] * Fix look-selector regolith-rofi-config (1.3.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add script to view and select Looks. Minor cleanup. Addresses https://github.com/orgs/regolith-linux/projects/12. regolith-rofi-config (1.2.6-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp config file. ######################################## # Release Notes for regolith-rofication ######################################## regolith-rofication (1.2.3-1) bionic; urgency=medium [ Ken Gilmer ] * Remove scripts that do not apply to user sessions regolith-rofication (1.2.2-2) focal; urgency=medium * Add git-buildpackage config ######################################## # Release Notes for regolith-styles ######################################## regolith-styles (2.6.13-1ubuntu2) bionic; urgency=medium [ Ken Gilmer ] * More tweaks to icons for material design based looks regolith-styles (2.6.12-1ubuntu1) bionic; urgency=medium [ Ken Gilmer ] * Update material design icon-based looks to use fonts-materialdesignicons-webfont 1.6 mappings regolith-styles (2.6.11-1) bionic; urgency=medium [ Ken Gilmer ] * Add regolith.look Xres entry for currently set look. regolith-styles (2.6.10-1) bionic; urgency=medium [ Ken Gilmer ] * If Regolith user root Xres file exists, move old copy to tmp instead of aborting. Sort looks. Misc cleanup. regolith-styles (2.6.9-1) bionic; urgency=medium [ Ken Gilmer ] * Check a flag before executing gnome-terminal profile script. Fixes https://github.com/regolith-linux/regolith-desktop/issues/471. regolith-styles (2.6.8-1) bionic; urgency=medium [ Ken Gilmer ] * Update term colors for Dracula for more variance and remove conflict for color 11. Addresses https://github.com/regolith-linux/regolith-styles/issues/32. regolith-styles (2.6.7-1) bionic; urgency=medium [ Ken Gilmer ] * Change selected item background color to addresss https://github.com/regolith-linux/regolith-styles/issues/23. regolith-styles (2.6.6-1) bionic; urgency=medium [ Ken Gilmer ] * Add next-workspace glyph for missing looks. Change sound, mute, ram glyphs for fontawesome looks. regolith-styles (2.6.5-1) bionic; urgency=medium [ Ken Gilmer ] * Fix font dependency for pop-os. Cleanup control file. regolith-styles (2.6.4-1) bionic; urgency=medium [ Ken Gilmer ] * Add package for regolith-look-pop-os. regolith-styles (2.6.3-1) bionic; urgency=medium [ Aditya Wagh ] * Create Pop!_OS Style (#29) [ Ken Gilmer ] * Update gtk theme name for consistency. * Add packaging data for pop-os look. regolith-styles (2.6.2-1) bionic; urgency=medium * Specify glyph for next-workspace status indicator for fontawesome and materialdesign. regolith-styles (2.6.1-1) bionic; urgency=medium [ Ken Gilmer ] * Package the dracula look. regolith-styles (2.6.0-1) bionic; urgency=medium [ Drew DeVore ] * Create Dracula Theme (#30) [ Julius Francisco ] * Remove user specific path (#31) regolith-styles (2.4.27-1) bionic; urgency=medium [ Ken Gilmer ] * Fix typo in package file. regolith-styles (2.4.26-1) bionic; urgency=medium [ Ken Gilmer ] * Fix gruvbox missing files on install. regolith-styles (2.4.25-1) bionic; urgency=medium [ Ekans ] * Create gruvbox style (#25) [ Ken Gilmer ] * Add packaging for gruvbox. regolith-styles (2.4.24-1) bionic; urgency=medium [ Chua Hou ] * Balance workspace name by adding space at end (#20) regolith-styles (2.4.23-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-system ######################################## regolith-system (1.4.0.4-1) focal; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-unclutter-xfixes ######################################## regolith-unclutter-xfixes (1.5-2) bionic; urgency=medium [ Ken Gilmer ] * Fix linter warning * Revert \u0026quot;Remove master files\u0026quot; regolith-unclutter-xfixes (1.5-1) disco; urgency=medium [ Ken Gilmer ] * Initial release ######################################## # Release Notes for remontoire ######################################## remontoire (1.4.0-1) bionic; urgency=medium [ Ken Gilmer ] * Specify font for windows glyph in stylesheet. * Increase buffer to 128Kb to handle larger i3 config files * Add feature to consume for stdin and specify arbitrary string prefix for more config file format support. * Fix window positioning in multi-monitor setups. ######################################## # Release Notes for td-cli ######################################## td-cli (1.2.4-7) bionic; urgency=medium * Initial release ######################################## # Release Notes for xrescat ######################################## xrescat (1.2.1-1) bionic; urgency=medium [ Ken Gilmer ] * Cleanup lintian warnings. * Version bump to appease launchpad xrescat (1.2.0-1) bionic; urgency=medium [ Jeremy Coghill ] * added logic to exclude surrounding double quotes from returned strings to allow for the use of leading and trailing spaces in resources. updated version number. updated man page [ Ken Gilmer ] * Update README for new double quote handling. Add gbp config. Cleanup. "},{"id":23,"href":"/docs/reference/Releases/regolith-1.4.1-release-notes/","title":"1.4.1 Release Notes","section":"Releases","content":"Regolith R1.4.1 is a fast follow up to 1.4 that fixes a few serious bugs, detailed on the mailing list. In addition to the package updates, a new boot animation is provided by the package plymouth-theme-regolith that is installed by default on the ISO. The ISO also now excludes a deprecated touchpad driver that was conflicting with Settings. Existing PPA-based installations can simply get the updates via their typical package update process. Regolith Linux ISO users can update to R1.4.1 by applying regular package updates.\n"},{"id":24,"href":"/docs/reference/Releases/regolith-1.4-release-notes/","title":"1.4 Release Notes","section":"Releases","content":"Regolith R1.4 is a major feature release which includes several improvements and optimizations. Regolith is now smaller and more efficient. The ISO-based installer is now based from the Xubuntu image, and moves from the gdm3 display manager to LightDM. This allows for less resource consumption at runtime and dramatically smaller download size1. A new look, lascaille and file search dialog round out the major new features. Read below for more details.\nIf you maintain your own i3 config file, note that the copy shipped in Regolith 1.4 has changed in that it reads more configuration from Xresources. The intention of this change is to require a full copy of the i3 config file less often, by allowing users to customize the system via Xresource overrides instead of copy/edit of the i3 config file. For R1.4 in particular @ploum has provided many of the ideas and validation. Gratitude goes out to Regolith contributors and users @cheginit, @nalderto, @baldrailers, @ivomarino, @Josh-Letts, @LawZava, @SkyyySi, @tomster, @gdeflaux, @appelgriebsch, @farsil, and @MrKovar for their time and attention. Also thanks to all that helped to test and filed issues for bugs and feature requests!\nKnown Issues # Issues and fixes are being tracked in this project.\nFeatures # Feature Screenshot Description Remontoire 1.3.1 - Can render keybindings from i3 over socket or from any file. - Can be configured to display on any screen edge. - Visual updates and bug fixes. - Presentation changeable via CSS. New default look: Lascaille A new look with a bolder, tighter typeface and a darker, higher contrast color theme has become Regolith\u0026rsquo;s default look in 1.4. Cahuella and other looks continue to be available and can be installed with a few commands. New File Search Dialog Based on Rofi and mlocate, users can now quickly find files and launch their default editors from a global dialog. Faster, Easier Customization Virtually everything exportable from the i3 config can now be overridden directly with Xresources declarations, from changing the meta key to specifying the command that launches the app search dialog. Additionally, up to 3 user configured programs can be set to start upon session initialization. All of this is possible without creating a user copy of the i3 config file, but rather by overriding a specific Xresources. i3xrocks supports conf.d style configuration The status indicators in the bar can now be installed and configured independently. This allows for a cleaner dependency model and more efficient runtime characteristics. It also provides future flexibility for user contributed modules and status indicators. Plus, users can provide their own block descriptors in the user directory to easily override the defaults without having to change the i3 config file. New architecture support: arm64 With testing done on a Raspberry Pi 4, Regolith now is installable via PPA when using Ubuntu on arm64 devices with the necessary hardware support. Rewrite of Rofication Rofication has been rewritten to require less dependencies and be more stable by Regolith contributor @farsil. New Ubuntu release support: Focal Fossa Regolith runs as a desktop environment in Canonical\u0026rsquo;s latest release of Ubuntu: 20.04 \u0026ldquo;Focal Fossa\u0026rdquo; Time and Space Optimizations in ISO release By switching from GDM3 to LightDM, Regolith avoids loading some unnecessary desktop components into RAM, resulting in between 200MB to 300MB savings on cold start. Additionally, the LiveCD installer is now based on the Xubuntu LiveCD which dramatically lowers the size of the installer and install image of the system2. Finally, with more fine-grained control of the bar status blocks, only the blocks you\u0026rsquo;ve installed will run. Pluggable Desktop Notification Components Users can now cleanly switch between desktop notification implementations such as dunst and notify-osd, in addition to Rofication without resorting to hacks. Integrate gnome-terminal over st-term by Default Regolith 1.4 uses gnome-terminal with a dynamically generated profile to overcome some character encoding and input devices. st is still available, simply by installing the regolith-st package. Picom (Compton) config can be overriden by user Users can provide their own Picom compositor config in their user directory. i3 reload becomes Regolith reload Refreshing the UI (look, colors, fonts, etc.) after making changes is now as easy as super shift r . Polish, polish, polish Just as in previous releases, many tiny fixes and enhancements were added to Regolith in version 1.4. Fixes # Have a look at the R1.4 project page for a list of bug fixes.\n This does not mean that Regolith uses Xfce4 or any other aspect of Xubuntu other than the install image. \u0026#x21a9;\u0026#xfe0e;\n The trade-off is that users need to install more of the software they require after installation. \u0026#x21a9;\u0026#xfe0e;\n "},{"id":25,"href":"/docs/reference/Releases/regolith-1.3.1-release-notes/","title":"1.3.1 Release Notes","section":"Releases","content":"R1.3.1 is a quick followup to R1.3 that adds polish and usability features. Headlining features include a more concise way of overriding Xresource defaults and several enhancements to the Remontoire keybinding viewer.\nIf you maintain your own i3 config file, note that the copy shipped in Regolith 1.3.1 has changed in that the comment format has been modified to be readable by Remontoire (example). Without updating your copy i3 config comments, you will not see any keybindings. Features # Feature Screenshot Description Remontoire 1.1.1 Provides a live view of active i3 keybindings, introduces a machine-readable comment format for i3 config files, and fixes several layout and presentation bugs reported by users. Ayu Looks The community contributed Ayu themes have been fully integrated into Regolith with updates to package dependencies and configurations. Rofi polishing Numerous updates to the Rofi themes for all provided looks. Easier Customization Now, overriding specific Xresources values can be easily done by supplying only the overrides in ~/.config/regolith3/Xresources without needing to copying and update any existing files. Additionally, any Xresources files in ~/.config/regolith3/Xresources.d can be referenced without absolute path, enabling easier multi-machine configurations. Utilize GNOME and update-alternatives for Default Apps GNOME settings for default browser and update-alternatives for preferred terminal are now used by Regolith. No custom configuration changes are required. Xresources updates More UI configuration pulled out of component configs and into Xresources provides more flexibility in how custom looks can be. Locale used for date/time format For those not using the US date and time formats, the bar clock will now automatically use the GNOME hour format and the locale LC_TIME setting to automatically display date and time in the regional form without configuration. UI tweaks and polishing Many small updates across all UI components to further polish the interface, including a new optional dark background adapted from work by /u/InfernusZ9. Fixes # Debian package dependencies for various Regolith Looks have been fixed. Layout issues with Remontoire have been addressed. Compton configuration cleaned up "},{"id":26,"href":"/docs/reference/Releases/regolith-1.3-release-notes/","title":"1.3 Release Notes","section":"Releases","content":"Following R1.2, the 1.3 release focused on usability issues reported by users and a continuing refinement of the desktop environment in general, with a focus on making the system easier for those inexperienced with tiling window managers.\nFeatures # Feature Screenshot Description Cahuella GTK Theme A new GTK theme was created for Regolith that more closely follows the standard GNOME theme, Adwaita. Keybindings Dialog To allow for a more consistent look and collapsible content for various monitor dimensions, a custom shortcut dialog was developed called Remontoire. Pluggable Compositors The subsystem providing visual effects, the compositor, can behave differently based on hardware and driver support. Regolith now packages 3 compositor backends: compton-glx (based on Picom), xcompmgr, and none. i3-snapshot In office environments it is common to switch between various display configurations (desk, meeting room\u0026hellip;). i3-snapshot allows the user to quickly save and restore existing window layouts in a session. New Rofi theme Based on work by /u/InfernusZ9, the Rofi launcher is less distracting. New notification UI based on Rofication The previous notification UI was a hold over from more traditional desktop environments that prefer to present an on-screen dialog when a notification is received. Because user-focus is paramount, this was changed such that an indicator in the bar displays the number of unread notifications and the user decides when to view them via a keybinding or button click. Floating Control Panel The gnome-control-center app can have a hard time adapting to constrained tiled layouts common with i3-wm. Now when the control panel is loaded, it floats above the existing windows to allow for a quick settings change without impacting other apps. Clickable Bar Status Actions For convienence, the default blocks on the bar will launch configuration apps for the associated block. For example, the battery block will launch the power settings control panel, and the notification block will launch the notification viewer. Discrete and packagable Looks The underlying style framework used by Regolith has been revamped to allow for \u0026ldquo;looks\u0026rdquo;: colors, themes, typeface, and other thematic state. Looks can be switched with a single command. New bar status components Network, keybindings, notifications, focused window, and other blocklets have been improved and added. Build System Build scripts were added and improved to allow for the generation of Regolith packages in an automated fashion, making it easier for others to roll their own. Website An entirely new website is launching with R1.3, to integrate more content and make it faster for users to find information. Fixes # i3-gaps-wm: Fix for workspace label bug on startup. Revamping some keybindings based on user feedback. i3xrocks: numerous tweaks and fixes for status indicators. regolith-gnome-flashback: numerous fixes and policy enhancements to session management. ISO Generation # The following commands were applied via the Cubic tool to the stock Ubuntu 18.04 and 19.10 installer images to generate the Regolith Install ISO:\n$ sudo add-apt-repository universe \u0026amp;\u0026amp; sudo add-apt-repository ppa:regolith-linux/release $ sudo apt remove aisleriot branding-ubuntu cheese* gnome-mahjongg gnome-sudoku gnome-mines gnome-todo* gnome-video-* libchees* libgnome-games* libreoffice* remmina* rhythmbox* shotwell* thunderbird* totem* ure ubuntu-session ubuntu-web-launchers $ apt install regolith-desktop regolith-gdm3-theme $ sudo apt autoremove $ cp /usr/share/backgrounds/lucas-bellator-C0OD8OM-oM0-unsplash.jpg /usr/share/backgrounds/warty-final-ubuntu.png The purpose of removing several packages such as games and libreoffice was to reduce the ISO size. All packages removed in the ISO are installable via the apt tool or via the Ubuntu app store.\n"},{"id":27,"href":"/posts/localization/","title":"Looking for Translators","section":"Blog","content":"With the 2.0 release out the door, we\u0026rsquo;re looking for help to translate the index page and the \u0026ldquo;using regolith\u0026rdquo; section into languages other than English. In the past we\u0026rsquo;ve used a translation system, but it turned out to be too complex for many people to understand. For the Regolith 2.0 site we\u0026rsquo;ll rely on Hugo\u0026rsquo;s multilingual support.\nFor a given language translation the following files must be translated:\ncontent/_index.md content/docs/using-regolith/basics.md content/docs/using-regolith/configuration.md content/docs/using-regolith/first-launch.md To provide a translation, simply copy the English file and add the two-letter language code to the end of the filename. Once the translation is complete, create a pull request and we\u0026rsquo;ll merge your translation. This allows other people to read about Regolith with your language translation.\nAs an example, if a Japanese translation was provided, the following new files would be added to the PR:\ncontent/_index.ja.md content/docs/using-regolith/basics.ja.md content/docs/using-regolith/configuration.ja.md content/docs/using-regolith/first-launch.ja.md There is some additional Hugo configuration before the translation will be available, but we can take care of that. Feel free to open an issue or reach out on GitHub Discussions with any questions, and thanks in advance!\nTranslation Workflow # Here are some step-by-step instructions for creating a translation:\n Create a fork of the GitHub repo that contains the Regolith Desktop website. (learn more) Clone the fork to your local computer. Determine the two-letter designation for your language. Copy the following files to new files with the two-letter language designation (see example above). Translate the content to your language. Commit and push the changes to your fork of the website repository. Create and submit a pull request. By creating the pull request, Regolith project members will be notified to review and push your changes.\n"},{"id":28,"href":"/docs/reference/build-system/","title":"Build System","section":"Reference","content":"Overview # This page describes how packages are generate from source code, and how those packages combine to actualize the Regolith desktop environment. This document covers Regolith only and does not intend to describe upstream dependencies, general package manager concepts, or other aspects of build systems.\nTerms # Distro - Short for distribution, in the context of this document, may be considered a variation of a Linux-based OS operating system. A product, project, and brand. Codename - A well defined and announced snapshot of a set of packages that are consumed as a whole. May be considered a software release with a specific name such as 36 or Jammy. Architecture - In the context of this document, denotes a CPU and base system hardware. Regolith currently targets the amd64 and arm64 architectures. Stage - Represents a snapshot of a set of packages at a modeled level of maturity. In Regolith the following stages from least-stable to most-stable are modeled: experimental - For packages and package changes that may be reverted, removed, or change significantly over time. Serious bugs are common and expected here. unstable - For packages changes that are planned to reach a release but have yet to undergo much testing. Serious bugs may occur from time to time. Regolith core developers may run their testing and development from this stage but users are discouraged from consuming packages from unstable. testing - For packages undergoing testing by Regolith developers and early adopters. Bugs occur but serious bugs should not often pop up in this stage. Regolith users that wish to get access to fixes and new features earlier may consume from this stage with the understanding that bugs are to be expected (, and reporting them is appreciated!) release - For packages that have been determined to be suitable for general use. While minor bugs may be present in packages at this stage, the bugs present should not interfere with general use of the environments for users on supported distros and releases. Target ~ Represents a specific sequence of distro, codename, stage, and architecture for which a set of packages exist. Manifest ~ A file that specifies a set of the properties name, origin, and snapshot for a list of packages. A manifest is a file that represents a snapshot of a target in time. Package Manager ~ A set of formats and programs that allow for packages to be installed in a distro. The package manager may very by distro. Package Repository ~ A well defined source of binary packages that may be installed into an OS that supports a given package manager. Source Repositories # All Regolith packages are generated from git-versioned source repositories. These repositories house the source code for a given component. Mostly, each component is general for any given distro and codename. Source repositories are modeled in the Regolith build system via manifest files.\nManifests # The Regolith build system reads and writes text files known as manifests. The files are initially read as the source of truth for what a given target package repository should contain. If the build system determines if there are updates to the manifest present in the manifest\u0026rsquo;s source repositories, then any updates are built into package updates and published to the target repo along with the updated manifest. In the case that no updates are found, the build simply completes without any changes. As such, a given target\u0026rsquo;s manifest can be used to determine what packages, versions, and source branches/tags are present.\nManifest Schema # Manifests are simply text files with one package per line, and each element in on a line separated by a space (ASCII 32).\n\u0026lt;PACKAGE NAME\u0026gt; \u0026lt;PACKAGE REPO URL\u0026gt; \u0026lt;PACKAGE REPO BRANCH/TAG\u0026gt; \u0026lt;PACKAGE REPO COMMIT HASH\u0026gt; Package Model # The Regolith build system utilizes sets of JSON files to define what packages are specified for a given target. These JSON files are set in a specific structure to facilitate overriding higher-scoped contexts for lower-scoped contexts. For example, at the top level is the release directory. It specifies all packages for that release. Within a release, directories for specific distros exist. Package models in these directories may override or nullify packages specified from it\u0026rsquo;s parent. In this way, a top-level general package model can be tweaked for a given stage/distro/codename/architecture. To further illustrate this point here is the structure of the stage directory in the voulage repo (which is the name of the Regolith 2.x package builder) (NOTE: some files were removed for brevity):\nstage/ ├── package-model.json \u0026lt;--- Root package model ├── release │ ├── debian │ │ └── bullseye │ │ └── package-model.json │ ├── package-model.json \u0026lt;--- Package model for the release stage │ └── ubuntu │ └── jammy │ └── package-model.json ├── testing │ ├── debian │ │ └── package-model.json │ ├── package-model.json │ └── ubuntu │ └── jammy │ └── package-model.json └── unstable ├── debian │ ├── bullseye │ │ └── package-model.json │ └── testing │ └── package-model.json \u0026lt;--- Customizations for Debian Testing in unstable stage ├── package-model.json └── ubuntu └── jammy └── package-model.json Packages # As mentioned above, the build system generates packages for a given target from it\u0026rsquo;s manifest. The build system is designed to be agnostic to any particular package format. As such, package versions are not directly modeled in manifests. The mechanism that determines if a source change results in a version bump is delegated to package-manager specific extensions. After a package has been identified to require building, the build system delegates to the package-specific build system to generate the target packages, such as debian source and binary packages. If the package update builds successfully, another package-manager extension is called to inject the newly built package into the distro-dependant package repository.\nPackage Build System # The Regolith build system consists mainly of bash shell scripts. These scripts are run from GitHub workflows but are designed to be runnable directly from the appropriate local environment to facilitate easy testing and troubleshooting. The following is a high level summary of what the package builder does once invoked:\n Set up source state such as the target string, which is generated from \u0026lt;stage\u0026gt;-\u0026lt;distro\u0026gt;-\u0026lt;codename\u0026gt;-\u0026lt;architecture\u0026gt; Download the current manifest from the target repository Generate the merged package model starting from the root and working into each segment in the target string With the merged model, iterate over each package, generating a manifest entry by resolving the commit hash from the specified ref After all manifest entries are generated, compare the generated manifest with the earlier downloaded copy If no changes found, exit because no packages have changes on the specified refs Otherwise, package changes have been detected. Download the entire target repository For each difference found, delegate to distro-specific build package build and repo publish commands Publish the updated repository and manifest back to the target repository ISO Build System # The ISO builder is based on the open source project live-custom-ubuntu-from-scratch. The ISO builder uses a set of shell scripts to generate an Ubuntu ISO image for both a live environment and an installer. Regolith customizes this project in this repo with some specific packages to install and remove. A github workflow is used to generate the ISOs and upload them to GitHub for hosting.\nCookbook # How to add or update a package to the build system # Determine which stages, distros, codenames, and architectures the change applies to (ex: unstable-ubuntu-jammy-amd64) Edit the package model in the stage directory in the Voulage Add or edit the package stanza JSON for that package (example) Commit the change Execute the build workflow Once the build completes, check the releases in Voulage to verify that the generated packages were produced and published as expected How to determine what commit a package is built with in a given target package repo # Download the manifest contained in the target package repository (https://regolith-desktop.org/\u0026lt;STAGE\u0026gt;-\u0026lt;DISTRO\u0026gt;-\u0026lt;CODENAME\u0026gt;-\u0026lt;ARCH\u0026gt;/manifest.txt) Find the line containing the package name Note the branch and ref in the manifest, this is the repo commit from which the package was built How to extend the build system for a new package format # For an example read the Debian v4 build workflow Refer to the Debian extension script that the workflow uses Create an extension script that maps from the git source of each package to the target distro\u0026rsquo;s packaging format "},{"id":29,"href":"/posts/announce-regolith-2/","title":"Announcing Regolith 2","section":"Blog","content":"Introduction # Regolith 2 is the next major release of the Regolith Desktop environment. Here is a summary of the big changes in the release:\n Use i3 or i3-gaps interchangeably Simplify the loading of Xresources, discovery, and management of looks Support for i3 config partials, allowing for safer and richer extension capabilities Provide a package topography necessary for future changes including alternative sessions and backends Debian Bullseye support, along with Ubuntu Focal and Jammy Move to new custom desktop executor ilia from rofi for app and command launching, notifications, and more Regolith 1.6 is the end of the line for the existing Regolith desktop. The new major version 2 provides for a simplification of Regolith as a whole, with some new features as well. This upgrade will not be backwards compatible with 1.x series (but as always, users may choose to specify their own i3 config). However Regolith 2 is not radically different than the previous version. This major version bump is to allow for users to upgrade on their own schedules. As such, the 1.x package repository (PPA) will not be used for Regolith 2 packages.\nRelease Status # We\u0026rsquo;re currently in pre-alpha phase of the development process. The environment is generally stable for day to day work, however because we\u0026rsquo;re reserving the right to make big changes still, using it in a production context is not recommended at this time.\nShipped Changes # Convert i3 config to partials conf.d style Xresource discovery Migration from rofi to ilia as the desktop executor Migration to nerdfonts for looks to simplify and enhance font icons A new build system decoupled from launchpad.net facilitating easier and more consistent distro development Port of looks lascaille and nord from the 1.x looks Changes in Development # New website (this one!) Polish for ilia Bugs in wallpaper handling (gnome/dotfiles) Better HiDPI support out of the box Better first time user experience Porting most existing looks to new Xresource schema Rebranding from \u0026ldquo;Regolith Linux\u0026rdquo; to \u0026ldquo;Regolith Desktop Environment\u0026rdquo; Expected Release Date # Due to the volunteer nature of the Regolith project, it\u0026rsquo;s simply not possible to a promise ship date. However, we would like to have something usable by the time of the next LTS version of Ubuntu is released, in April 2022.\nExpected Upgrade Experience # The Regolith 2 desktop environment will require the removal of the existing Regolith 1.x PPA and the addition of a new Debian repository. regolith-desktop will continue to be the top-level package that provides the complete desktop environment. As before, i3 config files can be entirely controlled by users by staging a copy in their XDG user configuration directory, however with i3 4.20+, a new option of simply providing any additional configuration via config partials is also supported.\nLearn More # See here for details on how to install the current pre-release version of Regolith 2, and here for information on how you can provide feedback or contribute.\n"},{"id":30,"href":"/posts/attribution/","title":"Thanks to","section":"Blog","content":"The Regolith Desktop exists as an integration of many open source projects and a little bit of glue code and some unique desktop components. The Regolith project is built upon many projects.\nThe following projects in particular deserve special mention:\n The i3 community, including Michael Stapelberg and Ingo Bürk. The Rofi community, including Dave Davenport. Picom, an actively maintained desktop compositor, including yshui. The Gnome Flashback project, supported by Alberts Muktupāvels and Dmitry Shachnev. Other i3-GNOME integrations by Jesús Castro and Alex Palaistras. The i3status community, including Vivien Didelot. Design innovation by Arctic Ice Studio and Ethan Schoonover and Ayu Theme. Proper nouns sourced from the fiction of Alastair Reynolds. The beautiful GTK themes by Eliver Lara. Wallpapers by Psiu Puxa, Lucas Bellator, and Luca Bravo. Icons by Sam Hewitt. Simple and powerful build tools via the Cubic project by PJ Singh. Infrastructure by Canonical and GitHub. "},{"id":31,"href":"/posts/sway_integration_gsoc/","title":"Foundations for Regolith on Wayland (GSoC'22)","section":"Blog","content":"Introduction # Regolith is a modern desktop environment designed to let you work faster by reducing unnecessary clutter and ceremony. It offers a keyboard based workflow and a tiling window manager that allows efficient management of windows, monitors and workspaces. Built on top of Ubuntu, GNOME Flashback, and i3, Regolith stands on a well-supported and consistent foundation.\nIn its current implementation, the use i3 window manager binds Regolith to X11. While X11 is fairly mature, it was never built for modern systems and is based on assumptions that are valid only for computers of the ’90s. Some of the issues present in X11 based window managers are low framerates, poor support for HiDPi panels, higher latency, screen tearing etc. Wayland is a display protocol that is written from scratch and aims at simplicity and extensibility Wayland has been in development for quite some time now and its implementations are now stable enough to be considered for daily usage. In fact, many desktop environments like gnome are now providing their wayland implementations as default. Sway window manager was introduced as a drop-in replacement for i3. It is based on wayland and is devoid of most of the issues present in X11 based window managers and compositors.\n Note: The work described in this post was done as part of my Google Summer of Code (GSoC) 2022 project under the organisation CCExtractor.\n Objective # The project intends to achieve integration of swaywm with the regolith ecosystem. This means, compatibility with GNOME services, integration of a configuration management system, theming using regolith look and support for other extras provided by regolith in a wayland-based environment.\nIntegrating sway with regolith # In this section, I will described everything that I did to achieve sway integration with regolith. This required modifying several existing packages as well as writing code for new scripts and binaries.\nPorting the regolith app launcher (ilia) to wayland # After having a discussion with Ken, we decided that the most important part of a tiling window manager setup from a user\u0026rsquo;s perspective is the app-launcher. Regolith on X11 ships with its own app launcher called ilia. It also provides several features apart from launching apps. This includes showing keybindings, launching terminal commands, list applications and workspaces and search files just to name a few.\nIlia is written in vala and GTK. This means, ilia had support for wayland right out of the box. Despite this inherent compatibility, ilia seemed to crash everytime. After looking into the logs, I realised that the issue was not with ilia but with the way wayland roots (wlr) handles windows that need to be ignored by the compositor. Turns out, wlr provides an extension to the wayland protocols called wlr-layer-shell in order to handle panels and other applications that need to be positioned automatically. A client implementation of this protocol for GTK based applications is provided by the library gtk-layer-shell. To maintain support for both X11 and wayland, I check the XDG_SESSION_TYPE environment variable and use gtk-layer-shell library only if the session type is wayland.\nCurrently, the wayland compatible version of ilia is not packaged and exists in a seperate branch.\nTrawl - A backend agnostic configuration manager # Wayland lacks support for Xresources natively and requires the use XWayland. This might not be desirable as it forces users to enable Xwayland forcing them to be a part of a legacy ecosystem. This is the reason why we decided to create a display backend agnostic configuration manager that can be used by various applications. To maintain compatibility with the existing regolith ecosystem it was crutial to replicate the format and functionaility XResources as much as possible. Trawl is a file based configuration management system written in rust that tries to fulfill these requirements.\nTrawl is comprised of two parts - Configuration Daemon (trawld) and Trawl Client (trawldb). For IPC, it uses the DBus specification, which allows other applications to access trawl resources with ease. In fact, trawl comes with libraries for C and rust that make interaction with trawl clients hassle free. Trawl also tries to replicate most of the features provided by Xresources by replicating the functionality available using the xrdb CLI.\nSway - adding the set_from_resource command # Sway aims to be a drop in alternative for i3. But there are some features which make sense only within the X11 ecosystem, and one such feature is the set_from_resource command in the configs. This command allows users to set variables within the i3 configurations by querying XResources for specific keys. Due to the lack of XResources alternatives that are display backend agnostic, the creators of sway decided not to implement it, even if its at the cost of breaking compatibility with i3 configurations.\nRegolith relies heavily on XResources based configurations. This helps acheive functional configurations to some extent, such that you can replicate your window manager setup just by copying over your XResources and config partials. In order to maintain a consistent experience across the board, it was absolutely crutial to re-implement set_from_resource for sway.\nI created a fork of sway called sway-regolith which adds the set_from_resource command. In order to communicate with the trawl demon, I used the wrapper functions provided by the libtrawldb library, which provides several wrapper functions for the DBus methods. Finally, I renamed the sway binary to sway-regolith in order to allow the fork and the upstream versions of sway to co-exist.\nRegolith-displayd # In regolith, the de facto way for managing and changing settings is the use of gnome-control-center. Since the displays are managed by X11 in both i3 and Gnome on X11, the display panel of gnome-control-center works right out of the box. However, in the case of wayland based compositors and window managers like sway and mutter on wayland, the diplays are managed by the compositor itself. So gnome-control-center can manage displays only when mutter is the compositor in use.\nOn looking into gnome-control-center\u0026rsquo;s codebase, I discovered that the display settings are applied by communicating with the org.mutter.DisplayConfig DBus interface. So I created regolith-displayd, which creates a DBus interface with the same name. It primarily provides two DBus methods - GetCurrentState and ApplyMonitorsConfig. The GetCurrentState method gets the current configuration of monitors and maps it into a format understandable by gnome-control-center. Similarly, calls to the ApplyMonitorsConfig method applies the display settings changes made from gnome-control-center by mapping them into a format understandable by the IPC interface of sway.\nregolith-displayd also polls the sway IPC interface to check for changes in display configuration. If a change is detected, the MonitorsChanged signal is emmitted. gnome-control-center reacts to this message by making a call to GetCurrentState.\nIn order to achieve display configuration persistance, regolith-displayd generates kanshi profiles based on the displays that are currently in use. These configurations are then automatically applied whenever the same monitors are connected.\nRegolith-session # regolith-session package is probably the most important part of regolith as it essentially ties i3 with GNOME flashback. This package is also partly responsible for the regolith-look related functionality. The code for wayland version of the package can be found in the wayland-dev branch.\nMigrating regolith-session to wayland required work on the following sections.\nSession initialization script (regolith-session-wayland) # This script is responsible for loading the trawl resources set by the user, loading current look information, reformatting pango markup for workspace names, registering the session with gnome session manager and launching sway with the regolith configuration file.\n/usr/share/applications/regolith-wayland.desktop # This application file executes the regolith-session-wayland script. This application file will be read by gnome-session-binary while loading the Required Components from the session file.\n/usr/share/gnome-session/sessions/regolith-wayland.session # This file lists out the components required by the session in order to work correctly. If all the required components cannot be loaded, the session ends abruptly with an error. Most of these components are gnome-settings-daemon plugins. If the session is loaded using gnome-session --builtin, it launches the required components using their respective application files instead of launching their systemd services. The regolith-sway desktop file is also included in the required components section which launches ultimately starts the regolith session.\n/usr/share/wayland-sessions/regolith-sway.dektop # This file is read by the display manager / login manager and shows the entry Regolith on Wayland in the login screen. The command /usr/bin/gnome-session --builtin --session=regolith-wayland is executed as soon as you login. This command looks for /usr/share/gnome-session/sessions/regolith-wayland.session and loads the required components.\n/usr/lib/regolith/regolith-session-common.sh # This provides functionality that is used in multiple scripts (related to both X11 and wayland based sessions). It also contains some variables that are required by many of the scripts related to regolith-session. I\u0026rsquo;ve added several functions and environment variables that are required to provide functionality equivalent to what is provided by Regolith on X11 sessions.\nRegolith look script (/usr/bin/regolith-look) # This provides theming related functionallity, which is one of the defining features of the regolith ecosystem. I\u0026rsquo;ve added a check to determine if the current session type (X11 or Wayland). If the current session is wayland, trawlcat is used instead of xrescat and swaymsg reload is used instead of i3-msg refresh. When loading a look, if the current session is wayland, the configurations are loaded into trawl and if the session is X11, the resources are loaded using xrdb as XResources.\nRegolith Look # The functionality of the regolith-look script (located at /usr/bin/regolith-look) has been discussed in the previous section. In order to apply the theme, a loader script is required. This can either be provided by the look or the user. If no loader is provided, the default loader script (present in the regolith-look-default package) is used. To make this loader script compatible with trawl in wayland, I had to check if the current session is wayland and set the RESOURCE_GETTER variable to trawlcat accordingly.\nRegolith also uses gnome-terminal by default. So in order to provide terminal theming in wayland, the regolith-init-term-profile script also needs to use trawlcat as resource getter. This script is responsible for changing the terminal profile theme.\nRegolith-inputd # Similar to outut management, input management in wayland is also dependent on the compositor. This is the reason why changing input settings from gnome-control-center doesn\u0026rsquo;t work out of the box. In order to get the input panel of gnome-control-center to work, I created regolith-inputd, which monitors the gsettings schema org.gnome.desktop.peripherals. This allows to map changes in input properties to sway configuration commands which are then applied using the sway IPC interface.\nWhat\u0026rsquo;s next? # You can track work related sway integration in this GitHub projects page. All contributions are more than welcome. I have really enjoyed working on this project and I plan to continue even after I\u0026rsquo;m done with the final evaluation for Google Summer of Code.\nWhat doesn\u0026rsquo;t work # Lock Screen (Alternatives - swaylock) GNOME OSD overlays (Alternatives - wob) GNOME flashback / gnome-shell-related stuff Using any Display Manager other than GDM 3 causes issues swaybar status (requires several reloads to work properly) ilia keybindings page gnome-session-quit popup "},{"id":32,"href":"/docs/howtos/workspace-on-output/","title":"Assign a workspace to a specific Output (Display)","section":"How To","content":"i3 # NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. In order to configure i3 to assign a workspace to a given monitor, first find the device name for the monitor you wish to use with xrandr:\n$ xrandr --listmonitors Monitors: 1 0: +*eDP-1 1920/309x1080/173+0+0 eDP-1 In this case, the output name is eDP-1. Next add a line like this into a staged copy of your i3 config file:\nworkspace \u0026quot;$ws1\u0026quot; output DP1 Log back in for the changes to take effect.\nSway # The concept is the same, but swaymsg is used to display the available outputs.\n$ swaymsg -t get_outputs Output HDMI-A-2 'ViewSonic Corporation VG2448 V5E192121969' [...] To assign workspace $ws1 to the HDMI-A-2 output put the following line into a staged copy of your sway config file:\nworkspace $ws1 output HDMI-A-2 "},{"id":33,"href":"/docs/howtos/add-remove-blocklets/","title":"Change Bar Status indicators","section":"How To","content":"Adding or Removing status indicators # Finding Status Indicators # $ apt search i3xrocks- Installing a Status Indicator # $ sudo apt install i3xrocks-memory $ regolith-look refresh Customization of the i3 bar # Each status indicator on the bar is managed by a file. The name of the file maps to the position of the status indicator on the bar, e.g. a file\u0026rsquo;s name starting with 10_ mean its corresponding indicator will be positioned before an indicator which has a configuration file starting with 20_. Within each file there is some information that i3xrocks uses to execute a script that ultimately returns the data you see on the bar. Some of the status indicators have configuration parameters that can be adjusted to your liking. For example, if you would prefer that the battery status changes more frequently, the polling interval can be updated. The first thing to do in order to customize the bar is to copy the indicators you wish to see from /usr/share/i3xrocks/conf.d/ to ~/.config/regolith3/i3xrocks/conf.d. Each file in ~/.config/regolith3/i3xrocks/conf.d can be modified as you see fit. To change the order of status indicators on the bar, simply change the name of the files to the sort order you prefer.\nOnce you\u0026rsquo;ve made your changes, refreshing the session should cause the bar to update based on your new configuration.\nFor example, to change the order of the battery and net traffic blocks on the bar and not display notifications, perform the following steps:\n$ ls /usr/share/i3xrocks/conf.d/ 01_setup 30_net-traffic 80_battery 80_rofication 90_time $ mkdir -p ~/.config/regolith3/i3xrocks/conf.d $ cd /usr/share/i3xrocks/conf.d/ $ cp 01_setup ~/.config/regolith3/i3xrocks/conf.d/01_setup $ cp 80_battery ~/.config/regolith3/i3xrocks/conf.d/30_battery $ cp 30_net-traffic ~/.config/regolith3/i3xrocks/conf.d/80_net-traffic $ regolith-look refresh Note: If any block configuration exists in the user directory ~/.config/regolith3/i3xrocks/conf.d, then the defaults in /usr/share/i3xrocks/conf.d/ will be ignored.\nFurther Reading # The reference page for configurations has more details about the configuration files used with Regolith Linux.\n"},{"id":34,"href":"/docs/howtos/replace-notification-system/","title":"Change Notification Systems","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Regolith ships with a notification system called Rofication. It is designed to work in the background and not use pop-ups as a way of alerting the user to a new notification. Rather, a small bar item displays the current number of unread notifications and a dialog can activated to interact with the content of the current notifications. This page describes a way to install an alternative notification system which works in a more traditional way.\nWe will use dunst as an example but similar steps can be used with pretty much any other notification component.\n Replace rofication with dunst: $ sudo apt install dunst $ sudo apt purge regolith-rofication Log out and back in. Test your notifications with notify-send test123. You should see a pop-up notification from dunst. "},{"id":35,"href":"/docs/howtos/time-format/","title":"Change the Bar Date and Time Format","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. The time format (12 or 24 hour) can be specified in Settings:\nThe date format can be specified by selecting the appropriate region in Settings. A preview of the date format is provided, and logging back in is required for changes to take effect.\nThe date and time formats can also be explicitly set via Xresources. To do so, override the i3xrocks.date.format2 Xresource key. The format specification for date is simply the arguments that would be passed to the date command on the command line. For example, to print the year in 4 digits, specify +%Y.\n"},{"id":36,"href":"/docs/howtos/change-terminal/","title":"Change the Default Terminal","section":"How To","content":"The default terminal that ships with Regolith R1.4 is gnome-terminal, but any X terminal emulator can be used. To update Regolith to use your already installed terminal of your choice, use update-alternatives to specify it as default:\n Run update-alternatives --config x-terminal-emulator to see all available terminals installed on your system. Select the terminal you prefer. "},{"id":37,"href":"/docs/howtos/default-gap/","title":"Change the Default Window Gap","section":"How To","content":"Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. Like most configuration in Regolith, the i3-gaps gap size can be tuned via Xresources (See here for all Xresource definitions).\n Create or add the following value to your ~/.config/regolith3/Xresources file: wm.gaps.inner.size: 20 In this example we\u0026rsquo;re setting the default gap to 20 pixels.\nReload the Xresources configuration: $ regolith-look refresh Further Reading # See the reference page for configurations for more details about config files in Regolith.\n"},{"id":38,"href":"/docs/howtos/change-lockscreen/","title":"Change the lock screen program","section":"How To","content":"1. Configure gnome-flashback to Disable Built-in Lockscreen # By default gnome-flashback handles the lock screen for Regolith. This can be adjusted by modifying it\u0026rsquo;s configuration via the gsettings command line program:\n$ gsettings set org.gnome.gnome-flashback screensaver false 2. Cause Your Lock screen program to Run from i3 Keybinding # Specify the following override line in your ~/.config/regolith3/Xresources file (substituting your-script.sh with the command you wish to use for the locking your screen):\nRegolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. wm.program.lock: your-script.sh For example, assuming you have i3lock installed:\n$ echo \u0026quot;wm.program.lock: /usr/bin/i3lock\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources "},{"id":39,"href":"/docs/howtos/terminal-font/","title":"Change the Terminal Font Size","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Create or add the following value to your ~/.config/regolith3/Xresources file: gnome.terminal.font:\tJetBrains Mono 14 Reload the Xresources configuration: $ regolith-look refresh Open a new terminal to see the change take effect. "},{"id":40,"href":"/docs/howtos/change-workspace-icons/","title":"Change Workspace Icons and Labels","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Adding icons to workspaces can give your desktop a nice and functional look.\nFinding icons # Icons are actually characters from fonts installed by Regolith looks. Each look comes with a specific icon font. The icon font is defined in the typeface_bar variable in the typeface config file. For example, the look \u0026ldquo;Cahuella\u0026rdquo; uses the Material Design Icons font (see file /etc/regolith/styles/cahuella/typeface).\nYou can browse the icon font using the Gnome Character Map application from the gucharmap package:\n Open \u0026ldquo;Gnome Character Map\u0026rdquo;. Select your icon font in the top left combo. In the script pane select Common. Scroll down the characters pane until you find the icons. Double click on the icon you are looking to use and press the Copy button (bottom right). Tip: the icons are ordered alphabetically.\nChanging Icons # Follow these steps to override the default workspace label with your own:\n Find the character you want to use and copy to the clipboard. This example will use the Sigma glyph from Material Design Icons font (). Add a line to your Xresources overrides file with the workspace number and character you wish to use: Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. $ echo \u0026quot;wm.workspace.06.name: 6:\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources Refresh your UI: $ regolith-look refresh In i3, workspace labels are only updated when a workspace is created. Ensure you\u0026rsquo;re creating an new workspace 6 if following the example above:\nChanging Labels # The same approach can be used to specify textual descriptions of your workspaces. For example, adding the following lines to your ~/.config/regolith3/Xresources file will change the first three workspaces:\nwm.workspace.01.name: 1: Terminal wm.workspace.02.name: 2: Web wm.workspace.03.name: 3: Chat Adding support for icon fonts in text editors # Atom # Append the name of the icon font to Settings \u0026gt; Editor \u0026gt; Font Familly. Example: Menlo, Consolas, DejaVu Sans Mono, monospace, Material Design Icons Further Reading # See the reference page for configurations for more details about config files in Regolith.\n"},{"id":41,"href":"/docs/howtos/disable-unclutter/","title":"Disable Mouse Hiding (unclutter)","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. By default the mouse cursor disappears if unused for a few seconds. If you prefer that the mouse cursor always remains visible on the screen, follow these steps:\n Specify an empty value for the unclutter launcher program with an Xresources override: $ echo \u0026quot;i3-wm.program.unclutter: :\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources Log out and back in for changes to take effect. "},{"id":42,"href":"/docs/howtos/find-install-packages/","title":"Find and Install Packages","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Regolith is a Debian-based system. Debian packaging tools can be used to find and install packages.\nFind package via the command line # The apt command can be used to query installed or all packages:\n$ apt list --installed \u0026lt;package name\u0026gt; # finds installed packages $ apt list \u0026lt;package name\u0026gt; # finds all packages For example, to list all official Regolith looks that could be installed, run:\n$ apt list regolith-look-* ... To see which status indicators are installed on your system, run:\n$ apt list --installed i3xrocks-* Install packages via the command line # To install packages via the command line, again we can us the apt command, but must use sudo to gain the rights necessary for installation:\n$ sudo apt install \u0026lt;package name\u0026gt; To install the battery status indicator, run:\n$ sudo apt install i3xrocks-battery Find and Install Packages via GUI app # There are a number of apps that can provide a nice window interface on top of the apt packaging system, for example synaptic. Refer to the documentation for the tool of your choice to learn how to search for and install packages.\n"},{"id":43,"href":"/docs/howtos/customize-compositor/","title":"Customize Compositor","section":"How To","content":"How to customize your compositor (visual effects) # Pay special attention to this section if you are experiencing odd visual glitches or slow graphics performance. A compositor is a UI component that applies visual effects to windows before they are rendered on-screen. Many desktop environments integrate a compositor directly into the window manager, making it difficult to switch out or disable. In Regolith, the compositor is defined as a pluggable “extension point” in the packaging system. This means that compositors can be switched out simply by installing the packages that contain them. The underlying packaging system will ensure there are no conflicts and that all the dependencies of a given compositor are also installed.\nWARNING: In Regolith 2.x, the default compositor is \u0026ldquo;no compositor\u0026rdquo;. In Regolith 1.x, the default was Picom. Finding available compositors # The following command will list all compositors configured to work with Regolith:\napt search regolith-compositor- You should find at least the following:\n regolith-compositor-none [default]: No compositor. Best performance, no visual effects. regolith-compositor-picom-glx: Uses picom. Recommended for most users to resolve screen tearing and add visual effects. Modern and well-maintained fork of compton. Was the default compositor in Regolith 1.6. regolith-compositor-compton-glx: An ancestor of picom which is no longer maintained. regolith-compositor-xcompmgr: An early compositor that may offer more consistent performance if more complex compositors are problematic. Installing a compositor # Due to the way that the compositor is managed by i3-wm, you must log out and back in for compositor changes to take effect. Restarting i3 is not sufficient. Run the following package install command to swap out the compositor. In this case we’ll install picom:\napt install regolith-compositor-picom Log out and then log back in and the new compositor should be loaded. You can verify by checking the process list for picom:\nps aux | grep picom Overriding Regolith default compositor configuration # Compton/Picom # To provide your own Compton/Picom compositor config, copy the default or create your own and save it as ~/.config/regolith3/picom/config. Upon next session it will be loaded instead of the default config /etc/regolith/picom/config.\n"},{"id":44,"href":"/docs/howtos/hide-i3-bar-by-default/","title":"How to Hide i3-bar by default","section":"How To","content":"Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. Add the line\nwm.bar.mode: hide to $HOME/.config/regolith3/Xresources file. The next time you log in the bar should be hidden by default.\n"},{"id":45,"href":"/docs/howtos/install-sway/","title":"Install the Sway Compositor","section":"How To","content":"To install the wayland session, follow these steps:\n Install the regolith-session-sway package and it\u0026rsquo;s dependencies. Reboot Select \u0026ldquo;Regolith on Wayland\u0026rdquo; session in the login panel Hardware Support # Those using proprietary nvidia drivers for their graphics cards must set regolith.sway.unsupported_gpu: true in their XResources. This is not an issue with the open source drivers nouveau. See more here.\nBar Changes # The wayland session uses i3status-rs rather than i3xrocks. i3status-rs provides a crisper and more resource-efficient approach to system monitoring. However at this time the i3xrocks packages for status indicators are not integrated with i3status-rs. To use a custom configuration with i3status-rs, users will need to put their config file at the location of their choosing and they\u0026rsquo;ll need to set the wm.bar.status_config to the absolute path of their config file in their XResources. See the upstream project documentation for further details.\n"},{"id":46,"href":"/docs/howtos/floating-window/","title":"Launch an app in a Floating Window","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Most X11 applications support a flag --class to specify the class under which the application runs. Regolith is configured such that apps with a class of floating_window will launch with i3\u0026rsquo;s floating window mode.\nExamples # gnome-terminal # Launch the terminal in floating mode:\n$ gnome-terminal --class=floating_window Firefox # Launch Firefox in floating mode:\n$ firefox --class=floating_window "},{"id":47,"href":"/docs/howtos/vanilla-i3-gaps/","title":"Launch Default i3 Session","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. To do so on Ubuntu, run sudo apt install i3-gaps-session to add an option on login that starts vanilla i3-gaps without regolith.\nUse Case # This is useful for, say, running an application that does not integrate well with GNOME. For example, Spotify\u0026rsquo;s unmaintained official Linux client mishandles its file selection dialogue and crashes when\n Setting user profile photo Setting album cover photo Adding a local directory to the library paths under GNOME and Regolith. Switching to vanilla i3 solves the crash.\nSource: Ken\u0026rsquo;s comment on the relevant issue on GitHub.\n"},{"id":48,"href":"/docs/howtos/tdcli-blocklet/","title":"Manage a To-Do List","section":"How To","content":"Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to wm.foo.bar for Regolith 1.x and 2.x. td-cli is a command line todo manager written in Python3 for organizing todo lists across multiple projects.\nRegolith includes a status bar blocklet for accessing td-cli directly from the bar. It can be installed as follows:\nsudo apt install i3xrocks-todo After installing td-cli you can access it via command line using td. The full documentation of td-cli\u0026rsquo;s API can be found online at their repository. For example, let\u0026rsquo;s create a todo list with a group name of Regolith, set it as the default project, and then add a new task to this group:\ntd ag regolith td g regolith p td a \u0026quot;Write a Howto for td-cli\u0026quot; Now, if you click on the td-cli blocklet (on the left of the time blocklet in the figure below) a floating terminal opens up with an interactive instance of td-cli:\nYou can set this blocklet to only show number of uncompleted tasks in the bar by setting the following key in your Xresource file, for example, ~/.config/regolith3/Xresources:\ni3xrocks.todo.uncompleted: true By default, this key is set to false. Moreover, you can add a keybinding for accessing td-cli via a floating terminal by adding the following line to your i3 config file, for example, ~/.config/regolith3/i3/config:\nbindsym $mod+Ctrl+d exec --no-startup-id \u0026quot;/usr/bin/gnome-terminal --class=floating_window -e 'td --interactive'\u0026quot; Alternatively, you add these lines to your i3 config file, first:\nset_from_resource $wm.bindsym.1 wm.bindsym.1 : set_from_resource $wm.bindsym.program.1 wm.bindsym.program.1 : bindsym $mod+$wm.bindsym.1 exec --no-startup-id \u0026quot;$wm.bindsym.program.1\u0026quot; Then, add the followings to your Xresources file:\nwm.bindsym.1: Ctrl+d wm.bindsym.program.1: /usr/bin/gnome-terminal --class=floating_window -e 'td --interactive' "},{"id":49,"href":"/docs/howtos/minimal-ubuntu-install/","title":"Minimal Ubuntu Install","section":"How To","content":"This page describes how to install the Regolith Desktop into Ubuntu Server. This approach produces a minimal setup as many of the standard GNOME desktop packages present in a desktop install will be avoided.\nSteps # 1. Install Ubuntu Server # Follow online instructions for installing a fresh copy of Ubuntu Server versions either 20.04 or 22.04.\n2. Add Regolith\u0026rsquo;s package key and apt repository # Once Ubuntu Server has been installed, log into a terminal session. Use the following URLs to download the installation directions as a text file:\nUbuntu 22.04: https://regolith-desktop.com/install-release-ubuntu-22.04-amd64.txt\nUbuntu 20.04: https://regolith-desktop.com/install-release-ubuntu-20.04-amd64.txt\nExample:\nwget https://regolith-desktop.com/install-release-ubuntu-22.04-amd64.txt cat install-release-ubuntu-22.04-amd64.txt Manually execute each step in the text file, or source the file if you\u0026rsquo;re feeling adventurous. Once complete, the Regolith Desktop package repositories are installed into the new system.\n3. Install the Regolith Ubuntu System # There is a special package that is used in the ISO that can also be used in a minimal install such as this: regolith-system-ubuntu. This package includes extra branding not used in typical desktop installs which may share multiple desktop environments. Run the following command to install Regolith Desktop and all of it\u0026rsquo;s dependencies:\nsudo apt install regolith-system-ubuntu 4. Reboot # Once the system boots back up, the lightdm login manager will allow you to log into your new Regolith environment.\n"},{"id":50,"href":"/docs/howtos/override-xres/","title":"Override Xresources","section":"How To","content":"Regolith relies on the Xresources system to provide a consolidated interface configuration. By changing Xresources values, Regolith can be customized in ways such as updating the user interface, specifying custom behaviors, or defining a specific format for some of the blocklets on the bar.\nIn Regolith, Xresources values can be changed via two methods: supplying your own Xresources files, and overriding the existing Xresources values. The latter approach is strongly recommended, as it makes upgrading to newer versions of Regolith less likely to break your customizations. If you copy the Xresources tree completely you\u0026rsquo;ll need to integrate any breaking changes in future versions manually. Initialization # When a Regolith session is started, Xresources are loaded in the following order:\n File Optional Notes ~/.Xresources Y Intended for non-Regolith settings /usr/share/regolith-look/**/ N The Regolith Xresources associated with looks ~/.config/regolith3/Xresources Y Applies specific overrides to Xresources defaults It is recommended to use ~/.config/regolith3/Xresources for customization as it doesn\u0026rsquo;t require the specification of redundant settings and is easier to maintain over time.\nDetermining which values can be changed # The xrdb tool can be used to list the existing Xresources values. There is a number of existing overrides in the R2.1 release:\n$ xrdb -query [...] gnome.terminal.scrollbar:\tnever gnome.terminal.use-transparent-background:\ttrue gtk.document_font_name:\tSans 12 gtk.font_name:\tBitstream Vera Sans 12 gtk.icon_theme_name:\tPapirus-Dark gtk.monospace_font_name:\tBitstreamVeraSansMono Nerd Font 13 gtk.theme_name:\tAyu-Mirage-Dark wm.bar.background.color:\t#1F2430 [...] Examples # Note that the commands presented below append text to a file, so running the command more than once will result in duplicate entires.\nExample - Update the UI for High DPI Screens # By using the ~/.config/regolith3/Xresources override file, we will only need to specify the values we wish to change. The xrdb tool can be used to determine what current values are set to.\n Create or add the following value to your ~/.config/regolith3/Xresources file: Xft.dpi: 192 Reload the Xresources configuration: $ regolith-look refresh Open a new terminal to see the change take effect. 192 is just an example value, please adjust as needed.\nExample - Change i3 bar position # $ xrdb -query | grep position wm.bar.position:\tbottom $ echo \u0026quot;wm.bar.position:\ttop\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources $ regolith-look refresh Example - Change GTK Theme # $ xrdb -query | grep gtk gtk.theme_name:\tAyu-Mirage-Dark $ echo \u0026quot;gnome.gtk.theme:\tAdwaita\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources $ regolith-look refresh Example - Disable the System Tray # $ echo \u0026quot;wm.bar.trayoutput:\tnone\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources $ regolith-look refresh Example - Use Alt instead of Win as Super # $ echo \u0026quot;wm.mod: Mod1\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources $ echo \u0026quot;wm.alt: Mod4\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources Then Reload i3 for the change to take effect. Some settings may require logging back into the session, for example anything that i3 launches as a separate process.\nFurther Reading # See the reference page for configurations for more details about config files in Regolith.\n"},{"id":51,"href":"/docs/howtos/remove-unneeded-deps/","title":"Remove Unneeded Dependencies","section":"How To","content":"When Regolith is installed via ISO, only the necessary desktop components or packages are installed by default. However when installing Regolith into an existing Ubuntu system, some desktop components that Regolith does not require will still be installed on the system. There is nothing wrong with keeping these additional packages, in fact they are important if you wish to switch back to the default Ubuntu session at some point, however some users prefer to remove them.\nNOTE: Removing packages may cause unexpected behavior or loss of functionality. Install LightDM # The lightdm display manager can be installed by with a variety of themes, but we\u0026rsquo;ll install the package regolith-lightdm-config:\n$ sudo apt install regolith-lightdm-config Inspect the output of apt to verify you approve of the package changes. When presented with a menu, choosing between gdm3 and lightdm, select lightdm.\nRemove Unneeded Packages # Now that we are using the lightdm display manager, we can remove the unneeded packages:\n$ sudo apt remove gdm3 gnome-shell evolution-data-server* Inspect the output of apt to verify you approve of the package changes.\nNow we can remove all of the dependencies of those packages:\n$ sudo apt autoremove Reboot # At this point the unneeded dependencies have been removed from the system. Reboot to complete the procedure.\nUndo # If you decide that you\u0026rsquo;d like to restore the existing setup, run the following and select gdm3 as the display manager.\n$ sudo apt install gdm3 gnome-shell evolution-data-server ubuntu-session $ sudo apt remove regolith-lightdm-session "},{"id":52,"href":"/docs/howtos/stage-configs/","title":"Stage Config Files","section":"How To","content":"If you only wish to override or provide new Xresources values, staging configs is not required and not recommended. Overriding Xresources value is described in a separate article. Regolith uses a number of configuration files to determine the behavior and look of various components. While it\u0026rsquo;s possible to simply edit these files directly, users who do so run the risk of having their configurations overwritten upon future updates. The Debian packaging system should ask users if they wish to take updates or keep the existing files, but this may have unintended side effects if users take partial updates of files. As such Regolith, upon login, will look for user-staged version of configuration files and load those instead of the defaults if they exist. This is recommended over editing the files directly as it gives the user more control over their configuration. This page describes how to create these files.\nDepending on what you wish to change, you may need your own copy if the i3 config file. If you\u0026rsquo;re looking to change the way Regolith looks, Xresources may be all you need. If you want to update or add keybindings or swap out components, you\u0026rsquo;ll most likely need to stage the i3 config file.\ni3 Config # Copy the default Regolith i3 config file into your home directory: $ mkdir -p ~/.config/regolith3/i3 $ cp /etc/regolith/i3/config ~/.config/regolith3/i3/config Log out and back in. The Regolith session will automatically detect and load your user-staged file. Verify the Change # Verify by running i3 --moreversion and noting the config file that is printed as a result. It should be the copy you just created. If not, be sure the path is correct. It must exactly be ~/.config/regolith3/i3/config for Regolith to load it. "},{"id":53,"href":"/docs/howtos/multiple-batteries/","title":"Support Multiple Batteries","section":"How To","content":"i3 # NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Out of the box the primary battery status will be displayed in the i3-bar. For some laptops that have multiple batteries, e.g. ThinkPads, you want to have both batteries displayed:\n Stage your i3xrocks configuration files, then open ~/.config/regolith3/i3xrocks/conf.d/80_battery in your editor of choice. Find the line that pertains to the battery blocklet: # Battery indicator # # Displays total percentage charge left of specified battery. [battery] interval=30 # instance=BAT0 List all the battery instances running on your machine by running: ls /sys/class/power_supply/ # AC BAT0 BAT1 Update the staged config file to have a new blocklet as such: ... # Battery indicator # # Displays total percentage charge left of specified battery. [battery] interval=30 instance=BAT0 [battery] interval=30 instance=BAT1 Sway # Stage your i3status-rust config file: cp /etc/regolith/i3status-rust/config.toml ~/.config/regolith3/i3status-rust/config.toml Configure to supply i3status-rust with your config file: echo \u0026#34;wm.bar.status_config: ~/.config/regolith3/i3status-rust/config.toml\u0026#34; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources List all the battery instances running on your machine by running: ls /sys/class/power_supply/ # AC BAT0 BAT1 Update the staged config file to contain blocks for both of the batteries: [[block]] block = \u0026quot;battery\u0026quot; interval = 10 [...] device = \u0026quot;BAT0\u0026quot; [[block]] block = \u0026quot;battery\u0026quot; interval = 10 [...] device = \u0026quot;BAT1\u0026quot; Further Reading # See the reference page for configurations for more details about config files in Regolith.\n"},{"id":54,"href":"/docs/howtos/gnome-flashback-session/","title":"Verify behavior against upstream","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Regolith is composed of several existing open-source projects plus some additional custom packages. Sometimes when a bug is found in Regolith, actually it\u0026rsquo;s a bug in an upstream project. Determining the source of bugs is a first step in getting them fixed.\nCheck gnome-flashback # Most of Regolith\u0026rsquo;s GNOME support comes from the gnome-flashback project. To run a gnome-flashback session, install the session and log back in to your account after selecting that session from the login screen.\n Install the gnome-session-flashback session: sudo apt install gnome-session-flashback Restart your computer and then select the GNOME Flashback (Metacity) session as shown here: Verify your behavior against Regolith. If the problematic behavior also exists in gnome-flashback then the bug is likely there. If the bug does not exist in the gnome-flashback then it\u0026rsquo;s likely to be in Regolith. "}] \ No newline at end of file diff --git a/en.search-data.min.602c0b4a954cbb227ae880e0765bf3ddce3fc8db382da89eeb4c2cafb56b0809.json b/en.search-data.min.602c0b4a954cbb227ae880e0765bf3ddce3fc8db382da89eeb4c2cafb56b0809.json deleted file mode 100644 index 5126ce05..00000000 --- a/en.search-data.min.602c0b4a954cbb227ae880e0765bf3ddce3fc8db382da89eeb4c2cafb56b0809.json +++ /dev/null @@ -1 +0,0 @@ -[{"id":0,"href":"/posts/status_update_11_23/","title":"Status Updates Nov 2023","section":"Blog","content":"Regolith 3.1 \u0026amp; Ubuntu Mantic Support # Due to an issue associated with the Desktop Portal system and the GNOME implementation, that results in a severe usability regression, Ubuntu Mantic support has been delayed until it can be resolved. This change came into Regolith with the inclusion of GNOME 45 into Ubuntu Mantic. It looks like we\u0026rsquo;re getting some help from upstream, but it may be some time until we\u0026rsquo;re able to support GNOME 45-based distros if the solution ends up being that we need to implement our own portal backend to coexist with GNOME\u0026rsquo;s backend.\nAdditionally, Ubuntu 24.04 will be an LTS release and the people behind Ubuntu are putting extra work into it to ensure it\u0026rsquo;s a great one. We may end up forgoing Mantic support altogether if a short term solution does not present itself.\nUbuntu Summit 2023 # Soumya and I had the opportunity to travel to Riga, Latvia earlier this month to attend the Ubuntu Summit, graciously hosted by Canonical. There were a lot of great sessions and it was fantastic to reconnect with some familiar faces and collaborators from the previous year. So many brilliant and friendly people in one place!\nIn particular PapyElGringo announced a new project Veshell as a successor to the Material Shell project. I enjoyed learning about the spacial approach to app and workspace management, and look forward to seeing how the new project progresses.\nSoumya and I attended the Ubuntu Flavor sync session and were given several helpful contacts to work with as the Regolith project gets a closer association to upstream projects Debian and Ubuntu. Stay tuned for future news on this front.\nChat System Migration: Slack -\u0026gt; Matrix # Long-time Regolith contributor Leo had setup a Slack instance in the early days of the Regolith project. It was a great help and it was an effective tool for collaboration. Over time though, I and others in the project had a desire to move to an open platform. In part this is simply due to the risky nature of relying on \u0026ldquo;free\u0026rdquo; versions of commercial, proprietary platforms. Partly due to the Ubuntu\u0026rsquo;s adoption of the Matrix protocol for some community collaboration, I found it to be functional and easy to use. A Matrix \u0026ldquo;Space\u0026rdquo; for the Regolith project has been setup, any everyone is welcome to join. At some point in the next month or so we\u0026rsquo;ll retire the Slack server entirely.\n"},{"id":1,"href":"/docs/howtos/customize-i3-configuration/","title":"Customize i3 Configuration","section":"How To","content":"How to work with Regolith\u0026rsquo;s defaults # The default configurations are stored in /usr/share/regolith/i3/config.d. These are loaded alphabetically. Then user configurations in ~/.config/regolith3/i3/config.d are loaded, also in alphabetical order. Regolith\u0026rsquo;s default configuration is built to be customized by setting Xresources variables, adding user configuration, and adding or removing default configurations via apt. For this reason, there are several approaches to customization of i3 in Regolith that can be used separately or in combination to achieve your configuration cleanly:\n Use Xresources to override variables, e.g. keybindings, strings, program names, colors, etc. Add or remove Regolith default configuration files with apt Add your own user configuration files Replace Regolith\u0026rsquo;s configuration wholesale How to set an Xresources variable # The following configuration example (from /usr/share/regolith/i3/config.d/80_compositor) can be customized to load whatever compositor you want, without editing or overriding the existing i3 configuration file, by setting $wm.program.compositor.\nRegolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. set_from_resource $wm.program.compositor wm.program.compositor /usr/share/regolith-compositor/init exec_always --no-startup-id $wm.program.compositor To do this, simply add a line to ~/.config/regolith3/Xresources like:\n# Use my own home-made compositor wm.program.compositor: /usr/local/bin/my-compositor Similarly, you can override other i3 options with Xresources based on the variable names found in /usr/share/regolith/i3/config.d files:\n## Gap configuration wm.gaps.inner.size: 1 ## Border configuration wm.window.border.size: 3 wm.client.focused.color.child_border: #AAD3E9 ## Workspace names wm.workspace.01.name: 1:FOO For more, please read a more in-depth discussion on Xresources\nHow to uninstall a default partial # If you want to wholly replace or remove settings provided by a default partial, you can use apt to remove the package which provides that partial.\nTo identify the name of the package that provides the partial you want to remove:\ndpkg -S /usr/share/doc/regolith-i3-workspace-config The output contains the name of the package:\nregolith-i3-workspace-config: /usr/share/doc/regolith-i3-workspace-config Validate the full list of files provided by this package so you know what you\u0026rsquo;re removing:\ndpkg -L regolith-i3-workspace-config Remove the partial:\nsudo apt remove regolith-i3-workspace-config How to customize a default partial # WARNING: To customize only one of Regolith\u0026rsquo;s default partials, you must first ensure that the file ~/.config/regolith3/i3/config does not exist. This overrides Regolith\u0026rsquo;s defaults entirely, which is incompatible with this how-to. First, ensure that a directory exists for user config partials.\nmkdir -p ~/.config/regolith3/i3/config.d Then, copy the default configuration into your user configuration directory:\ncp /usr/share/regolith/i3/config.d/40_workspace-config ~/.config/regolith3/i3/config.d/ Make your desired changes:\nvim ~/.config/regolith3/i3/config.d/40_workspace-config Clean up the package containing the defaults:\nsudo apt remove regolith-i3-workspace-config Finally, restart i3 or log out and back in.\nHow to replace Regolith\u0026rsquo;s defaults completely # If you don\u0026rsquo;t want to keep any of Regolith\u0026rsquo;s defaults (for example, you\u0026rsquo;re an experienced i3 user with a complete personal config you want to use), you can either uninstall all of Regolith\u0026rsquo;s config partials, and/or create your own root config at ~/.config/regolith3/i3/config.\n"},{"id":2,"href":"/docs/using-regolith/install/","title":"Install","section":"Using Regolith","content":"Get Regolith 3.0 # If you\u0026rsquo;re upgrading from an earlier version of Regolith, you may be interested in reading the release notes and most specifically, the migration guide.\nPackages Specified at Install Time # In Regolith 3.0 it is now possible to select from multiple sessions (X11: regolith-session-flashback, Wayland: regolith-session-sway). Due to this, when installing Regolith 3.0 also specify one or both sessions that you wish to use. Additionally, it\u0026rsquo;s now possible to specify the Regolith Look at install time, which saves a setup of having to configure it later. Here is the recommended base install for X11 on Debian-based systems:\nsudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille # ^-- base package ^-- session ^ -- look For the session, you may chose one or both of: regolith-session-flashback (X11), regolith-session-sway (Wayland) For the look, you may chose one from any available look package: regolith-look-ayu-dark regolith-look-ayu-mirage regolith-look-ayu regolith-look-blackhole regolith-look-default-loader regolith-look-default regolith-look-dracula regolith-look-gruvbox regolith-look-i3-default regolith-look-lascaille regolith-look-nevil regolith-look-nord regolith-look-solarized-dark An an example and alternative to the recommendation above, here is the apt line to install the Sway session with the Nord Look:\nsudo apt install regolith-desktop regolith-session-sway regolith-look-nord Supported Operating Systems # Below are sections devoted to installing the Regolith Desktop on specific Linux-based operating systems.\nUbuntu # Ubuntu 23.04 Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | \\ gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg \u0026gt; /dev/null Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/release-3_0-ubuntu-lunar-amd64 lunar main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. Ubuntu 22.04 Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps (also available as a downloadable script) describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | \\ gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg \u0026gt; /dev/null Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/release-3_0-ubuntu-jammy-amd64 jammy main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. Ubuntu 20.04 Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps (also available as a downloadable script) describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | sudo apt-key add - Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64] https://regolith-desktop.org/release-3_0-ubuntu-focal-amd64 focal main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. Regolith Linux 2.2 ISO Regolith Linux is the Regolith Desktop environment installed into a customized Ubuntu 22.10 installer image. It allows one to boot from a USB drive to run Regolith without having to install it. It also allows to install the system onto a computer\u0026rsquo;s drive. Regolith Linux has the following features in addition to the Regolith Desktop:\n Regolith-branded boot and login screens Uses the lightdm display manager over gdm3 to avoid unneeded dependencies The following packages are not installed: gdm3, gnome-shell, ubuntu-session, evolution-data-server, snapd. These packages may be installed as needed by the user. Download Regolith Linux 2.2 See the Regolith 2.2 release notes for more information.\nThe ISO can be written to a USB drive on Linux using dd, GNOME Disk Utility, or the KDE ISO Image Writer. On macOS, use Etcher. On Windows, use Rufus and write in DD mode.\n Debian # Debian Bookworm Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps (also available as a downloadable script) describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | \\ gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg \u0026gt; /dev/null Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/release-3_0-debian-bookworm-amd64 bookworm main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-session-flashback regolith-look-lascaille System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. The regolith-desktop package installs a reasonable minimal configuration that should work on most hardware. To add additional package for a richer and more functional environment read Recommended Packages for New Users. The regolith-compositor-picom-glx compositor should work on most computers. If you experience driver or visual issues, try another compositor. Debian Bullseye Regolith can be installed as system packages. This makes updating and removing easier and more consistent. The following steps (also available as a downloadable script) describe how to configure your system to read packages from the Regolith package repository and install the desktop package.\n Register the Regolith public key to your local apt:\nwget -qO - https://regolith-desktop.org/regolith.key | \\ gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg \u0026gt; /dev/null Add the repository URL to your local apt:\necho deb \u0026quot;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/release-3_0-debian-bullseye-amd64 bullseye main\u0026quot; | \\ sudo tee /etc/apt/sources.list.d/regolith.list Update apt and install Regolith\nsudo apt update sudo apt install regolith-desktop regolith-compositor-picom-glx System Restart\n The login manager will need to be restarted for the new desktop session to be recognized. The easiest way of restarting it is to reboot your system.\nReplace amd64 with arm64 in the two places in the above line to install on ARM-based systems. The regolith-desktop package installs a reasonable minimal configuration that should work on most hardware. To add additional package for a richer and more functional environment read Recommended Packages for New Users. The regolith-compositor-picom-glx compositor should work on most computers. If you experience driver or visual issues, try another compositor. Release Change Policy # From Regolith 3.0 onward, all releases will use unique names in the package repo URL. This means that users will be in full control of when they wish to upgrade to a new release. Users wishing to have their package manager always install the latest version, a special stage called release-current is provided.\n"},{"id":3,"href":"/docs/reference/keybindings/","title":"Keybindings","section":"Reference","content":" Action Key Binding Launch - Application ⊞ Win Space Launch - Browser ⊞ Win Shift Enter Launch - Command ⊞ Win Shift Space Launch - File Browser ⊞ Win Shift n Launch - File Search ⊞ Win Alt Space Launch - Notification Viewer ⊞ Win n Launch - Terminal ⊞ Win Enter Launch - This Dialog ⊞ Win Shift ? Modify - Bluetooth Settings ⊞ Win b Modify - Carry Window to Workspace 1 - 10 ⊞ Win Alt 0..9 Modify - Carry Window to Workspace 11 - 19 ⊞ Win Alt Ctrl 1..9 Modify - Containing Workspace ⊞ Win Ctrl Shift ↑ ↓ ← → Modify - Display Settings ⊞ Win d Modify - Load Window Layout ⊞ Win . Modify - Move Window to Workspace 1 - 10 ⊞ Win Shift 0..9 Modify - Move Window to Workspace 11 - 19 ⊞ Win Ctrl Shift 1..9 Modify - Move to Scratchpad ⊞ Win Ctrl m Modify - Next Window Orientation ⊞ Win Backspace Modify - Save Window Layout ⊞ Win , Modify - Settings ⊞ Win c Modify - Tile/Float Focus Toggle ⊞ Win Shift t Modify - Toggle Bar ⊞ Win i Modify - Wifi Settings ⊞ Win w Modify - Window Floating Toggle ⊞ Win Shift f Modify - Window Fullscreen Toggle ⊞ Win f Modify - Window Layout Mode ⊞ Win t Modify - Window Position ⊞ Win Shift k j h l Modify - Window Position ⊞ Win Shift ↑ ↓ ← → Navigate - Next Workspace ⊞ Win Tab Navigate - Next Workspace ⊞ Win Alt → Navigate - Previous Workspace ⊞ Win Alt ← Navigate - Previous Workspace ⊞ Win Shift Tab Navigate - Relative Window ⊞ Win k j h l Navigate - Relative Window ⊞ Win ↑ ↓ ← → Navigate - Scratchpad ⊞ Win Ctrl a Navigate - Window by Name ⊞ Win Ctrl Space Navigate - Workspace 11 - 19 ⊞ Win Ctrl 1..9 Navigate - Workspaces 1-10 ⊞ Win 0..9 Resize - Enter Resize Mode ⊞ Win r Session - Exit App ⊞ Win Shift q Session - Lock Screen ⊞ Win Escape Session - Logout ⊞ Win Shift e Session - Power Down ⊞ Win Shift p Session - Reboot ⊞ Win Shift b Session - Refresh Session ⊞ Win Shift r Session - Reload i3 Config ⊞ Win Shift c Session - Restart i3 ⊞ Win Ctrl r Session - Sleep ⊞ Win Shift s Session - Terminate App ⊞ Win Alt q "},{"id":4,"href":"/docs/reference/Releases/regolith-3.1-release-notes/","title":"3.1 Release Notes","section":"Releases","content":"Regolith 3.1 Release Notes # Regolith 3.1 is a minor release focusing on Ubuntu 23.10 support and bug fixes.\nFeatures # Ubuntu 23.10 (Mantic) support Debian Testing support for Wayland session i3-next-workspace ported to Sway regolith-control-center rebased from GNOME 45 (for supported disto releases) Installation Instructions # Follow the standard installation instructions, but substitute testing instead of release-3_0. For example, this is the apt line for Ubuntu Mantic:\necho deb \u0026#34;[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \\ https://regolith-desktop.org/testing-ubuntu-mantic-amd64 mantic main\u0026#34; | \\ sudo tee /etc/apt/sources.list.d/regolith.list After apt upgrade is complete, verify that Regolith 3.1 is installed by:\n$ cat /etc/regolith/version REGOLITH_VERSION=3.1 A reboot is required for the new version to load.\nChangelog Delta from Regolith 3.0 # Changes in regolith-displayd # aa3d572 fix: cannot reenable monitors c4ebc88 fix: disabled monitors should reflect in mointors instead of logical_monitors 5cdb6df feat: add support for builtin monitor Changes in regolith-i3xrocks-config # 320980c fix: relax dependency on control center. Changes in regolith-session # dafa3b7 fix: add (soft) dependency to xdg-desktop-portal-regolith due to gnome 45 interop issues. 1a1c5e0 fix: set XDG_CURRENT_DESKTOP, overriding previous value if already set 8f5da99 fix: set XDG_CURRENT_DESKTOP for wayland session (fixes screencasting) Changes in regolith-wm-config # ea53b18 fix: make all non-root config partials soft dependendencies for more flexibility 6bd920a chore: rename resources namespaced in regolith.clamshell.* to wm.clamshell.* 04eee9b feat: implement clamshell functionality for sway db38632 fix: force removal of deprecated ilia integration package 7f1bae9 fix: enable carry mode in childe b9d42e8 fix: prevent broken legacy package from remaining installed for next-workspace 6992986 fix: properly segment i3 and say versions of next-workspace partial b36e821 feat: add next-workspace feature to sway session, copied from x11 i3-next-workspace 6356077 [15_base_launchers] add vm.program.browser a777246 [15_base_launchers] add vm.program.terminal 9b1706d Move default-style to soft dep for both sessions. demote 3 more for sway session to soft per PR feedback d21c32c fix: remove (redundant) hard dependency from sway session to rofication. Soft dependency comes via regolith-wm-config. Changes in sway-regolith # 75311f9a update patch filename for consistency b94bd17b fix: do not ship wallpaper, provided by sway-wallpaper package 6e56e53f fix: remove git versioning and fix c warning to appease debian builder on mantic 8dd63940 feat: upgrade packaging to sway v1.8.1 2a2e3b93 fix: include wl_protos_src in sway_sources 9160dab1 feat: apply patch for dbus tray menu 34f5363c Applied patch for regolith compatibility 227ac44a debian: import packaging from v1.7 Changes in sway-audio-idle-inhibit # 162c01f chore: bump libwlroots dependency version Changes in trawl # dfcabfb chore: pin zvariant version to 3.4.1 Changes in xdg-desktop-portal-regolith # Initial implementation, forked from xdg-desktop-portal-elementary. "},{"id":5,"href":"/docs/reference/configurations/","title":"Config Files","section":"Reference","content":"Config file quick reference # Component Default Config User Config Notes i3 / i3-gaps /etc/regolith/i3/config, /usr/share/regolith/i3/config.d ~/.config/regolith3/i3 Extend Regolith2 config by creating config.d and partials in the user config dir, or globally override it by creating config. More Xresources /usr/share/regolith-look/default ~/.config/regolith3/Xresources ~/.Xresources is also loaded but intended for properties that may also be required in other desktop sessions. More Bar status indicators /usr/share/i3xrocks/conf.d/ ~/.config/regolith3/i3xrocks/conf.d Each block has it\u0026rsquo;s own file. Configs loaded in filename alphabetical order. More Picom (Compton) Compositor /etc/regolith/picom/config ~/.config/regolith3/picom/config More WARNING: Adding an i3 config file in ~/.config/regolith3/i3/config will essentially override all Regolith configuration including Xresources and looks. History # Config partials # Regolith 2.0 adds support for config partials, as this feature came to i3 recently in 4.20. This is done by includes. This support for includes enables Regolith 2.0\u0026rsquo;s use of the package manager to add or remove default configuration partials. By installing and removing packages, i3 configuration can be customized for specific preferences while still allowing to track upstream changes for aspects of the configuration that need not vary.\nThe root Regolith configuration file at /etc/regolith/i3/config loads partials like so:\n# Include any regolith i3 partials include /usr/share/regolith/i3/config.d/* # Include any user i3 partials include $HOME/.config/regolith2/i3/config.d/* "},{"id":6,"href":"/docs/using-regolith/first-launch/","title":"First Launch","section":"Using Regolith","content":"First Launch # Regolith\u0026rsquo;s default interface lacks any visual hint as to how to launch applications or perform other common tasks. This can make the first time experience a bit confusing. However using the Regolith interface is relatively simple by only committing the following two keybindings to memory:\n Action Keybinding Purpose Keybinding Viewer super shift ? View and execute available keybindings App Launcher super space Launch a desktop application The Super Key # Most keybindings you\u0026rsquo;ll be using with Regolith start with the super key. This key typically says \u0026ldquo;WIN\u0026rdquo; 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.\n Entering one of these keybindings will cause a launcher dialog to pop up on the focused monitor. Both of these dialogs have the same general interface:\n The interface, a program called ilia, has a text entry widget at the top, followed by a list selection widget. The general usage pattern for these dialogs is to select an item from the displayed list. Begin typing to filter the selections, and use the arrow keys to make a selection. Pressing enter will cause the selected item to be activated. For keybindings, this means a keybinding will be manually executed. For apps, the selected application will be launched.\nKeybinding Viewer # The keybinding viewer\u0026rsquo;s purpose is to make finding and learning the Regolith keybindings quick and easy. A reference to the keybindings is available on this site, however it\u0026rsquo;s faster to simply bring up the dialog and search for the action you are looking for. Once found, the keybinding can be executed either with the keyboard or by selecting the item in the dialog.\nApplication Launcher # A fundamental task of any desktop environment is to enable users to launch applications. In Regolith this is done via the app launcher dialog. As with keybindings, the dialog first shows a list of all available desktop applications. Begin typing to filter the selection and use the arrow keys to specify a specific selection. Press enter to launch the selected application.\nNext Steps # Have a look at the basics page to learn more about the Regolith interface.\n"},{"id":7,"href":"/posts/repo-url-change-2.1/","title":"Package URL change for 2.1","section":"Blog","content":"Summary # For the Regolith 2.1 release, the host name of the URL from which apt pulls packages has changed. The new hostname is regolith-desktop.org. In order to update to Regolith 2.1 and get fixes and upgrades going forward kindly update your apt configuration.\nThe old apt URL:\n/etc/apt/sources.list.d/regolith.list:\ndeb [arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] https://regolith-desktop.io/release-ubuntu-jammy-amd64 testing main ^ | (this changes to '.org') The new apt URL:\n/etc/apt/sources.list.d/regolith.list:\ndeb [arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] https://regolith-desktop.org/release-ubuntu-jammy-amd64 testing main All other aspects of the package configuration remain the same including the key used to verify packages.\nAdditional Info # The Regolith 2.1 release reintroduced the ISO form of distribution. In order to generate the ISO with the production apt URL the packages needed to be published first. This essentially required a way of publishing the release before we wish users to get access to the packages. In order to achieve this the idea of using a URL and switching the host seemed like a good idea. Problems occurred when the realities of TLS cert management became apparent. When the domain was remapped to the new host, the TLS certificates were not. Later, when the problem became known, the hosting provider gave advice on how to resolve the problem. However, the original source domain name (regolith-desktop.io) somehow is not able to take a new cert registration from the new host. Some remedies have been suggested by users, but due to the nature of the production host we opted to leave the system as-is and migrate to the new domain to prevent further churn for users.\nWhen the 2.1 release was published, the URL was updated to regolith-desktop.org. Users still using regolith-desktop.io will most likely be stuck on the 2.0 release unless the TLS certificate issue is ignored or in some way resolved.\n"},{"id":8,"href":"/docs/reference/Releases/regolith-3.0-release-notes/","title":"3.0 Release Notes","section":"Releases","content":"Regolith 3.0 Release Notes # Regolith 3.0 is a major release focusing on a new Wayland-based session, Debian 12, and Ubuntu 23.04 support.\nNew Major Features # Ubuntu 23.04 (lunar) support Debian 12 (Bookworm) support Alpha release of Wayland session based on the Sway compositor (See migration guide) Migration Guide # Important information for existing Regolith users The directory for user-staged configuration files has changed from ~/.config/regolith2 to ~/.config/regolith3. To generalize across X11 and Wayland sessions, Xresource keys have been renamed to remove \u0026ldquo;i3-\u0026rdquo;. This means that users with XResource overrides on earlier versions of Regolith will need to update the key names. Specifically, keys starting with i3-wm now start with wm. For example, in Regolith 2.x to change gaps size, i3-wm.gaps.inner.size is being renamed to wm.gaps.inner.size in Regolith 3.0. Some functionality may now require you to install certain packages manually. An example here is the regolith-wm-user-programs package that runs programs defined in your Regolith configuration declared by wm.program.\u0026lt;N\u0026gt;:. Changelog Delta from beta 3 to beta 4 # Changes in regolith-displayd: # 4e2606b feat: add fractional scaling for resolutions greater than 1920 x 1080 0ea712d chore: linting changes Changes in regolith-i3xrocks-config: # 3eed9da Package changes 7f25895 Use a … instead of ... to show more of the artist and title (#143) 2f73725 Use value colors for battery percentage and charge (#148) Changes in regolith-session: # 37f0773 fix: add conflicts to avoid collision on ext package c0bf9b8 move autostart file to new package 76d8d1d fix: move idle autostart file to seperate package as soft dep to maintain compat w/ upstream flashback c072b4f fix: path to idle monitor daemon incorrect e092d1d fix: Ship idle monitor autostart desktop file. Addresses https://github.com/regolith-linux/regolith-session/pull/15 7f76fdf fix: install picom compositor by default on x11 session 59120ee feat: enable loading of last installed theme on first session install in xorg session fe33317 fix: changelog version invalid b8c6564 fix: on first lanch of sway session, call load_look() function to setup environment 9c9c42b add error handling in case that Xres/trawl look path is invalid f67e8ac feat: if a look is not set in xres/trawl, load the most recently installed look instead of default 0389967 fix: push regolith-default-settings down to x11 session, possibly unneeded for wayland (experiemental) Changes in regolith-wm-config: # f5892dc fix: inconsistent behavious of XF86AudioPlay ba26d1f chore: update homepage d85be5a fix: add i3 gaps to debian control Changes in regolith-desktop: # 821c31c fix: push regolith-default-settings down to x11 session, possibly unneeded for wayland (experiemental) Changelog Delta from beta 2 to beta 3 # Changes in regolith-wm-config: # d95e330 fix: inconsistent behavious of XF86AudioPlay 9d98515 fix: add i3 gaps to debian control 32fd6d4 Remove deprecated dependency i3-gaps 21da9b6 Fix conflict between deprecated regolith-wm-ilia and wm specific updates 6e697ad fix: add missing package declaration in control 05b8e9d fix: use 'bindsym --to-code' on sway for more consistent key mapping behavior with i3 Changes in regolith-session: # e0012a4 feat: add additional diagnostic infor about the current session Changes in ilia: # 62aef17 fix(wayland): ilia returns empty keybindings page if a directory included in the configs doesn't exist c3a03f8 more window manager agnostic renames 8cfc7e3 rename I3Client to IPCClient c78fa1b rename read_i3_config to read_config Changes in regolith-i3xrocks-config: # 7f25895 Use a … instead of ... to show more of the artist and title 2f73725 Use value colors for battery percentage and charge Changelog Delta from beta 1 to beta 2 # Changes in regolith-wm-config: # 445edee feat: add common directory for shared configs between i3 and sway d3c5ca2 fix(#866): incorrect path for i3 user config directory Changelog Delta from Regolith Desktop 2.2 to 3.0 # Changes in regolith-session: # 41dbd95 Making regolith-look-default hard dependency f17a946 Migrate to wm agnostic packages in x11 c5e7900 version bump f5a9901 Minor cleanup of package metadata 14e41f7 Changed source package format 3f042ff Add ilia and rofication and associated config to sway session recommends for usable setup 765ba57 Add dependency on virt look package to ensure resources are loaded a98da23 Change package format 385c478 Fixed workspace naming for resource cleanup e78230a Added gnome-terminal to recommends c4e17b3 Prevent loading the incorrect look 49b09f7 Added gnome-settings-daemon as dependency for regolith-session-sway 9968419 Move desktop dep to flashback session to keep desktop wm indenpendent 5aba956 cleanup 5f9f1d0 Update package deps for wayland 32f9eb9 Use quilt packaging format in hopes of resolving build error be04b61 Update package metadata, attempt fix of regolith-diagnostic confict 5e80731 Fix version so package will build into repo a6b7daa Send tick before reload on sway c1bdf0f Remove RfKill from required components 4c5aa9d Add regolith-sway-config as dependency 71d906a Updated depends for regolith-session-sway 9ee4d88 Fix look not loading on startup 03ab9a4 Load environment variables from systemd-environment-d 933ccbf Fixed typo 9c9a33a Added support for unsupported GPU Changes in i3-wm: # b85da284 release i3 4.22 Changes in regolith-look-default: # d1f8351 Update upstream theme package for lunar 403c89a Remove i3 from wm filename 57af57f Refactor xres namespace to be x11 agnostic. i3-wm -\u0026gt; wm Changes in regolith-look-extra: # e7c9247 Remove i3 from wm filename 8076d02 Refactor xres namespace to be x11 agnostic. i3-wm -\u0026gt; wm ad3ec5f Lighten borders of inactive/unfocused tabs d33d503 Add README placeholders for testing workflow 7d78827 Style unfocused/inactive tabs the same way as inactive workspaces 0f88ed5 Revert change to original theme palette 67c946e Use darker color for nord base02 cbfd4e6 Cleanup deprecated picom options a6ea33d Misc tweaks to extra looks Changes in i3-next-workspace: # fc40c1f Relax search on workspace name to work with Regolith 3.0 Changes in regolith-i3xrocks-config: # e70a24b fix(keyboard-layout): open keyboard menu instead (#145) Changes in regolith-desktop: # e44a757 Update dependencies for support of x11 and wayland (#812) 291c3be Version bump for next release Changes in regolith-ftue: # 017a50b Update sig for build Changes in regolith-compositor-picom-glx: # 0d7ad22 Remove deprecated picom options Changes in ilia: # 86f5694 Bump version to sync w/ jammy branch b8ea9d6 add keybings to help 5e096d6 add missing vim keybinding to navegation fe91a57 Fix all page mode curor navigation. 490ef9e Fix inconsistent widget focus init with new page function. bd977ec Remove async app loading for https://github.com/regolith-linux/ilia/issues/51 Changes in regolith-rofication: # 399b528 Remove wm dependencies for wayland support Changes in regolith-wm-config: # cbe6f87 fix: incorrect arguments to hide_cursor 7b3149b fix: add missing control entry for regolith-sway-unclutter 7ce2e40 fix: add missing .install file for regolith-sway-unclutter cf333da fix: XF86AudioPrev didnt play the previous track e36deff Remove duplicate \u0026quot;Shift\u0026quot; 59d2dba Add regolith-sway-polkit to depends ed5ccfa Packaging changes 88cca6b Fix gtklock binding not working when wallpaper not set 7d7550c Added regolith-sway-gtklock to recommends of regolith-sway-root-config 702d92d Remove unknown information fields 4ed1662 Added config for regolith-sway-audio-idle-inhibit 4f8c2e5 Fix typo e42d548 Add expected packages to recommends 3a11528 Removed redundant variable initialization c943500 Add locked flag to some keybindings 447498c removed self-conflict and self-replace for regolith-wm-control-center e437d32 Added packages to regolith-sway-root-config 'Recommends' 8ca9ab3 Updated package version 11a12bf Replace source package regolith-i3-config with regolith-wm-config f258e51 Remove regolith-wm-session dependency from regolith-wm-config binary package fc23d0c Fixed workspace names on initial load, sway 9117eeb Config fixes 5b9b7fe Fixed packaging daebaf4 Updated sway/config.d/81_gsd_integrations and added regolith-powerd as dependency 6b1e430 Exec regolith-powerd on wm_startup, regolith-displayd 324da56 Added config partial for gtklock 01127a5 Add config partials and i3status-rust config 46d09bb Fixed dependencies 9bf981f More whitespace cleanup in debian control b81cde0 Debian package fixups. Add changelog entry c02c847 Renamed conf.d directories to config.d f31cd23 Added packages to configure sway session 1905f46 Changed variable naming for sway configs ccf73eb Add root config files and packages for the root config files for i3 and sway. 01b139c Update file packages based on feedback from PR. d89da22 Initial import of debian and wm config from legacy regolith-i3-config repo 09fd304 Initial commit from regolith-i3-config "},{"id":9,"href":"/docs/using-regolith/basics/","title":"Basic Usage","section":"Using Regolith","content":"Usage # Launch an Application # After the first login, the screen will contain a bar at the bottom and some keyboard shortcuts in a dialog. This dialog, ilia, provides assistance for finding keybindings for various actions in the desktop environment. It may be dismissed with the esc key and invoked again with super shift ? . To launch an application, press super space and a similar dialog will load with 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 those that match. You can also scroll through the list with the arrow keys.\nNavigate to a Window # 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\u0026rsquo;s containing workspace and set its focus.\nCreate a new Workspace # Workspaces (also known as \u0026ldquo;virtual desktops\u0026rdquo; in some desktop environments) are a primary way by which windows can be managed. Each workspace provides a screen for an independent set of windows. To create or navigate to an existing workspace, specify it\u0026rsquo;s index with keys super 0-9 .\nFind 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. Pressing enter on a selection will cause the file to be invoked with the xdg-open command.\nTerminal # The terminal is a special application that has its own keybinding, super enter .\nBrowser # The preferred browser is also special and can be launched with super shift enter .\nQuit an Application # super shift q will quit the focused application. For misbehaving apps, super alt q will force quit (kill) the focused application, but note that any unsaved data may be lost.\nSwitch 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.\nWorkspaces can also be paged forward and backward via super tab and super shift tab .\nConfiguring the System # The Settings app (also known as regolith-control-center) is the primary interface for common configuration tasks, such as 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 Regolith Settings app.\nView Keybindings # All keybindings used by the Regolith desktop can be viewed, sorted, and executed by ilia. This dialog is launched with super shift ? .\nManage Notifications # Regolith\u0026rsquo;s desktop notification system is designed to prevent pop-ups that may distract the user from their work. Notifications can be viewed and managed in ilia via super n . Specific keybindings such as deleting one or groups of notifications may be found on the help tab of the dialog. For users wishing for more visibility of current notifications, the status indicator i3xrocks-rofication may be installed via the system package manager. This will show the number of critical and normal unread notifications on the bar.\n"},{"id":10,"href":"/docs/reference/Releases/regolith-2.2-release-notes/","title":"2.2 Release Notes","section":"Releases","content":"Regolith 2.2 is a minor release focusing on bug fixes and Ubuntu 22.10 support.\nNew Features # Ubuntu 22.10 (kinetic) support Wallpaper may be changed in regolith-control-center on Ubuntu Kinetic and Debian Bookworm. Bug Fixes # i3-swap-focus now available as released in 2.1 Numerous fixes and polish added to ilia Known Issues # No localization for ilia Changelog Delta from Regolith Desktop 2.1 to 2.2 # Changes in regolith-session: # 0ce56b5 Remove no longer shipped file eb699d6 Depend on virtualized config ui package c15ced1 Move default ui packages from default look to flashback session since default doesn't need to be installed 82424f8 Revert changes to Xsession. Due to field variance ilia will manage app path list external to XDG_DATA_DIRS 7262b91 Consistently specify search path for xres loading 0047f4d File checks allow symlinks. Address https://github.com/regolith-linux/regolith-desktop/issues/732 Changes in i3-wm: # 39afa033 release i3 4.21.1 Changes in i3-gaps-wm: # a8546a08 release i3-gaps 4.21 Changes in regolith-i3-config: # 7c0663c Fix dep decl for retired package 321220f Virtualize control center bindings to support both upstream and regolith-control-center 9acba1a Add work around for border issue https://github.com/i3/i3/issues/5149 72045f8 Add padding to workspace indicator on bar for simple looks 7865f93 Simplify font spec in i3 workspace label. Allow xres override of bar font to address https://github.com/regolith-linux/regolith-desktop/issues/730 b1cf838 Allow resize increment to be specified via xres. Address https://github.com/regolith-linux/regolith-i3-config/issues/11 3deafab Change float modifier due to change in gtk4 cfe26d7 Fix keybinding comment for swap focus Changes in regolith-look-default: # 2f1ab33 Add border around ilia dialog for better contrast c2cb660 Remove recommends from default, moving upstream so avoid issues when users do not opt to install the default look 0577cbe Simplify font spec in i3 workspace label. Allow xres override of bar font to address https://github.com/regolith-linux/regolith-desktop/issues/730 deba53b Add conflicts to prevent package install failure ff98eb4 Decompose look and loader script for cleaner dependency. Use virtual package for resource loading to generalize between x11 and wayland 1942cee Added support for wayland Changes in regolith-look-extra: # 3c35ea5 Add border around ilia dialog for better contrast fa39ffe More color mapping fixes e5e786b Fix missing color specs add5508 Simplify font spec in i3 workspace label. Allow xres override of bar font to address https://github.com/regolith-linux/regolith-desktop/issues/730 408fa51 Cleanup dependencies to default look f3da9b9 Fix package metadata for regolith-look-2 virtual package, found by Matt Fischer c3076f0 Make gruvbox i3xrocks values a brighter color e0e049a Fix paths to compositor a7018ec Decouple picom from looks. relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 f70c4de Remove picom as a dependency of Nord and Nevil looks 632c175 updated Debian package metadata to install moka-icon-theme 1287be9 Add missing regolith-look-ayu-mirage look to debian packaging Changes in i3-next-workspace: # e886bf5 Predicate list building on presence of seperator character. Attempt building from anon workspace Changes in regolith-i3xrocks-config: # c524c6e Remove floating flags for gtk4 breaking change in regolith-control-center 963c2b8 Add scrolling as inputs to media-player (#141) 425fe9e Try to use bluetooth device alias instead of name (#142) f3e9e48 Depend on netcat-openbsd due to bsd specific options used. Address https://github.com/regolith-linux/regolith-desktop/issues/635 e7d7c3f volume: extract toggle, volume_up, volume_down functions for easy rebinding (#140) 7ec4e6c Exit 0 if network device unfound to avoid spamming logs 659f13e Fixed volume and microphone mixer_value to display values below 10 and (#137) 2d09694 Rename install file for tailscale (#138) Changes in regolith-ftue: # b8255d6 Add missing dependency Changes in regolith-compositor-compton-glx: # 7980eb1 Allow config to be specified by Xres. Relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 Changes in regolith-compositor-picom-glx: # ee673f1 Allow config to be specified by Xres. Relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 Changes in ilia: # fe610d8 Fix unicode support in tracker 936ef27 Fix all page mode cursor navigation 1634bfc Fix inconsistent widget focus init with new page function 1359f9b Remove async icon loading to fix intermittent missing icons. 0612d2c Revise app launch logic based on available APIs on focal bb5549e Implement emacs and vim key nav. Misc cleanup f9defff Add version param 27b4682 Refactor app launching to use a context to track launch status. 0ed7873 Add slight border to window in cases where background does not provide contrast 164b0a6 Experimental change to app dialog to delegate to glib for desktop app source. Better local performance 3a8ced2 Follow symlinks to desktop apps. Misc cleanup 881358d Add flatpack dir to scan for desktop apps to address https://github.com/regolith-linux/ilia/issues/49 675c63d Add snap app dir to default paths to enable firefox to be found on kinetic d1573ff Update version in build. Do not sort textlist entries. Add flag for no icon in textlist. 6e4de4a Update selection logic to address https://github.com/regolith-linux/ilia/issues/44. Misc cleanup 4683479 Simply use URI to launch selected app from tracker page. Address https://github.com/regolith-linux/regolith-desktop/issues/716 f9eacc0 Move from XDG_DATA_DIRS to dconf source for desktop app paths f1dd370 Ignore i3bar explicitly with looser filter d151347 Include windows in window list containing empty value for 'window_type'. Addresses https://github.com/regolith-linux/ilia/issues/43 753160d Close dialog on selection for tracker page. exit regardless of error state in desktop app and tracker pages. Address https://github.com/regolith-linux/ilia/issues/39 Changes in xrescat: # bd6a6cb Add virtual package regolith-resource-loader for future wayland support "},{"id":11,"href":"/docs/using-regolith/configuration/","title":"Configuration","section":"Using Regolith","content":"Recommended Packages for New Users # Looks # Install all of the official Regolith looks:\nsudo apt install regolith-look-* Alternatively, apt will list available looks that may be installed:\napt list | grep regolith-look- NOTE: this may pull in fonts, themes, and wallpapers. For users looking to minimize disk usage, uninstalling looks that are unused is recommended.\nSee below for details on how to select a look.\nStatus Indicators # The following snippet installs status indicator packages recommended for new users:\nsudo apt install i3xrocks-focused-window-name i3xrocks-rofication i3xrocks-info i3xrocks-app-launcher i3xrocks-memory To remove any of these indicators later, simply uninstall them from your system. Example:\nsudo apt remove i3xrocks-info Laptop Battery Status # View the current battery status on a laptop:\nsudo apt install i3xrocks-battery Compositors # Compositors add visual effects to the windowing environment. By default, Regolith 3 installs the picom compositor. Users experiencing graphical issues due to specific hardware or driver limitations may want to install one of the following compositors instead:\n Package Notes regolith-compositor-picom-glx Default regolith-compositor-compton-glx An older compositor that may work better on some hardware regolith-compositor-xcompmgr An older compositor that may work better on some hardware regolith-compositor-none A pass-through package that does not run a compositor See this How To for more details.\nWallpaper # Most Regolith Looks provide a default desktop color or image. The wallpaper can be set by specifying the path to the wallpaper image via the Xresources key regolith.wallpaper.file.\nExample, assuming the file /usr/share/backgrounds/hardy_wallpaper_uhd.png is present:\necho \u0026quot;regolith.wallpaper.file: /usr/share/backgrounds/hardy_wallpaper_uhd.png\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh To change the image treatment (zoom, scale, etc.) of the wallpaper image, set regolith.wallpaper.options. Options are: none, wallpaper, centered, scaled, stretched, zoom, spanned\nExample:\necho \u0026quot;regolith.wallpaper.options: zoom\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh To specify a color rather than an image use the Xresource key regolith.wallpaper.color.primary:\necho \u0026quot;regolith.wallpaper.file: \u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.primary: blue\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh To specify a secondary color and gradient:\necho \u0026quot;regolith.wallpaper.file: \u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.primary: blue\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.secondary: green\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.shading.type: vertical\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh Lockscreen Wallpaper # The lockscreen wallpaper can be managed in the same way as the desktop wallpaper. The keys are the same as desktop wallpaper, but with lockscreen prefixed to wallpaper, like so: regolith.lockscreen.wallpaper.... For example, to specify a lockscreen image:\necho \u0026quot;regolith.lockscreen.wallpaper.file: /usr/share/backgrounds/hardy_wallpaper_uhd.png\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources regolith-look refresh Disable Wallpaper handling # If you wish to manage wallpaper externally to Regolith, simply specify empty values for wallpaper image and color:\necho \u0026quot;regolith.wallpaper.file: \u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources echo \u0026quot;regolith.wallpaper.color.primary: \u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources Status Bar Indicators # Status indicators such as CPU load, date and time, notifications, weather, and other system info can be added or removed by installing packages. For example, to show a status indicator for your laptop battery, simply run sudo apt install i3xrocks-battery and then refresh the session using regolith-look refresh. To find what indicators are available, run apt search ^i3xrocks- or search for i3xrocks- in your favorite package manager GUI, such as Synaptic. There is more documentation available for configuring status indicators, also called \u0026ldquo;blocklets\u0026rdquo;. Here is a table of status indicators as of Regolith 2.2:\n Package Status Function i3xrocks-app-launcher Shortcut to app launch dialog i3xrocks-battery Battery status i3xrocks-bluetooth Bluetooth status i3xrocks-cpu-usage CPU utilization i3xrocks-disk-capacity Disk utilization i3xrocks-focused-window-name Title of focused window i3xrocks-info Shortcut to Keybindings viewer i3xrocks-key-indicator Keyboard toggle status i3xrocks-keyboard-layout Keyboard layout i3xrocks-media-player Media player status i3xrocks-memory Memory utilization i3xrocks-microphone Microphone status i3xrocks-net-traffic Network status i3xrocks-next-workspace Shortcut to create new workspace i3xrocks-nm-vpn VPN status i3xrocks-openvpn OpenVPN status i3xrocks-rofication Notification status i3xrocks-tailscale Tailscale status i3xrocks-temp System temperature i3xrocks-time System time i3xrocks-updates System package status i3xrocks-volume Audio volume status i3xrocks-weather Local weather i3xrocks-wifi Name of connected wifi AP Looks # Colors, wallpaper, window and bar layouts and other visual factors are bundled together in Regolith and called \u0026ldquo;looks\u0026rdquo;. Looks provide a simple way of changing the entire look of the desktop. Like status bar indicators, looks are packaged and are installed and removed like any other software package. By convention, Look packages use the following naming format regolith-look-\u0026lt;name\u0026gt;. apt or a GUI package manager can be used to search for available looks. To select an installed look the keybinding super alt l presents a dialog:\nAlternatively, the terminal command regolith-look can be used to change looks and refresh the active session with the selected look. Here\u0026rsquo;s an example that switches to the gruvbox look:\napt search ^regolith-look- [...] regolith-look-gruvbox/unknown,now 0.4.6-1regolith amd64 [...] sudo apt install regolith-look-gruvbox regolith-look set gruvbox regolith-look refresh To simply install all available looks:\nsudo apt install regolith-look-* i3 Features # Starting with Regolith 2.0, many aspects of i3 configuration are managed via the package manager. Regolith provides all of its i3 configuration via \u0026ldquo;config partials\u0026rdquo;. These packages install their i3 config partials into /usr/share/regolith/i3/config.d. By installing and removing packages, i3 configuration can be customized for specific preferences. By default, when the regolith-desktop package is installed, these configuration elements are also installed as soft dependencies:\n Package Function File regolith-i3-base-launchers Launch terminal and browser /usr/share/regolith/i3/config.d/15_base_launchers regolith-i3-default-style Window behavior /usr/share/regolith/i3/config.d/40_default-style regolith-i3-navigation Navigation keybindings /usr/share/regolith/i3/config.d/30_navigation regolith-i3-networkmanager Network and wifi functions /usr/share/regolith/i3/config.d/88_network-manager regolith-i3-next-workspace Workspace utility /usr/share/regolith/i3/config.d/40_next-workspace regolith-i3-resize Resize keybindings /usr/share/regolith/i3/config.d/50_resize-mode regolith-i3-session Session keybindings /usr/share/regolith/i3/config.d/55_session_keybindings regolith-i3-unclutter Hide mouse cursor when unused /usr/share/regolith/i3/config.d/86_unclutter regolith-i3-user-programs Optionally launch user programs specified in Xresources /usr/share/regolith/i3/config.d/90_user-programs regolith-i3-workspace-config Workspace keybindings /usr/share/regolith/i3/config.d/40_workspace-config Soft dependencies can be removed without causing packages that depend upon it to be removed. This means that any of the listed packages can be removed. Users can make tweaks to configuration in a more stable manner by replacing a default configuration partial with their own version. This can be achieved by copying the partial to be customized into ~/.config/regolith3/i3/config.d/ and removing the original file in /usr/share/regolith/i3/config.d via apt. In this way, the unmodified config partials can continue to get updates and bug fixes without impacting user-specific configuration.\nSee the i3 configuration customization how-to for examples.\nAll i3 Configuration Packages # The following contains a list of all i3 configuration packages available in Regolith 2.1:\n Package Function File regolith-i3-base-launchers Launch terminal and browser /usr/share/regolith/i3/config.d/15_base_launchers regolith-i3-compositor Compositor integration (delegates to regolith-compositor-\u0026lt;variant\u0026gt;) /usr/share/regolith/i3/config.d/80_compositor regolith-i3-default-style Window behavior /usr/share/regolith/i3/config.d/40_default-style regolith-i3-ftue First time user experience /usr/share/regolith/i3/config.d/84_ftue regolith-i3-gaps-partial i3-gaps configuration (if installed, i3-gaps will replace i3) /usr/share/regolith/i3/config.d/35_i3-gaps regolith-i3-gnome Regolith Settings keybindings /usr/share/regolith/i3/config.d/60_config_keybindings regolith-i3-i3xrocks i3 bar status indicators configuration /usr/share/regolith/i3/config.d/70_bar regolith-i3-ilia ilia integration /usr/share/regolith/i3/config.d/20_ilia regolith-i3-navigation Navigation keybindings /usr/share/regolith/i3/config.d/30_navigation regolith-i3-networkmanager Network and wifi functions /usr/share/regolith/i3/config.d/88_network-manager regolith-i3-next-workspace Workspace utility /usr/share/regolith/i3/config.d/40_next-workspace regolith-i3-remontoire Legacy keybindings view integration /usr/share/regolith/i3/config.d/45_remontoire regolith-i3-resize Resize keybindings /usr/share/regolith/i3/config.d/50_resize-mode regolith-i3-rofi Legacy desktop launcher integration /usr/share/regolith/i3/config.d/20_rofi regolith-i3-rofication Legacy notification viewer integration /usr/share/regolith/i3/config.d/82_rofication regolith-i3-rofication-ilia Notification viewer integration /usr/share/regolith/i3/config.d/82_rofication-ilia regolith-i3-session Session keybindings /usr/share/regolith/i3/config.d/55_session_keybindings regolith-i3-snapshot i3 workspace persistence /usr/share/regolith/i3/config.d/75_i3-snapshot regolith-i3-swap-focus Toggle back to last focused window /usr/share/regolith/i3/config.d/40_i3-swap-focus regolith-i3-unclutter Hides mouse when not in use /usr/share/regolith/i3/config.d/86_unclutter regolith-i3-user-programs Optionally launch user programs specified in Xresources /usr/share/regolith/i3/config.d/90_user-programs regolith-i3-workspace-config Workspace keybindings /usr/share/regolith/i3/config.d/40_workspace-config Keybindings # Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. The most common keybinding change is the super key. Regolith uses Xresources as the canonical source of truth for settings, which are read by various UI components. The table of Xresources keys open to user configuration is available elsewhere. To change the default super binding from the \u0026ldquo;windows\u0026rdquo; key to \u0026ldquo;alt\u0026rdquo;, add the following line to the file ~/.config/regolith3/Xresources:\nwm.mod: Mod1 wm.alt: Mod4 Note: GNOME also has its own set of keybindings. When the Regolith session is first initialized, the conflicting GNOME keybindings are removed from the user settings. GNOME keybindings can be managed in the Regolith Settings app.\nSystem Management # The regolith-control-center app is the tool to configure locale, date, displays, networking and various other settings. Launch it via the app launcher with super space , type settings, and hit enter to launch the app. The direct keybinding is super c . The application may also be launched from a terminal with command regolith-control-center.\nFurther Reading # To dig deeper, find which Howtos are available, or read the Xresources reference. Become an i3 power user by reading their user guide.\n"},{"id":12,"href":"/docs/howtos/","title":"How To","section":"Docs","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. 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\u0026rsquo;d just like to refresh your memory, this guide from Ubuntu is recommended. Another tutorial from linuxcommand.org goes into some more advanced territory.\ni3-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.\n"},{"id":13,"href":"/docs/reference/Releases/regolith-2.1-release-notes/","title":"2.1 Release Notes","section":"Releases","content":"Regolith 2.1 is a minor release including several improvements, bug fixes, and optimizations.\nNew Features # Regolith Linux 2.1 ISOs (based from Ubuntu 22.04) Looks dracula, ayu, ayu-dark, ayu-mirage, i3-default, and lascaille added Looks can be loaded from user directories (~/.config/regolith3/looks) i3-swap-focus is now available. Navigate to last window with keybinding \u0026lt;super\u0026gt; . Bug Fixes # Ilia\u0026rsquo;s file search dialog was broken on Jammy, this has been fixed PtrSc hotkeys working as in 1.6 Numerous small fixes listed below Known Issues # No localization for ilia Inconsistent GTK theme in some dialogs in Jammy (gnome-flashback fix in progress, will be available from Ubuntu repos) Bug Fix Releases # 2.1.1 # The Regolith Linux ISO was rebuilt as 2.1.1 due to a packaging mistake. The md5sum that may be used to verify the download was incorrect. The 2.1.1 release fixes this by including the correct md5sum file. While the 2.2.1 ISO was freshly built, it includes no package changes over 2.1.\nChangelog Delta from Regolith Desktop 2.0 to 2.1 # See the GitHub 2.1 release for additional details.\nChanges in regolith-lightdm-config: # b8d4503 Add attribution for NASA Juno image fdbd150 Switch to Papirus icon theme. Set regolith as default session. 0910bd8 Add all configuration items to slick-greeter file e95bd47 move from gtk greeter to slick. Update background Changes in regolith-session: # d1e21b9 Remove old look comment declarations d2bee02 Add ability to stage looks in user directory ~/.config/regolith3/looks ac6eb70 Check if user's directory does not exist before appending Changes in i3-wm: # 937549f2 Merge tag '4.20.1' Changes in i3-gaps-wm: # b451b2a6 Merge tag '4.20.1' Changes in regolith-i3-config: # 3f12389 Package changes 1e4f88c Switch to super-. for swap-focus based on user feedback c5b43ff Package changes 6881ba4 Switch swap-focus to easier keybinding 6ab7598 Package changes 47c0545 Fix copypasta in i3-swap-focus dff03ff Package changes 7f9ae0b Add new integration i3-swap-focus 647a658 Package changes d7aeb82 Merge pull request #6 from jjsearle/default-border-style-option df223f1 allow titlebar to be enabled via Xresources Changes in regolith-look-default: # 3fba280 Reduce dependencies in default look, conform to adwaita 24ffab7 move to hicolor icon theme for default to reduce overhead c187a2f Use colors in workspace labels 06841a8 Set titlebar style settings 589b264 Specify glyph for app laucher. Better glyph for help Changes in regolith-look-extra: # e0e049a Fix paths to compositor a7018ec Decouple picom from looks. relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 1d33fb1 Merge pull request #8 from mfisher87/consider-picom-deps 210c2d3 Merge pull request #6 from regolith-linux/nevil-icon-theme-default-switch f70c4de Remove picom as a dependency of Nord and Nevil looks 632c175 updated Debian package metadata to install moka-icon-theme 1287be9 Add missing regolith-look-ayu-mirage look to debian packaging 13d125d Update looks to include lockscreen settings 17afcb7 Port lascaille from default look 7b5fb2e Add i3-default look 8ac4b27 Add window border styles to existing looks 883e434 Changed default nevil icon theme to Moka 493c746 Update workspace glyph icons across a few looks for more flair b63b75a Add Ayu, Ayu-Mirage \u0026amp; Ayu-Dark a600730 Specify glyph for app laucher. Better glyph for help b3e6295 Add dracula look by @jjsearle 92f844a s/nord/nevil in composer-init Changes in i3-swap-focus: # c04ad13 Fixes for newer deb build tools ccb5ce6 Add debian packaging Changes in regolith-i3xrocks-config: # 11c7516 replace reboot command with saner default (#134) 086d0a2 Add control entry for i3xrocks-update 1d09bb8 Add tailscale IP (#132) 7f70e0a Add support for wireguard interface/tunnel (#118) 38da9e1 Add support to temp script for Tctl (#124) 0fe5a12 Remove extra space in output (#130) e06b955 Add updates block (#131) 56ed590 move dynamic block window-name to the left-most position due to horizontal variance ce6cebd Remove unneeded script for app launch action 86abc8c Load ilia over remontoire for help action d400913 Adding a fix to not show anything on empty workspace (#129) 25fd18d Add support for bond interface in net-traffic (#128) Changes in regolith-compositor-compton-glx: # 7980eb1 Allow config to be specified by Xres. Relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 Changes in regolith-compositor-picom-glx: # ee673f1 Allow config to be specified by Xres. Relates to https://github.com/regolith-linux/regolith-look-extra/pull/8 Changes in ilia: # 84687f2 Sync project versions 149d4e6 Filter on both summary and keybinding text in keybinding page to address https://github.com/regolith-linux/ilia/issues/34 eaf40b6 Revert to using x-terminal-emulator over gdk in support of https://github.com/regolith-linux/ilia/issues/31 156d478 Clean up page key event handling. Exit on system key events to address https://github.com/regolith-linux/ilia/issues/24 c0e4bd1 Fix double filtering in tracker page. Address https://github.com/regolith-linux/ilia/issues/23 3948bc8 Cleanup icon handing across pages. Fix icon handing for window view 52d350c Read floating node members of i3 tree response. Addresses https://github.com/regolith-linux/ilia/issues/21 64943d8 Remove unused dependency, causing errors on ISO release 157df07 Remove default sorting of items from textlist page Changes in regolith-default-settings: # 366893e Update default settings to match default look Changes in remontoire: # ab00f14 Fix version returned by program to match package version Changes in plymouth-theme-regolith: # b14a39f Use final logo image "},{"id":14,"href":"/docs/reference/Releases/regolith-2.0-release-notes/","title":"2.0 Release Notes","section":"Releases","content":"Regolith 2.0 is a major release with some breaking changes to looks and i3 configuration, and includes several improvements and optimizations.\nNew Features # Adding Debian Bullseye to the list of supported OS\u0026rsquo;s including Ubuntu Focal and Jammy. The desktop UI component rofi was replaced with desktop executor designed specifically for Regolith: ilia. The desktop UI component gnome-control-center was replaced with a settings app designed specifically for Regolith: regolith-control-center. The Regolith i3 config file has been destructured into partials and packaged to provide better configuration management. The Regolith Look XResource scheme has been updated to be simpler, more flexible, and consistent. The keybindings viewer remontoire was replaced by ilia to provide better support for keyboard-driven workflow and easier searching. Regolith supports both i3 and i3-gaps based on user preference. Fonts from the open source project Nerd Fonts have been packaged for Regolith, simplifying font management. A command-line utility for managing notifications, lago is available. A command-line utility for collecting Regolith diagnostic info, regolith-diagnostic is available. Usability Fixes # Alt and Super can now be swapped easily with an Xresources override. Alternate languages can be selected from in the desktop executor. regolith-control-center prevents some pop-ups from being hidden and locking UI Known Issues # No localization for ilia Changelog Delta from Regolith 2.0 Beta 3 to General Release # Changes in regolith-session: # 1061f67 Re-apply user Xres after look is applied. Resolves https://github.com/regolith-linux/regolith-desktop/issues/644 Changes in regolith-i3-config: # e25d88c Add missing newlines at end of config files from @buck10 da5615f Add conflicts relationship between ilia and rofi i3 config 244547e Add descriptions for bin packages a11ff93 Allow look-selector icon to be overridden. Specify better default icon Changes in regolith-look-default: # fa7fb24 Update ilia CSS style 659d545 Add docs to Xresources Changes in regolith-look-extra: # d7b784b Update ilia CSS style bc88936 Fix look descriptions fd84e99 Fix incorrect path to ilia css Changes in regolith-i3xrocks-config: # b35690d fixed xml escaping (#127) Changes in ilia: # fa548a8 Remove hard code style. Squelch right-click context menu to avoid hang. 9ed0020 Extract hard coded style to CSS 16d088b Add rofi reference 05dcaee Fix code sections 018deb4 Updates to readme for release Changes in regolith-control-center: # e85c3ced1 Fix crash on power panel (jammy only) 6a584746b Update regolith logo from final revision Changelog Delta from Regolith 2.0 Beta 2 to Beta 3 # Changes in regolith-session: # 87919c5 Revert strategy that creates merged Xresource. Simplify by just loading one override or using default look. Looks become top-down definitions of UI, and bottom up extension model deprecated. 975c542 Cleanup Changes in regolith-i3-config: # 4d0d5b2 polish look selector ui Changes in regolith-look-default: # 557d76d Add lockscreen wallpaper functionality Changes in regolith-look-extra: # 8c211ba Package changes b8188d3 Visual tweaks to nevil Changes in regolith-ftue: # ce16a93 Use stylesheet for proper font rendering on ftue help Changes in ilia: # 4512ba1 Add separator between category and action in keybindings view b8373fd Exit if super pressed to prevent blocking i3 85f7041 Fix warning in socket close a870a2b Better icon for window page 647b1bb Add missing dependency e2c19c1 Update textlist to render icons fb59b13 Plumb cmdline args to each page via DialogPage. Add title and icon parameters for TextList customization b83fbcb Update dialog resize keys to use alt to allow keyboard entry. Specify max bounds of window size when possible. Changes in regolith-control-center: # 3eb9dea29 Re-add some install files for shortcuts and gschema Changelog Delta from Regolith 2.0 Beta 1 to Beta 2 # New light look: regolith-look-nevil Updated wallpaper for regolith-look-nord and regolith-look-gruvbox by @GMFranceschini Ilia now has multi-tab mode Ilia launches app from notification Changes in regolith-session: # f57f66b Add script to collect diagnostic info for troubleshooting 4494e68 Fix broken refresh logic after Xres file change introduced in previous version cdaa330 Fix regolith look update logic to write to Regolith-specific Xresource file Changes in regolith-i3-config: # 406b428 Add docs about config partials 521016c Add OR dependency on i3-gaps-wm to resolve packaging issue found on Bullseye a6b6fea Load all pages in ilia when users load the keybindings dialog 0f6a018 Add networkmanager, next-workspace, and unclutter as soft dependencies 7921136 Require i3-gaps version with config partials in regolith 2 a2390bd Require i3 version with config partials in regolith 2 2711991 Fix typo of new mapping for Xres mono font to i3 bar font 1238b4a Fix typo of new mapping for Xres font to i3 font Changes in whitesur-gtk-theme: # cc591d7 Initial commit. Built from release 2022-02-21 Changes in regolith-look-default: # fcb288e Default terminal profile update to true c849879 make the check for invalid path to wallpaper more robust 5c2c402 removed left-over bracket ca61239 fixed regression in #2 + fixed other possible bug ad6691b Merge pull request #2 from georglauterbach/main c9df3c7 updated `default_loader.sh` | style, formatting \u0026amp; refactoring Changes in regolith-look-extra: # 2e700f0 Use new wallpapers from GMFranceschini in nord and gruvbox looks a2ca36b Fix dependency 5c7f3ed Tweaks and fixes to nevil ec1a158 Add nevil look 429863c Add updated solarized-dark look 3511556 Give rounded corners to Nord w/ custom picom config. Misc tweaks f1e0088 Specify ilia stylesheet in all looks Changes in regolith-i3xrocks-config: # 0b12b5a Use /proc/net/route for interface detection (#126) Changes in regolith-ftue: # e155b96 Remove unneeded sleep and launch shortcuts in all page mode Changes in ilia: # 91e74dd Update docs ab57873 Add page keybindings in all-page mode 050eac7 document page interface e5e8a5a Add option -a for all page mode to address https://github.com/regolith-linux/ilia/issues/17. Misc cleanup cc80bc3 Fix icon in files page a2f29f0 Change label to 'Commands' from 'Terminal' 3df2ca9 Add ability to launch host app to address https://github.com/regolith-linux/ilia/issues/18. Fix icon loading of notification view. d451b54 Minor simplification to command launching Changes in regolith-control-center: # 1be590f260444f80661db29d2566f072b5b69300 Remove unused power_saver_low_battery option in power panel 8310cf2bdd8463ce90b0e33f3f0aeffa8f76f3d4 Remove battery percentage toggle 0caac0d47 Update logo Changelog Delta from Regolith 1.6 to Regolith 2.0 Beta 1 # Changes in regolith-lightdm-config: # 8a0d5c7 Switch font from jetbrainsmono to dejavusansmono 3eac0ff Update dependencies for Regolith 2 Changes in regolith-session: # a939fad UI refresh logic moves to looks cd72a50 gnome Xresource moves to looks 4f67559 Add Xsession file to add user desktop app dir to XDG_DATA_DIR to enable ilia to index desktop files there e3c83d5 Remove unimplemented 'stage' command. Misc cleanup 79cb6b1 Fix font spec from i3 to gnome f776087 Only set gnome theme properties if defined by xres 870303f Set gnome interface font from look during refresh 9a9d98f Fix reference to term profile script and add soft dep to address problem in https://github.com/regolith-linux/regolith-look-extra/pull/1. 0ef3f55 Re-apply root Xresources after regolith Xres to ensure user values are set a844012 Create new virtual package 'regolith-look-2' to specify a look. Version bump for cleaner upgrades from 1.x d4bec14 Test that wallpaper file exists before setting 5c78271 Move Xresources.d from /etc to /usr/share/regolith due to apt policy issues with files in /etc. 2612147 Add breaking package from Regolith 1.6 due to file conflict 3a6b087 Fix sessoin init issue reported in https://github.com/regolith-linux/voulage/issues/2 c24ed0d Move to regolith2 config dir db8953b Fix session init bug with invalid look path root e89a150 Several bug fixes for Regolith 2 Xresource merging/loading daf7368 Extract common session logic to lib file. Fix regolith-look refresh and list 5f54d14 Add user defined post logoff script 614f6e3 Import regolith-look script from deprecated package regolith-styles. Add build automation. 06f8c79 Fix path to renamed default look eb85712 Depend on updated look package, add virtual look package. Changes in regolith-i3-config: # 96c4762 Decompose navigation, workspace config, and base launchers from i3 config file. Misc fixes cf78c9d Add ability to specify custom stylesheet to ilia 8cad4c9 Remove unneeded dep from i3-gaps to i3-snapshot. Cleanup f8aec01 Remove session, resize, and user programs from hard dependencies in i3 config 0b7aa04 Extract i3 style config to optional partial fa0e452 Allow resize mode keybinding to be overridden to address https://github.com/regolith-linux/regolith-desktop/issues/627 967fb85 remontoire and ilia keybindings conflict because they both specify help. Set 'conflicts' in debian accodringly. Addresses https://github.com/regolith-linux/regolith-desktop/issues/628. 09eb0e2 Add label for gaps 72af37e Move i3 partials from /etc to /usr e58e1d7 Move i3xrocks conf.d from /etc to /usr/share/regolith due to apt policy issues with files in /etc. aa1ff5c Migrate from gnome-control-center to regolith-control-center 2b4e580 Fix ftue dependency 64fd601 Add breaking package from Regolith 1.6 due to file conflict cdbb722 looks will host i3wm xres files, not here fd0974e Move to regolith2 config dir 8e50f48 Add '--no-startup-id' when exec launchers 72a3636 Conditionally apply i3 xresources, allowing looks to override b9072d5 Make rofi and ilia versions of rofication ui mutually exclusive bf61321 Add seperate rofications for rofi and ilia front ends 1c23f65 Update alt variable to always occur on lhs due to i3 variable expansion constraints. Related to https://github.com/regolith-linux/regolith-i3-gaps-config/pull/39 486151b Use ilia for look selector 118f557 use var for alt rather than hardcode. based from https://github.com/regolith-linux/regolith-i3-gaps-config/pull/39. 5880f98 Remove i3-next-workspace from common config 641f9d3 Switch to ilia for rofication UI 09765da Add all next-workspace bindings 6384067 add configurable workspace movement, from https://github.com/regolith-linux/regolith-i3-gaps-config/pull/37. 22815c6 Add keybinding viewer (ilia), replacing remontoire 73fda78 Add ilia i3 config ac206fc Consolidate some partials to handle variable access limitations w/ i3 partials d17ee44 build automation 2c5091f Update partials for i3 4.20 Changes in regolith-look-default: # 422a36b Specify custom stylesheet for ilia to fix Debian issue with incorrect font used in keybindings view 68041dc Wallpaper fixes to default loader. Misc tweaks and cleanup 37ce868 Fix missing default_loader.sh in package 555f857 Fix bug when single background color is specified. 77d3d40 tweaks to font sizes. Fix debian control b2adcdb Refactor looks to be more consistent, own refresh logic, and better represent gtk theme elements ed8cc44 Fix typeface for volume glyph f6460f3 Create new virtual package 'regolith-look-2' to specify a look. Version bump for cleaner upgrades from 1.x 7381999 Alt char for temp 63f4fd1 Use alternate temp glphy to fix mystery ordering issue 0ccb167 Add missing icon theme dependency 5ef662a Move i3wm xres here. Fix non-active workspace color in bar 6d37a7f Fix glyphs in typeface not specified by font 1bf39d8 Update default look to use nerdfonts version of jetbrains mono. update glyphs. 5b1973b Make looks non-exclusive d778c94 Add rofication-ilia 0cc844b Switch from rofi to ilia 5cabe6e Fix gnome theme key 902a01b Add virtual package for a look 68d072b Change from minimal to default Changes in regolith-look-extra: # f1e0088 Specify ilia stylesheet in all looks efe94ba Fatter borders in gruvbox for upcoming rounded corners baaace4 Add hardy wallpaper to gruvbox. Publish gruvbox look db7f92e Fix missed mapping from gtk monospace font to bar workspacce font. Reduce blackhole font size. Assocated with https://github.com/regolith-linux/regolith-look-extra/issues/2 e572851 Add gruvbox look 7703e34 Tweaks polish and fixes to looks 066907f Sort glpyhs 67de712 Depend on default look for loader script 0ef9875 Merge branch 'main' of github.com:regolith-linux/regolith-look-extra into main 791321a Move blackhole to new Xres scheme 6944d7d Move nord to new Xres scheme b8736b0 correct description and dependencies for blackhole 9da8e9c Package @ploum look blackhole. Related https://github.com/regolith-linux/regolith-look-extra/pull/1 fdbbd77 Fix font on wifi and workspace glyph to address https://github.com/regolith-linux/regolith-desktop/issues/631 4420393 Fix font on volume indicator to address https://github.com/regolith-linux/regolith-desktop/issues/631 8c7656f Create new virtual package 'regolith-look-2' to specify a look. Version bump for cleaner upgrades from 1.x 3cddd15 More tweaks to term colors for nord 1f4bd7f Tweaks to term colors for nord 094fc90 visual refresh to nord look 9c956e1 Move nord to use nerdfonts version of sourcecodepro. Misc fixes for Regolith 2 xres 965eac1 use original i3-wm Xres def for nord. Disable gruvbox package. 4503a80 Fix def names for Regolith 2 0203187 Make looks non-exclusive e2c9a3a Remove redundant look. Add nord adapted from 1.x 2e15aa8 Add docs, changelog acb101f Initial commit. Ported from regolith-look-default Changes in regolith-i3xrocks-config: # 7b2e609 Fix typo in media player script ad20e67 i3xrocks Xresource moves into looks 9f73ef5 Specify font for both label and value after transition to nerdfonts 674e498 Fix celcius degree postfix on temp 87ab5d2 Migrate configuration from /etc to /usr/share due to problematic apt policy in /etc directories 885be5f Swap gnome-control-center for regolith-control-center e8fd320 Add missing dep on rofication block 9170923 Fix ilia launch from notification 1b24e7b Deprecate python rofication status block for shell script. Launch ilia on click by default Changes in regolith-desktop: # 2bf8c77 Push look dependencies down to regolith-look f2f4435 Fix typo in packaging, use proper symver e82a954 Revise package architecture. Remove -small desktop package, go back to single base package. 12e39b6 Regolith 2 package model adf1a53 Sync changelog to distro a7c6444 Update versioning Changes in regolith-ftue: # 6c5e76f Cleanup, better font default a7bbfbb Add delay when loading ftue keybindings view in attempt to avoid race w/ i3 config loading 820a297 Use new conf directory for regolith2 1b542ed Add missing dependency 1135876 Switch to ilia over remontoire for keybinding viewer 0be6a48 Rename term profile script for consistency eefcb55 Depend on uuid-runtime to fix debian ftue Changes in regolith-compositor-xcompmgr: # 593c3e0 Move to regolith2 config dir Changes in regolith-compositor-compton-glx: # 94cf43a Move to regolith2 config dir 6a234bf Add new name for zoom window, from https://github.com/regolith-linux/regolith-compositor-compton-glx/issues/3 454c5d6 Do not fade ilia Changes in picom: # e96a7b2 Package v9.0 release Changes in regolith-compositor-picom-glx: # 49ddcf9 Move to regolith2 config dir 2ee5b27 Add new name for zoom window, from https://github.com/regolith-linux/regolith-compositor-compton-glx/issues/3 d27bbab Do not fade ilia 9fe5b87 Update to use @Filip-K picom config from https://github.com/regolith-linux/regolith-desktop/issues/578. Changes in remontoire: # f72a575 Cleanup source formatting 96090d5 Add scrollable parent to flowbox to allow vertical scrolling of content when exceeds bounds of flowbox dc210de Don't draw scroll hints for horizontal scrolling Changes in ilia: # 8443061 Tolerate empty css override. Add class name to keybindings view b7ffa94 Numerous tweaks to help facility. Misc cleanup 6954aa1 Do not hardcode font in stylesheet 6f19ef1 Cleaner simpler approach to help content 761c5a8 Customize style via hardcoded CSS. Enable command line options for specifying css file or no styling. Misc fixes. Addresses https://github.com/regolith-linux/ilia/issues/12 and https://github.com/regolith-linux/ilia/issues/8 57b2037 Add ability to specify custom stylesheet 7ac9bda Add help feature, enabled by default f64cc2e Better error message for invalid page 6967488 Fix array size for pages 66f6127 Update heuristic to grab resources at start time (experimental) 6130e48 Use XDG_DATA_DIRS to source desktop files to address https://github.com/regolith-linux/ilia/issues/11 83081f0 Load config partials for keybindings e0a0c46 Update dev branches for automation ec11206 Only grab keyboard and mouse f5ac6f2 terminal page cleanup 0612e62 Add feature to resize dialog 499a084 Fix window launcher to close after action. Misc cleanup c4b0658 Add help flag to print all page types 9bc1b97 Add sleep after app launch to prevent intermittent failures fa5163f Retry to grab inputs if fails 47dfe97 Use GTK POPUP window to avoid fullscreen window management of i3. Relates to https://github.com/i3/i3/issues/4749 c1434d0 Fix textlist return selected value cfa437d remove/disable debug output a72ffc4 Add tracker dependency 8c040ca Tracker page functionally complete 5b8ff8f WIP: tracker partially working. 35637ec Update build files and add tracker dep f67ede6 Window selection causes focus 00af209 Read windows from i3 and display 843bef4 Add partial parser for i3 tree struct 2adf24e Add working textlist page 97b1234 Fix message truncation bug a979865 Do not handle any key events 4f3d557 Enable delete notification function 425c1b1 Allow pages to handle key events e5af321 Icon and layout for notifications f006839 parse i3 config file to extract default values for variables ec55468 Keybindings viewable 961eda0 autovala updates 611fdb0 Add classes from remontoire to read i3 config a76e39a WIP: icon/detail view. waiting for model changes from rofication before proceeding 082f659 Can read/display notifications 1fc0c56 Add ability to specify primary page on command line fec9a81 Use hashtable for app launch frequency lookups 3e93feb Prefer apps that start with query string. Misc cleanup. 05c0989 Add UI polish 6450a6f WIP: terminal page f0c2d4a Add spinner UI to clean up app launch lifecycle 5dc43f0 WIP, bug w/ intermittant launch failure 4e2db83 Extract desktop app loading into class. Introduce general interface for pages. b51bf40 Add app metadata files. Add build support for gsettings schema. 6517de8 Improve startup ux. Load apps from user dirs. Close dialog before launching app. 35a1d08 Ignore whitespace in filter 111241d Support pg up/down. Configurable window and icon size. 8c78649 Add unused cmake files to appease autovala/meson bbe2851 Selected apps rise to top of list 25a447d add gsettings schema 579c8d6 Can launch apps b58252a Initial import from autovala creation Changes in lago: # 960c8a0 Refactor rofication client to be sessionless. 6313183 More legible output from ls 31f495e Add empty files to appease autovala generated build files b5bda93 Add usage to readme 1117188 Add readme 084b41d Add packaging 57939e8 clean up cli 43419b5 format source 03132a4 Add source format config f85a450 fix src filename bf452d8 Add rm and clear functions fd4d765 CP: retrieve something from rofication dameon Changes in regolith-rofication: # a75b21a Fix ImportError exception for Python 3.10 or higher (#20) 7481617 Add command to delete list of notifications by id (#17) 6d4673b Merge pull request #16 from cfsmp3/master cd1ecc8 Fix parsing hints dab5dae Change path of queue storage file so it's not directly in the home dir fb3d631 Merge pull request #15 from cfsmp3/master: Add timestamps to notifications 86285dc Undo unneeded changes in daemon 2be67af Made internal format a Python timestamp, convert to string in the UI 21b65d5 Fix conflicts 0ae8cca Read timestamp format from XResources faeb17f Feature: store the notification state of 'icon' (#13) 3f14e05 Fix some typos in README (#14) ffdc26e Add daemon 83f5b74 Make datetime format configurable via arg 1ed370a Add timestamp to notifications e45205f Fix some typos in README (#12) 02329b5 Package last change 29ff56c keep ui open if there are still notifications left (#10) Changes in regolith-control-center: # 6a39ca015 Add debug info for invalid panel id, related to https://github.com/regolith-linux/regolith-control-center/issues/2 cffbd8e1b Remove dim screen toggle db3357d3b Remove background panel. See https://github.com/regolith-linux/regolith-desktop/issues/630 87aab1ec1 For better i3 interop, all modal dialogs close if they lose focus, preventing poor UX from hidden window a17b0366d Swap ubuntu logo for regolith b60229237 Remove unneeded lock panel a5e34f04c Remove unneeded notifications panel 2cfbbb664 Remove unused fractional scaling 558309824 Remove ubuntu and connectivity panels for debian support 001a1e711 Remove patch that fails to build on debian 0f95095a0 Remove gnome-language-selector support, ubuntu specific 158dcd919 Remove whoopsie support, ubuntu specific bff27cc66 Update dbus service name to prevent collisiosn with gnome-control-center 2660efbf5 Rename desktop entry to avoid collision with gnome-control-center II 0c21d0d4b Rename desktop entry to avoid collision with gnome-control-center be157d991 Remove upstream file 5d934dc83 Rename cc-remote-login-helper to prevent collision w/ gnome-control-center 17421fbbd Ignore files not installed in removed packages 44784f21d Remove unshipped files a7a5a9fb7 Fix references to renamed schema aa55ad004 Remove -data and -faces packages, use upstream 185af0ddd Rename gnome-power-manager icons to prevent collision w/ gnome-control-center ffc1ed0f7 Update flatpack fields for regolith a9859968f Change filenames to avoid collision w/ gnome-control-center 8bd341a1d Tweak desktop file to differentiate from gnome-control-center 695219bc7 Change filenames to avoid collision w/ gnome-control-center 024a179f3 Move gettext files due to collision with gnome-control-center 4a3db8b67 Add context to readme 8c1b2c9fd Remove failing dep 55c3a8d0f Remove failing or redundant patches b160acbd3 Remove upstream readme 9b5bdb062 Regress polkit-gobject-1 dependency to match debian version in meson (experimental) 20bd1f69e Global rename from gnome-control-center to regolith-control-center a86c8ef7a Fix of issue with adjusting output volume Changes in regolith-default-settings: # 5aac9cb Remove texture from default wallpaper Changes in nordic: # 3577075 Add built themes from release 2.1.0 dbd6e31 Remove source files 6f1aea6 Add debian packaging Changes in fonts-source-code-pro-ttf: # 2fd5dfd Initial import from speedricer, debian cleanup Changes in fonts-nerd-fonts: # 96d4985 Remove noto as assets are too large for github policy a511489 add source file a63a1f9 remove script from debian branch 7842791 Commit from automation "},{"id":15,"href":"/docs/reference/","title":"Reference","section":"Docs","content":"This section contains reference material that may help you with Regolith.\n"},{"id":16,"href":"/docs/reference/Releases/regolith-1.6.0-release-notes/","title":"1.6 Release Notes","section":"Releases","content":"Regolith R1.6 is a feature release which includes several improvements and optimizations. Regolith 1.6\u0026rsquo;s primary feature is a return of the ISO installation method.\nFeatures # Feature Screenshot Description Return of Regolith Linux ISO Up to Regolith 1.4.1, we hand-built each ISO for major version releases. This became too brittle and time intensive, and so work began on build automation to generate the ISO. This took quite awhile to complete but is now available for the 1.6 release. New Look: Midnight Fabian (naib864) has provided a distinctive new look with new font, icons, and GTK theme. New Look: Solarized Light Ricardo Pérez (ricpelo) has provided a solarized light theme. New Status Indicator: app-launcher Regolith user Laurent provided the idea to add a status indicator to launch Rofi, and so i3xrocks-app-launcher was added for those that prefer to use the mouse to launch apps. Upgrades to i3-gaps and Rofi i3-gaps is updated to 4.19.1 and Rofi to 1.6.1. Fixes # Have a look at the R1.6 project page for a list of bug fixes.\nChangelog Delta from Regolith 1.5.3 to Regolith 1.6 # dracula-gtk (1.1.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add icons to dracula theme regolith-desktop (2.122-1bionic) bionic; urgency=medium [ Ken Gilmer ] * Add app launcher to complete desktop metapackage. Fix unneeded dep on mutter-common. regolith-desktop (2.118-1bionic) bionic; urgency=medium [ Ken Gilmer ] * Version bump to 1.6.0 regolith-ftue (1.1.2-1) bionic; urgency=medium [ Jordan Callicoat ] * More Xresources options for GNOME Terminal regolith-i3-gaps-config (2.8.6-1) bionic; urgency=medium [ Ken Gilmer ] * specify default workspace layout mode regolith-i3-gaps-config (2.8.5-1) bionic; urgency=medium [ Bence Ferdinandy ] * adding $mod+s for sound setting (#36) [ Ken Gilmer ] * Fix urls to howtos. Relates to https://github.com/regolith-linux/regolith-i3-config/pull/1. regolith-i3xrocks-config (3.6.4-1) bionic; urgency=medium [ Ken Gilmer ] * Remove invalid Xresource key segment from microphone block regolith-i3xrocks-config (3.6.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add missing dependency to net-traffic script on iproute2 regolith-i3xrocks-config (3.6.2-1) bionic; urgency=medium [ Ken Gilmer ] * Fix control file * Fix config for app-launcher, remove incorrect interval on next-workspace regolith-i3xrocks-config (3.6.1-1) bionic; urgency=medium [ Ken Gilmer ] * Take nicolas-lopez's contribution via gist as microphone status indicator. Related to https://github.com/regolith-linux/regolith-i3xrocks-config/issues/105. * Add app launcher status indicator regolith-rofication (1.3.3-1) bionic; urgency=medium [ Ken Gilmer ] * Remove debug logs that show up in /var/log/syslog (#9) regolith-rofication (1.3.2-1) bionic; urgency=medium [ Ken Gilmer ] * Require i3xrocks-rofication to be upgraded first, due to file collision between i3xrocks-rofication and regolith-rofication [ Carles Sala ] * Close window after deleting the last notification (#8) regolith-styles (2.9.7-1) bionic; urgency=medium [ Ken Gilmer ] * Rename midnight look background file to avoid collision w/ ubuntu-wallpapers-focal. regolith-styles (2.9.6-1) bionic; urgency=medium [ Ken Gilmer ] * Another attempt to fix pop-os wallpaper reference regolith-styles (2.9.5-1) bionic; urgency=medium [ Ken Gilmer ] * Fix pop os gnome settings regolith-styles (2.9.4-1) bionic; urgency=medium [ Ken Gilmer ] * Fix pop-os background. Change image filename to avoid conflicts regolith-styles (2.9.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add background image missing from midnight theme regolith-styles (2.9.2-1) bionic; urgency=medium [ Ken Gilmer ] * Fix color value unparsable by i3 regolith-styles (2.9.1-1) bionic; urgency=medium [ Ricardo Pérez ] * Fixes Gtk theme (SolArc-Dark -\u0026gt; SolArc) (#44) regolith-styles (2.9.0-1) bionic; urgency=medium [ Ricardo Pérez ] * New solarized-light theme (#43) [ Ken Gilmer ] * Package solarlized-light look contribution from @ricpelo * Add icon for app launcher shortcut regolith-styles (2.8.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add app launcher glyph regolith-styles (2.8.2-1) bionic; urgency=medium [ Ken Gilmer ] * Fix font specification for midnight look regolith-styles (2.8.1-1) bionic; urgency=medium [ Ken Gilmer ] * midnight theme package fixes regolith-styles (2.8.0-1) bionic; urgency=medium [ Fabian ] * Add midnight theme (#37) [ Ken Gilmer ] * Add dependencies to midnight look regolith-styles (2.7.1-1) bionic; urgency=medium [ Ken Gilmer ] * Specify different color for indicator to make window orientation indicator visible in dracula. Fixes https://github.com/regolith-linux/regolith-styles/issues/40. * Revert to single column mode in lascaille * Use accent color for orientation border decoration in lascaille regolith-styles (2.7.0-1) bionic; urgency=medium [ Ken Gilmer ] * Rofi app launcher in two columns regolith-styles (2.6.17-1) bionic; urgency=medium [ HieuTranTH ] * dracula: Fix a typo in i3-wm config file (#41) * ubuntu: Fix color_base2 incomplete hex code (#42) [ Ken Gilmer ] * Add highlight to bar for non-active focused windows for better multi-monitor experience (lascaille) regolith-system (1.5.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add recommends for Regolith system packages regolith-system (1.5.2-1) hirsute; urgency=medium [ Ken Gilmer ] * remove deprecated dependency rofi (1.6.1-1regolith1) bionic; urgency=medium * Adapted package metadata from Ubuntu for 1.6.1 release ubiquity-slideshow-regolith (168.5-regolith1) focal; urgency=medium [ Ken Gilmer ] * Update virtual package dependency for focal "},{"id":17,"href":"/docs/reference/xresources/","title":"Xresources","section":"Reference","content":"Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. Xresources Key Description gtk.theme_name GTK Theme (\u0026ldquo;Legacy Applications\u0026rdquo; in gnome-tweaks) gtk.icon_theme_name GTK Icon Theme gnome.terminal.audible-bell Enables audible bell in gnome-terminal (true / false) gtk.document_font_name GTK Document Font Name gtk.font_name General purpose font for GTK apps and the desktop gtk.monospace_font_name Font for monospace areas such as i3bar and the terminal gnome.terminal.background-transparency-percent Background transparency value for gnome-terminal (0 - 100). See also gnome.terminal.use-transparent-background. gnome.terminal.font Font definition for gnome-terminal gnome.terminal.scrollbar Flag to enable/disable scrollbar (never / always) gnome.terminal.use-transparent-background Enables transparent background in gnome-terminal (true / false). See also gnome.terminal.background-transparency-percent. gnome.wallpaper GNOME Wallpaper (can be overridden in Settings) gnome.wm.theme GNOME Window Manager Theme (unused) wm.alt Key mapping for Alt key. See the i3 User Guide for details. wm.bar.background.color Bar Background Color wm.bar.position Bar Screen Position wm.bar.separator.color Color of seperator between blocks wm.bar.separatorchar Character to display between blocks wm.bar.statusline.color wm.bar.trayoutput Enable or disable the app tray in i3bar wm.bar.workspace.active.background.color wm.bar.workspace.active.border.color wm.bar.workspace.active.text.color wm.bar.workspace.focused.background.color wm.bar.workspace.focused.border.color wm.bar.workspace.focused.text.color wm.bar.workspace.inactive.background.color wm.bar.workspace.inactive.border.color wm.bar.workspace.inactive.text.color wm.bar.workspace.urgent.background.color wm.bar.workspace.urgent.border.color wm.bar.workspace.urgent.text.color wm.client.focused.color.background wm.client.focused.color.border wm.client.focused.color.child_border wm.client.focused.color.indicator wm.client.focused.color.text wm.client.focused_inactive.color.background wm.client.focused_inactive.color.border wm.client.focused_inactive.color.child_border wm.client.focused_inactive.color.indicator wm.client.focused_inactive.color.text wm.client.unfocused.color.background wm.client.unfocused.color.border wm.client.unfocused.color.child_border wm.client.unfocused.color.indicator wm.client.unfocused.color.text wm.client.urgent.color.background wm.client.urgent.color.border wm.client.urgent.color.child_border wm.client.urgent.color.indicator wm.client.urgent.color.text wm.floatingwindow.border.size Window border size in pixels for floating windows wm.font Window manager font wm.gaps.inner.size Default gap size between windows in pixels wm.gaps.outer.size Default gap size at screen edge in pixels wm.mod Key mapping for Super key. See the i3 User Guide for details. wm.window.border.size Default border size in pixels wm.workspace.01.name .. wm.workspace.19.name Workspace Labels wm.workspace.01.key .. wm.workspace.10.key Workspace Shortucts i3xrocks.action.volume.left Command to execute when volume indicator is left clicked (default: none) i3xrocks.action.volume.middle Command to execute when volume indicator is middle clicked (default: none) i3xrocks.action.volume.right Command to execute when volume indicator is right clicked (default: mute through amixer) i3xrocks.action.volume.scrollup Command to execute when scroll wheel up is used on volume indicator (default: increase volume through amixer) i3xrocks.action.volume.scrolldn Command to execute when scroll wheel down is used on volume indicator (default: decrease volume through amixer) i3xrocks.error.color Color for bar module in error mode i3xrocks.label.battery0 Bar icon glyph i3xrocks.label.battery100 Bar icon glyph i3xrocks.label.battery20 Bar icon glyph i3xrocks.label.battery50 Bar icon glyph i3xrocks.label.battery80 Bar icon glyph i3xrocks.label.batteryac Bar icon glyph i3xrocks.label.batterycharging Bar icon glyph i3xrocks.label.batteryunknown Bar icon glyph i3xrocks.label.capslock Bar icon glyph i3xrocks.label.color Bar icon glyph i3xrocks.label.cpu Bar icon glyph i3xrocks.label.disk Bar icon glyph i3xrocks.label.dn Bar icon glyph i3xrocks.label.help Bar icon glyph i3xrocks.label.mediapaused Bar icon glyph i3xrocks.label.mediaplaying Bar icon glyph i3xrocks.label.memory Bar icon glyph i3xrocks.label.mute Bar icon glyph i3xrocks.label.notify.error Bar icon glyph i3xrocks.label.notify.none Bar icon glyph i3xrocks.label.notify.some Bar icon glyph i3xrocks.label.numlock Bar icon glyph i3xrocks.label.off Bar icon glyph i3xrocks.label.on Bar icon glyph i3xrocks.label.sound Bar icon glyph i3xrocks.label.thermometer Bar icon glyph i3xrocks.label.time Bar icon glyph i3xrocks.label.up Bar icon glyph i3xrocks.label.wifi Bar icon glyph i3xrocks.label.wired Bar icon glyph i3xrocks.nominal Default bar icon color i3xrocks.value.color Color of numerical value in bar module i3xrocks.value.font Font for numerical value in bar module i3xrocks.warning Warning color for bar module Optional Xresources keys # The following Xresources keys are undefined by default but can be used by users to change behavior as desired.\n Xresources Key Description wm.gaps.focus_follows_mouse The window under the mouse has focus if enabled wm.program.launcher.app Command i3 executes from the app launcher keybinding wm.program.launcher.cmd Command i3 executes from the command launcher keybinding wm.program.launcher.window Command i3 executes for the window navigation keybinding wm.program.help Command to launch from the help keybinding wm.program.file_search Command to launch from the file search keybinding wm.program.refresh_ui Command to launch from the session refresh keybinding wm.program.logout Command to launch from the logout keybinding wm.program.reboot Command to launch from the reboot keybinding wm.program.shutdown Command to launch from the shutdown keybinding wm.program.lock Command to launch from the lock screen keybinding wm.program.sleep Command to launch from the sleep keybinding wm.program.settings Command to launch from the Control Panel keybinding wm.program.display Command to launch from the Display Settings keybinding wm.program.wifi Command to launch from the Wifi Settings keybinding wm.program.bluetooth Command to launch from the Bluetooth Settings keybinding wm.program.files Command to launch from the file browser keybinding wm.program.notification_ui Command to launch from the notification UI keybinding wm.program.1\u0026hellip;wm.program.3 Optional programs to start with i3 i3xrocks.media-player.player-args Optional arguments used by the media-player i3xrocks block. These arguments are fed straight into playerctl, eg. setting this value to -p spotify only makes the bar display/control spotify. i3xrocks.action.mic.left Optional command to run on left button click of microphone status indicator. i3xrocks.action.mic.middle Optional command to run on middle button click of microphone status indicator. i3xrocks.action.mic.right Override command to run on right button click of microphone status indicator. i3xrocks.action.mic.scrollup Override command to run on scroll up of microphone status indicator. i3xrocks.action.mic.scrolldn Override command to run on scroll down of microphone status indicator. i3xrocks.action.volume.left Optional command to run on left button click of microphone status indicator. i3xrocks.action.volume.middle Optional command to run on middle button click of microphone status indicator. i3xrocks.action.volume.right Override command to run on right button click of microphone status indicator. i3xrocks.action.volume.scrollup Override command to run on scroll up of microphone status indicator. i3xrocks.action.volume.scrolldn Override command to run on scroll down of microphone status indicator. i3xrocks.action.disk-capacity Override command to run on disk capacity status indicator. i3xrocks.action.cpu-usage Override command to run on cpu usage status indicator. i3xrocks.action.memory Override command to run on memory status indicator. i3xrocks.action.wifi Override command to run on wifi status indicator. i3xrocks.action.weather Override command to run on weather status indicator. i3xrocks.action.media-player.left Optional command to run on left button click of media player status indicator. i3xrocks.action.media-player.middle Optional command to run on middle button click of media player status indicator. i3xrocks.action.media-player.right Override command to run on right button click of media player status indicator. i3xrocks.action.time Override command to run on date time status indicator. i3xrocks.action.battery Override command to run on battery status indicator. "},{"id":18,"href":"/docs/reference/Releases/regolith-1.5.3-release-notes/","title":"1.5.3 Release Notes","section":"Releases","content":"Regolith 1.5.3 is a bug fix release. The following list contains brief descriptions of fixes and updates per package since the Regolith 1.5.2 release:\nRelease Notes for i3xrocks # i3xrocks (1.3.5-1) bionic; urgency=medium\n[ Ken Gilmer ]\n Do not print system file error if user files do not exist. Addresses https://github.com/regolith-linux/regolith-i3xrocks-config/issues/114. Release Notes for regolith-desktop # regolith-desktop (2.111-1bionic) bionic; urgency=medium\n[ Ken Gilmer ]\n Move from i3xrocks-todo to regolith-todo to address https://github.com/regolith-linux/regolith-todo/issues/6. Version bump in version file for 1.5.3. Release Notes for regolith-i3xrocks-config # regolith-i3xrocks-config (3.5.7-1) bionic; urgency=medium\n[ Ken Gilmer ]\n remove debugging output flag in net-traffic script Release Notes for regolith-styles # regolith-styles (2.6.16-1) bionic; urgency=medium\n[ Ken Gilmer ]\n Tweak to width to better match pixel equivalent at 1080p. regolith-styles (2.6.15-1) bionic; urgency=medium\n[ Ken Gilmer ]\n Use relative width over pixels for better HiDPI support of Rofi dialog. Idea from @eduncan911 in https://github.com/regolith-linux/regolith-desktop/issues/417. Release Notes for regolith-todo # regolith-todo (1.2.1-1) bionic; urgency=medium\n[ Ken Gilmer ]\n Specify that regolith-todo replaces i3xrocks-todo. Addresses https://github.com/regolith-linux/regolith-todo/issues/6. Release Notes for remontoire # remontoire (1.4.1-1) bionic; urgency=medium\n[ Mark Stosberg ]\n Document -i, -p. (#11) [ Michael Vetter ]\n Add openSUSE install instructions [ Ken Gilmer ]\n Add fonts-font-awesome as soft dependency based on reference in CSS file and user feedback. Addresses https://github.com/regolith-linux/remontoire/issues/16. Cleanup "},{"id":19,"href":"/docs/reference/Releases/regolith-1.5.2-release-notes/","title":"1.5.2 Release Notes","section":"Releases","content":"Regolith 1.5.2 is a bug fix release. The following list contains brief descriptions of fixes and updates per package since the Regolith 1.5.1 release:\nRelease Notes for regolith-compositor-picom-glx # Remove manual fade flag passed to compositor in favor of specification in config file. Allows users to specify fade parameters via config file. Release Notes for regolith-ftue # Check update flag before changing gnome-terminal. Allows users to turn gnome-terminal profile generation off. Release Notes for regolith-i3xrocks-config # Added gawk specific testing for temp script (#108) Filter all interfaces associated with VPN traffic while determining default route (#110) Capture error cases involving invalid network device paths and sleep before returning to resolve CPU consuming loop due to interval type of i3blocks. "},{"id":20,"href":"/docs/reference/Releases/","title":"Releases","section":"Reference","content":"Release notes and other version-specific content can be found here.\n"},{"id":21,"href":"/docs/reference/Releases/regolith-1.5.1-release-notes/","title":"1.5.1 Release Notes","section":"Releases","content":"Regolith 1.5.1 is a bug fix release. The following list contains brief descriptions of fixes and updates per package since the Regolith 1.5 release:\nRelease Notes for i3-next-workspace # Initial copy from regolith-i3xrocks-config. Release Notes for regolith-compositor-picom-glx # Add xrender-sync-fence for better support of nvidia systems. Release Notes for regolith-default-settings # Add breaks declaration to deal w/ ISO upgrade issue Release Notes for regolith-desktop # ship version file with all desktop variants Update version to 1.5.1 Add new recommends for rofication status indicator that has been seperated from regolith-rofication Fix virtual package specification. Use look w/ less dependencies for minimal meta-package. Release Notes for regolith-ftue # Add some Xresources options for GNOME Terminal Release Notes for regolith-i3-gaps-config # Fix build files Fix path to i3-next-workspace Move some non-critical dependencies to Recommends. Add recommends to i3-next-workspace. Remove dep on FontAwesome. deprecating startnum fix adding a missing logic Fix \u0026lsquo;Carry Window to Next Free\u0026rsquo; binding, remove trailing whitespace. #31 Release Notes for regolith-i3xrocks-config # Add padding for net-traffic, extensive mocked tests #101 Migrate rofication status indicator i3xrocks conf file here from regolith-rofication. Remove button handling code as net-traffic cannot use them w/ repeat interval type. #100 Update net-traffic script to use \u0026lsquo;repeat\u0026rsquo; interval type. Rewrite weather blocklet #96 Remove todo scripts as migrated to regolith-todo package Fix disk-capacity button clicks, add tests #98 Change memory rock default full text #94 Fix name of next-workspace script from last change Remove next-workspace script as it\u0026rsquo;s moved to it\u0026rsquo;s own package: i3-next-workspace. format the connected device string using pango same as other rocks #89 Changed around a few release names Use git-buildpackage to build the deb instead of debuild, use auth for all containers reading from xresources now #82 Don\u0026rsquo;t sign packages for now, so the pipeline actually builds Only run packaging on tag releases for now Added tests for temp script and reworked temp script routine Also run the tests on PRs Match example with what the script is looking for #90 Rewrote net-traffic script, fixes #91 #92 Add extra location information to weather API request #88 set BUTTON variable #93 Added net-traffic tests and GitHub Actions workflow to run tests Switch to a separate container running to ensure we can run our tests Make sure we can actually run the job somewhere Fixed xrescat mock and test execution Fix for button handling of the net-traffic script #86 Make time interval configurable with Xresources #87 Restore original behavior of mouse actions on volume #85 Release Notes for regolith-rofication # Another approach to breaking status indicator from base functionality due to python build script mysteries: move the i3xrocks conf.d file to i3xrocks. Leave python scripts here for the python installer thing. Break status indicator for rofication into separate package: i3xrocks-rofication. Release Notes for regolith-styles # Check if gnome-terminal is installed before generating profile. Related to #522. Release Notes for regolith-todo # Add i3xrocks dependency in hopes of sidestepping package file conflicts during upgrades Rewrote syntax of todo script, added tests Add td-cli as dependency Package created from regolith-i3xrocks-config "},{"id":22,"href":"/docs/reference/Releases/regolith-1.5-release-notes/","title":"1.5 Release Notes","section":"Releases","content":"Regolith R1.5 is a feature release which includes several improvements and optimizations. To summarize, Regolith 1.5 ships simpler workspace management, a Rofi-based Look switcher, and numerous internal optimizations and cleanup. Read below for more details.\nFeatures # Feature Screenshot Description Next Free Workspace A typical part of managing workspaces in an i3-based desktop is moving to unused workspaces and then loading some applications. Before this feature, a user has to determine which unused workspace they prefer. This is done by scanning the list of existing used workspaces to determine an unused one. Now, the system can do this automatically. The super ` keybinding will move to the next free workspace. super alt ` will move the focused window into the next free workspace. View and Change Looks via Rofi Looks can be changed now via a Rofi dialog rather than having to configure the Xresources override via the command-line. To do this, use the keybinding super alt l and then select a look from the dialog. GSettings Overrides Regolith now uses GSettings overrides to configure various GNOME settings for use with Regolith. In previous versions, settings were written globally to the user session from within the Regolith startup code. This could cause issues if the user works in multiple desktop environments. Now, the Regolith GNOME settings are defined in an override file that is only in effect while using a Regolith session. This allows switching between desktop environments without settings from Regolith impacting other environments. New Looks Users have contributed some new Looks to Regolith: Dracula, Gruvbox, and PopOs. Each of these looks presents a distinctive color palate, typeface, and GTK theme. i3-gaps upgraded to 4.18.2 See the i3-gaps release notes for more information More Refined Customizations Numerous small changes allow more granular system customization, such as specifying the temperature unit, custom Compositor settings, and a more comprehensive way of changing i3 keybindings without having to copy the entire config file. More Desktop Environment Packages The following packages can be installed in place of regolith-desktop for specific sets of packages based on user needs: regolith-desktop-minimal, regolith-desktop-standard, regolith-desktop-mobile, and regolith-desktop-complete New default compositor: Picom version 8 See the Picom release notes for more information on what has changed. Remontoire upgraded to version 1.4 Includes better multi-monitor support and other bug fixes and enhancements. Optional integration with td-cli Access a simple todo app via Rofi. Documentation of development process The Regolith development process is now better documented for greater transparency and to foster inclusion. Fixes # Have a look at the R1.5 project page for a list of bug fixes.\nChangelog Delta from Regolith 1.4.1 to Regolith 1.5 # ######################################## # Release Notes for dracula-gtk ######################################## dracula-gtk (1.0.1-1) bionic; urgency=medium [ Ken Gilmer ] * Remove unnecessary files dracula-gtk (1.0-1) bionic; urgency=medium * [ Ken Gilmer ] * Packaging version add4f8c ######################################## # Release Notes for fonts-materialdesignicons-webfont ######################################## fonts-materialdesignicons-webfont (1.6.50-3regolith3) bionic; urgency=medium * Backporting to bionic for Regolith. ######################################## # Release Notes for gruvbox-gtk ######################################## gruvbox-gtk (1.0.1-1) bionic; urgency=medium [ Ken Gilmer ] * Rename root directory of theme to Gruvbox for consistency w/ other GTK themes. * Add gbp config for package management. gruvbox-gtk (1.0-1) bionic; urgency=medium [ Ken Gilmer ] * New upstream version 1.0 gruvbox-gtk (1.0-1) bionic; urgency=medium [ eximus ] * Initial commit * gruvbox theme ######################################## # Release Notes for i3-gaps-wm ######################################## i3-gaps-wm (4.18.2-1~regolith2) bionic; urgency=medium * Package source from upstream https://github.com/Airblader/i3/releases/tag/4.18.2 ######################################## # Release Notes for i3ipc-python ######################################## i3ipc-python (2.1.1-1ubuntu1~ppa6) bionic; urgency=medium * Update build dependencies hoping to resolve packaing problems. ######################################## # Release Notes for i3xrocks ######################################## i3xrocks (1.3.4-1) bionic; urgency=medium [ Ken Gilmer ] * Version bump to match changelog. Cleanup. i3xrocks (1.3.3-1) bionic; urgency=medium [ Will Winder ] * Add optional default resource value. * Minor cleanup. * Free resource allocated by xcb_xrm_resource_get_string * Fix possible truncated resource value. [ Ken Gilmer ] * Add gbp config file ######################################## # Release Notes for picom ######################################## picom (8-1~1.gbp353272ubuntu1) bionic; urgency=medium [ Ken Gilmer ] * Remove github files from debian branch. picom (8-1~1.gbp353272) bionic; urgency=medium [ Ken Gilmer ] * New upstream version 8 ######################################## # Release Notes for plano-theme ######################################## plano-theme (3.36-1-1regolith1) bionic; urgency=medium [ Ken Gilmer ] * New upstream version 3.36-1 ######################################## # Release Notes for plymouth-theme-regolith ######################################## plymouth-theme-regolith (1.0.3-1) focal; urgency=medium * Tweaks to config files. plymouth-theme-regolith (1.0.2-1) focal; urgency=medium * Ship grub file. plymouth-theme-regolith (1.0.1-1) focal; urgency=medium * Add package hooks. ######################################## # Release Notes for pop-fonts ######################################## pop-fonts (1.0.3~1555617065~18.04~a86eb73) bionic; urgency=medium * Auto Build ######################################## # Release Notes for python3-i3ipc ######################################## python3-i3ipc (2.1.1-1ubuntu1~ppa7) bionic; urgency=medium * Changes to python version. i3ipc-python (2.1.1-1ubuntu1~ppa6) bionic; urgency=medium * Update build dependencies hoping to resolve packaing problems. i3ipc-python (2.1.1-1ubuntu1~ppa4) eoan; urgency=medium * Add python-xlib dependency. i3ipc-python (2.1.1-1ubuntu1~ppa2) eoan; urgency=medium * Initial release from https://github.com/altdesktop/i3ipc-python/archive/v2.1.1.tar.gz. ######################################## # Release Notes for regolith-compositor-compton-glx ######################################## regolith-compositor-compton-glx (1.1.0-1) bionic; urgency=medium [ Ken Gilmer ] * Init script will kill pre-existing app instance before starting new. Part of fix for https://github.com/regolith-linux/regolith-desktop/issues/475. regolith-compositor-compton-glx (1.0.10-1) bionic; urgency=medium [ Ken Gilmer ] * Fix typo in compton config file, found by @gservat. regolith-compositor-compton-glx (1.0.9-1) bionic; urgency=medium [ Ken Gilmer ] * Add xrender-sync-fence to handle issue https://github.com/regolith-linux/regolith-desktop/issues/116. regolith-compositor-compton-glx (1.0.8-1) bionic; urgency=medium [ Ken Gilmer ] * Ship config file. regolith-compositor-compton-glx (1.0.7-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-compositor-none ######################################## regolith-compositor-none (1.0.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-compositor-picom-glx ######################################## regolith-compositor-picom-glx (1.1.1-1) bionic; urgency=medium [ Ken Gilmer ] * Fix typo found in https://github.com/regolith-linux/regolith-compositor-picom-glx/issues/1. * Init script will kill pre-existing app instance before starting new. Part of fix for https://github.com/regolith-linux/regolith-desktop/issues/475. regolith-compositor-picom-glx (1.0.1-1) bionic; urgency=medium [ Ken Gilmer ] * Fix typo found in https://github.com/regolith-linux/regolith-compositor-picom-glx/issues/1. regolith-compositor-picom-glx (1.0.0-1) bionic; urgency=medium * Initial release ######################################## # Release Notes for regolith-compositor-xcompmgr ######################################## regolith-compositor-xcompmgr (1.2.0-1) bionic; urgency=medium [ Ken Gilmer ] * Init script will kill pre-existing app instance before starting new. Part of fix for https://github.com/regolith-linux/regolith-desktop/issues/475. regolith-compositor-xcompmgr (1.1.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add ability to override xcompmgr defaults. Fixes https://github.com/regolith-linux/regolith-desktop/issues/382. regolith-compositor-xcompmgr (1.0.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-default-settings ######################################## regolith-default-settings (1.0-1bionic1) bionic; urgency=medium [ Ken Gilmer ] * Add bionic specific gsettings overrides. regolith-default-settings (1.0-1) focal; urgency=medium * Initial release, files moved from package regolith-gnome-flashback. ######################################## # Release Notes for regolith-desktop ######################################## regolith-desktop (2.78-1bionic) bionic; urgency=medium [ Ken Gilmer ] * Move from compton to picom as default compositor. regolith-desktop (2.75-1bionic) bionic; urgency=medium [ Ken Gilmer ] * Change unclutter to regolith-unclutter-fixes to address https://github.com/regolith-linux/speed-ricer/issues/14. regolith-desktop (2.72-1bionic1) bionic; urgency=medium [ Ken Gilmer ] * Version bump for next DE release regolith-desktop (2.71-1bionic1) bionic; urgency=medium [ Ken Gilmer ] * Depend on regolith-default-settings to migrate to gsettings overrides. * Update branch name to conform w/ gbp. regolith-desktop (2.68-1bionic1) bionic; urgency=medium * Package: Remove postinst to unblock upgrades (#432) regolith-desktop (2.60-1bionic1) bionic; urgency=medium * Package: Remove unclutter-startup, if installed regolith-desktop (2.59-1bionic1) bionic; urgency=medium * Bump version file for R1.4.1 release. ######################################## # Release Notes for regolith-ftue ######################################## regolith-ftue (1.0.11-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp config file. ######################################## # Release Notes for regolith-gnome-flashback ######################################## regolith-gnome-flashback (2.6.2-1) bionic; urgency=medium [ Ken Gilmer ] * Remove invalid component from desktop session file. * Cleanup regolith-gnome-flashback (2.6.1-1) bionic; urgency=medium [ Ken Gilmer ] * Rename files to make session work. regolith-gnome-flashback (2.6.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp config file. * Simply package, model directories in package and remove Makefile. * Update session files to refer to regolith over i3-gnome-flashback. Experimental. regolith-gnome-flashback (2.5.0-1) bionic; urgency=medium * Remove desktop files moved to regolith-default-settings. regolith-gnome-flashback (2.4.19-1focal1) focal; urgency=medium * Fix wallpaper gsettings override. regolith-gnome-flashback (2.4.18-1focal1) focal; urgency=medium * Remove non Regolith i3 config file load logic. regolith-gnome-flashback (2.4.17-1focal1) focal; urgency=medium * Move to gsettings overrides for static dconf changes. * Change session name from i3-gnome to regolith. * Remove wm theme setting. ######################################## # Release Notes for regolith-i3-gaps-config ######################################## regolith-i3-gaps-config (2.8.0-1) bionic; urgency=medium [ Bence Ferdinandy ] * adding bindings for next_on_output and prev_on_output (#29) regolith-i3-gaps-config (2.7.2-1) bionic; urgency=medium [ Ken Gilmer ] * Add nm-applet to launch by default. Enables better network connectivity workflow. regolith-i3-gaps-config (2.7.1-1) bionic; urgency=medium [ Ken Gilmer ] * Shorten look-selector to look for rofi menu. regolith-i3-gaps-config (2.7.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add launcher for look selector. regolith-i3-gaps-config (2.6.0-1) bionic; urgency=medium [ Ken Gilmer ] * Based on idea from @Ukaszg, extract all keybindings to Xres keys for easy overriding without i3 file copy. Fixes https://github.com/regolith-linux/regolith-i3-gaps-config/issues/25. * Restart compositor upon i3 restart. Part of fix for https://github.com/regolith-linux/regolith-desktop/issues/475. regolith-i3-gaps-config (2.5.1-1) bionic; urgency=medium [ Moritz Heiber ] * Set tray output to primary by default (#24) [ Ken Gilmer ] * Allow the bar mode (dock|hide|invisible) to be specified by xres overrides. regolith-i3-gaps-config (2.5.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add keybindings for 'next free workspace' feature. regolith-i3-gaps-config (2.4.18-1) bionic; urgency=medium [ Will Winder ] * Add missing keybind for moving the workspace with hjkl. (#19) [ Jordan Cohen ] * shortcuts for explicit window orientation and hierarchical focusing (#18) regolith-i3-gaps-config (2.4.17-1) bionic; urgency=medium [ Markus Bertheau ] * Allow customization of workspace_auto_back_and_forth (#20) regolith-i3-gaps-config (2.4.16-1) bionic; urgency=medium [ ukaszg ] * configurable workspace keys (#17) regolith-i3-gaps-config (2.4.15-1) bionic; urgency=medium [ Ken Gilmer ] * Cleanup from lintian warnings. regolith-i3-gaps-config (2.4.14-1) bionic; urgency=medium * Take smart-gaps fix from @winder. * Comment cleanup. ######################################## # Release Notes for regolith-i3xrocks-config ######################################## regolith-i3xrocks-config (3.2.6-1ubuntu2) bionic; urgency=medium [ Ken Gilmer ] * Fix todo icon from updated material design web icons change regolith-i3xrocks-config (3.2.5-1ubuntu1) bionic; urgency=medium [ Rafael Lacerda ] * Fix crash when focused window name is None (#81) [ Peter Mahnke ] * Remove decimal places from battery number (#80) regolith-i3xrocks-config (3.2.4-1) bionic; urgency=medium [ Ken Gilmer ] * Temp status indicator can be configured with sensor name via Xres value i3xrocks.temp.key. regolith-i3xrocks-config (3.2.3-1) bionic; urgency=medium [ Pedro Kostelec ] * [IMPR] Show aggregated battery percentage (#78) [ Ken Gilmer ] * Fix issue found in livecd enviroment w memory script [ Pedro Kostelec ] * [FIX] Fixes dissapearing indicator when value is 0 (#79) regolith-i3xrocks-config (3.2.2-1) bionic; urgency=medium [ Peter Mahnke ] * Make curl work for special characters (#76) [ Ken Gilmer ] * Remove debugging line mistakenly added by me in earlier fix. regolith-i3xrocks-config (3.2.1-1) bionic; urgency=medium [ Ken Gilmer ] * Fix cpu-usage script regolith-i3xrocks-config (3.2.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add ability to specify temperature unit via xres, and fallback to country locale if unspecified. Based on https://github.com/regolith-linux/regolith-desktop/issues/372. (#72) [ Joel Hoisko ] * Add option to define a specific media player (#63) regolith-i3xrocks-config (3.1.3-1) bionic; urgency=medium [ Ken Gilmer ] * Add ability to override click commands via Xresources. Fixes https://github.com/regolith-linux/regolith-desktop/issues/352. regolith-i3xrocks-config (3.1.2-1) bionic; urgency=medium [ Leo Palmer Sunmo ] * Polish up media-player text splitting and pango formatting (#71) regolith-i3xrocks-config (3.1.1-1) bionic; urgency=medium [ Vipul Mathur ] * Use `MemAvailable` to indicate memory usage (#70) regolith-i3xrocks-config (3.1.0-1) bionic; urgency=medium [ Bence Ferdinandy ] * fixed an error with name somehow being None * adding next-workspace regolith-i3xrocks-config (3.0.34-1) bionic; urgency=medium [ Marten Lienen ] * Exit gracefully if the focused window does not have a name (#68) regolith-i3xrocks-config (3.0.33-1) bionic; urgency=medium [ Ken Gilmer ] * regress debhelper-compat version due to build failure in launchpad. regolith-i3xrocks-config (3.0.32-1) bionic; urgency=medium [ Ken Gilmer ] * Downgrade debhelper version to appease launchpad. * Remove compat file in attempt to appease debuild. regolith-i3xrocks-config (3.0.31-1) bionic; urgency=medium [ Ken Gilmer ] * Downgrade debhelper version to appease launchpad. regolith-i3xrocks-config (3.0.30-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. regolith-i3xrocks-config (3.0.29-1) bionic; urgency=medium [ Ken Gilmer ] * Package: @cheginit's new todo status indicator based on td-cli. regolith-i3xrocks-config (3.0.28-1) bionic; urgency=medium [ Ken Gilmer ] * Package: @buck10's major rework of keyboard-layout. regolith-i3xrocks-config (3.0.27-1) bionic; urgency=medium [ Ken Gilmer ] * Package: Removed verbose output from net-traffic script (#62) regolith-i3xrocks-config (3.0.26-2) bionic; urgency=medium [ Ken Gilmer ] * Update i3xrocks-focused-window-name to use consistent python library name. regolith-i3xrocks-config (3.0.26-1) bionic; urgency=medium [ Taher Chegini ] * Add todo blocklet (#54) [ Ken Gilmer ] * Initial upstream branch. * New upstream version 3.0.25 regolith-i3xrocks-config (3.0.25-2) bionic; urgency=medium * Trying w/ debhelper v11 based on build error. regolith-i3xrocks-config (3.0.25-1) bionic; urgency=medium * Package changes by @moritzheiber: ** Fix button clicks blocklets ** Also fix network bandwidth calculation/shellcheck errors in net-traffic script regolith-i3xrocks-config (3.0.24-1) bionic; urgency=medium * Package @moritzheiber's fixes for disk-capacity and other blocks. * Package @cjohnston1158 additions to net-traffic. regolith-i3xrocks-config (3.0.23-1) bionic; urgency=medium * Add info indicator missed when moving to conf.d config. regolith-i3xrocks-config (3.0.22-2) bionic; urgency=medium * Fixes to weather status for ambiguous city names and cities of multiple words. ######################################## # Release Notes for regolith-rofi-config ######################################## regolith-rofi-config (1.3.1-1) bionic; urgency=medium [ Ken Gilmer ] * Fix look-selector regolith-rofi-config (1.3.0-1) bionic; urgency=medium [ Ken Gilmer ] * Add script to view and select Looks. Minor cleanup. Addresses https://github.com/orgs/regolith-linux/projects/12. regolith-rofi-config (1.2.6-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp config file. ######################################## # Release Notes for regolith-rofication ######################################## regolith-rofication (1.2.3-1) bionic; urgency=medium [ Ken Gilmer ] * Remove scripts that do not apply to user sessions regolith-rofication (1.2.2-2) focal; urgency=medium * Add git-buildpackage config ######################################## # Release Notes for regolith-styles ######################################## regolith-styles (2.6.13-1ubuntu2) bionic; urgency=medium [ Ken Gilmer ] * More tweaks to icons for material design based looks regolith-styles (2.6.12-1ubuntu1) bionic; urgency=medium [ Ken Gilmer ] * Update material design icon-based looks to use fonts-materialdesignicons-webfont 1.6 mappings regolith-styles (2.6.11-1) bionic; urgency=medium [ Ken Gilmer ] * Add regolith.look Xres entry for currently set look. regolith-styles (2.6.10-1) bionic; urgency=medium [ Ken Gilmer ] * If Regolith user root Xres file exists, move old copy to tmp instead of aborting. Sort looks. Misc cleanup. regolith-styles (2.6.9-1) bionic; urgency=medium [ Ken Gilmer ] * Check a flag before executing gnome-terminal profile script. Fixes https://github.com/regolith-linux/regolith-desktop/issues/471. regolith-styles (2.6.8-1) bionic; urgency=medium [ Ken Gilmer ] * Update term colors for Dracula for more variance and remove conflict for color 11. Addresses https://github.com/regolith-linux/regolith-styles/issues/32. regolith-styles (2.6.7-1) bionic; urgency=medium [ Ken Gilmer ] * Change selected item background color to addresss https://github.com/regolith-linux/regolith-styles/issues/23. regolith-styles (2.6.6-1) bionic; urgency=medium [ Ken Gilmer ] * Add next-workspace glyph for missing looks. Change sound, mute, ram glyphs for fontawesome looks. regolith-styles (2.6.5-1) bionic; urgency=medium [ Ken Gilmer ] * Fix font dependency for pop-os. Cleanup control file. regolith-styles (2.6.4-1) bionic; urgency=medium [ Ken Gilmer ] * Add package for regolith-look-pop-os. regolith-styles (2.6.3-1) bionic; urgency=medium [ Aditya Wagh ] * Create Pop!_OS Style (#29) [ Ken Gilmer ] * Update gtk theme name for consistency. * Add packaging data for pop-os look. regolith-styles (2.6.2-1) bionic; urgency=medium * Specify glyph for next-workspace status indicator for fontawesome and materialdesign. regolith-styles (2.6.1-1) bionic; urgency=medium [ Ken Gilmer ] * Package the dracula look. regolith-styles (2.6.0-1) bionic; urgency=medium [ Drew DeVore ] * Create Dracula Theme (#30) [ Julius Francisco ] * Remove user specific path (#31) regolith-styles (2.4.27-1) bionic; urgency=medium [ Ken Gilmer ] * Fix typo in package file. regolith-styles (2.4.26-1) bionic; urgency=medium [ Ken Gilmer ] * Fix gruvbox missing files on install. regolith-styles (2.4.25-1) bionic; urgency=medium [ Ekans ] * Create gruvbox style (#25) [ Ken Gilmer ] * Add packaging for gruvbox. regolith-styles (2.4.24-1) bionic; urgency=medium [ Chua Hou ] * Balance workspace name by adding space at end (#20) regolith-styles (2.4.23-1) bionic; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-system ######################################## regolith-system (1.4.0.4-1) focal; urgency=medium [ Ken Gilmer ] * Add gbp conf file, cleanup. ######################################## # Release Notes for regolith-unclutter-xfixes ######################################## regolith-unclutter-xfixes (1.5-2) bionic; urgency=medium [ Ken Gilmer ] * Fix linter warning * Revert \u0026quot;Remove master files\u0026quot; regolith-unclutter-xfixes (1.5-1) disco; urgency=medium [ Ken Gilmer ] * Initial release ######################################## # Release Notes for remontoire ######################################## remontoire (1.4.0-1) bionic; urgency=medium [ Ken Gilmer ] * Specify font for windows glyph in stylesheet. * Increase buffer to 128Kb to handle larger i3 config files * Add feature to consume for stdin and specify arbitrary string prefix for more config file format support. * Fix window positioning in multi-monitor setups. ######################################## # Release Notes for td-cli ######################################## td-cli (1.2.4-7) bionic; urgency=medium * Initial release ######################################## # Release Notes for xrescat ######################################## xrescat (1.2.1-1) bionic; urgency=medium [ Ken Gilmer ] * Cleanup lintian warnings. * Version bump to appease launchpad xrescat (1.2.0-1) bionic; urgency=medium [ Jeremy Coghill ] * added logic to exclude surrounding double quotes from returned strings to allow for the use of leading and trailing spaces in resources. updated version number. updated man page [ Ken Gilmer ] * Update README for new double quote handling. Add gbp config. Cleanup. "},{"id":23,"href":"/docs/reference/Releases/regolith-1.4.1-release-notes/","title":"1.4.1 Release Notes","section":"Releases","content":"Regolith R1.4.1 is a fast follow up to 1.4 that fixes a few serious bugs, detailed on the mailing list. In addition to the package updates, a new boot animation is provided by the package plymouth-theme-regolith that is installed by default on the ISO. The ISO also now excludes a deprecated touchpad driver that was conflicting with Settings. Existing PPA-based installations can simply get the updates via their typical package update process. Regolith Linux ISO users can update to R1.4.1 by applying regular package updates.\n"},{"id":24,"href":"/docs/reference/Releases/regolith-1.4-release-notes/","title":"1.4 Release Notes","section":"Releases","content":"Regolith R1.4 is a major feature release which includes several improvements and optimizations. Regolith is now smaller and more efficient. The ISO-based installer is now based from the Xubuntu image, and moves from the gdm3 display manager to LightDM. This allows for less resource consumption at runtime and dramatically smaller download size1. A new look, lascaille and file search dialog round out the major new features. Read below for more details.\nIf you maintain your own i3 config file, note that the copy shipped in Regolith 1.4 has changed in that it reads more configuration from Xresources. The intention of this change is to require a full copy of the i3 config file less often, by allowing users to customize the system via Xresource overrides instead of copy/edit of the i3 config file. For R1.4 in particular @ploum has provided many of the ideas and validation. Gratitude goes out to Regolith contributors and users @cheginit, @nalderto, @baldrailers, @ivomarino, @Josh-Letts, @LawZava, @SkyyySi, @tomster, @gdeflaux, @appelgriebsch, @farsil, and @MrKovar for their time and attention. Also thanks to all that helped to test and filed issues for bugs and feature requests!\nKnown Issues # Issues and fixes are being tracked in this project.\nFeatures # Feature Screenshot Description Remontoire 1.3.1 - Can render keybindings from i3 over socket or from any file. - Can be configured to display on any screen edge. - Visual updates and bug fixes. - Presentation changeable via CSS. New default look: Lascaille A new look with a bolder, tighter typeface and a darker, higher contrast color theme has become Regolith\u0026rsquo;s default look in 1.4. Cahuella and other looks continue to be available and can be installed with a few commands. New File Search Dialog Based on Rofi and mlocate, users can now quickly find files and launch their default editors from a global dialog. Faster, Easier Customization Virtually everything exportable from the i3 config can now be overridden directly with Xresources declarations, from changing the meta key to specifying the command that launches the app search dialog. Additionally, up to 3 user configured programs can be set to start upon session initialization. All of this is possible without creating a user copy of the i3 config file, but rather by overriding a specific Xresources. i3xrocks supports conf.d style configuration The status indicators in the bar can now be installed and configured independently. This allows for a cleaner dependency model and more efficient runtime characteristics. It also provides future flexibility for user contributed modules and status indicators. Plus, users can provide their own block descriptors in the user directory to easily override the defaults without having to change the i3 config file. New architecture support: arm64 With testing done on a Raspberry Pi 4, Regolith now is installable via PPA when using Ubuntu on arm64 devices with the necessary hardware support. Rewrite of Rofication Rofication has been rewritten to require less dependencies and be more stable by Regolith contributor @farsil. New Ubuntu release support: Focal Fossa Regolith runs as a desktop environment in Canonical\u0026rsquo;s latest release of Ubuntu: 20.04 \u0026ldquo;Focal Fossa\u0026rdquo; Time and Space Optimizations in ISO release By switching from GDM3 to LightDM, Regolith avoids loading some unnecessary desktop components into RAM, resulting in between 200MB to 300MB savings on cold start. Additionally, the LiveCD installer is now based on the Xubuntu LiveCD which dramatically lowers the size of the installer and install image of the system2. Finally, with more fine-grained control of the bar status blocks, only the blocks you\u0026rsquo;ve installed will run. Pluggable Desktop Notification Components Users can now cleanly switch between desktop notification implementations such as dunst and notify-osd, in addition to Rofication without resorting to hacks. Integrate gnome-terminal over st-term by Default Regolith 1.4 uses gnome-terminal with a dynamically generated profile to overcome some character encoding and input devices. st is still available, simply by installing the regolith-st package. Picom (Compton) config can be overriden by user Users can provide their own Picom compositor config in their user directory. i3 reload becomes Regolith reload Refreshing the UI (look, colors, fonts, etc.) after making changes is now as easy as super shift r . Polish, polish, polish Just as in previous releases, many tiny fixes and enhancements were added to Regolith in version 1.4. Fixes # Have a look at the R1.4 project page for a list of bug fixes.\n This does not mean that Regolith uses Xfce4 or any other aspect of Xubuntu other than the install image. \u0026#x21a9;\u0026#xfe0e;\n The trade-off is that users need to install more of the software they require after installation. \u0026#x21a9;\u0026#xfe0e;\n "},{"id":25,"href":"/docs/reference/Releases/regolith-1.3.1-release-notes/","title":"1.3.1 Release Notes","section":"Releases","content":"R1.3.1 is a quick followup to R1.3 that adds polish and usability features. Headlining features include a more concise way of overriding Xresource defaults and several enhancements to the Remontoire keybinding viewer.\nIf you maintain your own i3 config file, note that the copy shipped in Regolith 1.3.1 has changed in that the comment format has been modified to be readable by Remontoire (example). Without updating your copy i3 config comments, you will not see any keybindings. Features # Feature Screenshot Description Remontoire 1.1.1 Provides a live view of active i3 keybindings, introduces a machine-readable comment format for i3 config files, and fixes several layout and presentation bugs reported by users. Ayu Looks The community contributed Ayu themes have been fully integrated into Regolith with updates to package dependencies and configurations. Rofi polishing Numerous updates to the Rofi themes for all provided looks. Easier Customization Now, overriding specific Xresources values can be easily done by supplying only the overrides in ~/.config/regolith3/Xresources without needing to copying and update any existing files. Additionally, any Xresources files in ~/.config/regolith3/Xresources.d can be referenced without absolute path, enabling easier multi-machine configurations. Utilize GNOME and update-alternatives for Default Apps GNOME settings for default browser and update-alternatives for preferred terminal are now used by Regolith. No custom configuration changes are required. Xresources updates More UI configuration pulled out of component configs and into Xresources provides more flexibility in how custom looks can be. Locale used for date/time format For those not using the US date and time formats, the bar clock will now automatically use the GNOME hour format and the locale LC_TIME setting to automatically display date and time in the regional form without configuration. UI tweaks and polishing Many small updates across all UI components to further polish the interface, including a new optional dark background adapted from work by /u/InfernusZ9. Fixes # Debian package dependencies for various Regolith Looks have been fixed. Layout issues with Remontoire have been addressed. Compton configuration cleaned up "},{"id":26,"href":"/docs/reference/Releases/regolith-1.3-release-notes/","title":"1.3 Release Notes","section":"Releases","content":"Following R1.2, the 1.3 release focused on usability issues reported by users and a continuing refinement of the desktop environment in general, with a focus on making the system easier for those inexperienced with tiling window managers.\nFeatures # Feature Screenshot Description Cahuella GTK Theme A new GTK theme was created for Regolith that more closely follows the standard GNOME theme, Adwaita. Keybindings Dialog To allow for a more consistent look and collapsible content for various monitor dimensions, a custom shortcut dialog was developed called Remontoire. Pluggable Compositors The subsystem providing visual effects, the compositor, can behave differently based on hardware and driver support. Regolith now packages 3 compositor backends: compton-glx (based on Picom), xcompmgr, and none. i3-snapshot In office environments it is common to switch between various display configurations (desk, meeting room\u0026hellip;). i3-snapshot allows the user to quickly save and restore existing window layouts in a session. New Rofi theme Based on work by /u/InfernusZ9, the Rofi launcher is less distracting. New notification UI based on Rofication The previous notification UI was a hold over from more traditional desktop environments that prefer to present an on-screen dialog when a notification is received. Because user-focus is paramount, this was changed such that an indicator in the bar displays the number of unread notifications and the user decides when to view them via a keybinding or button click. Floating Control Panel The gnome-control-center app can have a hard time adapting to constrained tiled layouts common with i3-wm. Now when the control panel is loaded, it floats above the existing windows to allow for a quick settings change without impacting other apps. Clickable Bar Status Actions For convienence, the default blocks on the bar will launch configuration apps for the associated block. For example, the battery block will launch the power settings control panel, and the notification block will launch the notification viewer. Discrete and packagable Looks The underlying style framework used by Regolith has been revamped to allow for \u0026ldquo;looks\u0026rdquo;: colors, themes, typeface, and other thematic state. Looks can be switched with a single command. New bar status components Network, keybindings, notifications, focused window, and other blocklets have been improved and added. Build System Build scripts were added and improved to allow for the generation of Regolith packages in an automated fashion, making it easier for others to roll their own. Website An entirely new website is launching with R1.3, to integrate more content and make it faster for users to find information. Fixes # i3-gaps-wm: Fix for workspace label bug on startup. Revamping some keybindings based on user feedback. i3xrocks: numerous tweaks and fixes for status indicators. regolith-gnome-flashback: numerous fixes and policy enhancements to session management. ISO Generation # The following commands were applied via the Cubic tool to the stock Ubuntu 18.04 and 19.10 installer images to generate the Regolith Install ISO:\n$ sudo add-apt-repository universe \u0026amp;\u0026amp; sudo add-apt-repository ppa:regolith-linux/release $ sudo apt remove aisleriot branding-ubuntu cheese* gnome-mahjongg gnome-sudoku gnome-mines gnome-todo* gnome-video-* libchees* libgnome-games* libreoffice* remmina* rhythmbox* shotwell* thunderbird* totem* ure ubuntu-session ubuntu-web-launchers $ apt install regolith-desktop regolith-gdm3-theme $ sudo apt autoremove $ cp /usr/share/backgrounds/lucas-bellator-C0OD8OM-oM0-unsplash.jpg /usr/share/backgrounds/warty-final-ubuntu.png The purpose of removing several packages such as games and libreoffice was to reduce the ISO size. All packages removed in the ISO are installable via the apt tool or via the Ubuntu app store.\n"},{"id":27,"href":"/posts/localization/","title":"Looking for Translators","section":"Blog","content":"With the 2.0 release out the door, we\u0026rsquo;re looking for help to translate the index page and the \u0026ldquo;using regolith\u0026rdquo; section into languages other than English. In the past we\u0026rsquo;ve used a translation system, but it turned out to be too complex for many people to understand. For the Regolith 2.0 site we\u0026rsquo;ll rely on Hugo\u0026rsquo;s multilingual support.\nFor a given language translation the following files must be translated:\ncontent/_index.md content/docs/using-regolith/basics.md content/docs/using-regolith/configuration.md content/docs/using-regolith/first-launch.md To provide a translation, simply copy the English file and add the two-letter language code to the end of the filename. Once the translation is complete, create a pull request and we\u0026rsquo;ll merge your translation. This allows other people to read about Regolith with your language translation.\nAs an example, if a Japanese translation was provided, the following new files would be added to the PR:\ncontent/_index.ja.md content/docs/using-regolith/basics.ja.md content/docs/using-regolith/configuration.ja.md content/docs/using-regolith/first-launch.ja.md There is some additional Hugo configuration before the translation will be available, but we can take care of that. Feel free to open an issue or reach out on GitHub Discussions with any questions, and thanks in advance!\nTranslation Workflow # Here are some step-by-step instructions for creating a translation:\n Create a fork of the GitHub repo that contains the Regolith Desktop website. (learn more) Clone the fork to your local computer. Determine the two-letter designation for your language. Copy the following files to new files with the two-letter language designation (see example above). Translate the content to your language. Commit and push the changes to your fork of the website repository. Create and submit a pull request. By creating the pull request, Regolith project members will be notified to review and push your changes.\n"},{"id":28,"href":"/docs/reference/build-system/","title":"Build System","section":"Reference","content":"Overview # This page describes how packages are generate from source code, and how those packages combine to actualize the Regolith desktop environment. This document covers Regolith only and does not intend to describe upstream dependencies, general package manager concepts, or other aspects of build systems.\nTerms # Distro - Short for distribution, in the context of this document, may be considered a variation of a Linux-based OS operating system. A product, project, and brand. Codename - A well defined and announced snapshot of a set of packages that are consumed as a whole. May be considered a software release with a specific name such as 36 or Jammy. Architecture - In the context of this document, denotes a CPU and base system hardware. Regolith currently targets the amd64 and arm64 architectures. Stage - Represents a snapshot of a set of packages at a modeled level of maturity. In Regolith the following stages from least-stable to most-stable are modeled: experimental - For packages and package changes that may be reverted, removed, or change significantly over time. Serious bugs are common and expected here. unstable - For packages changes that are planned to reach a release but have yet to undergo much testing. Serious bugs may occur from time to time. Regolith core developers may run their testing and development from this stage but users are discouraged from consuming packages from unstable. testing - For packages undergoing testing by Regolith developers and early adopters. Bugs occur but serious bugs should not often pop up in this stage. Regolith users that wish to get access to fixes and new features earlier may consume from this stage with the understanding that bugs are to be expected (, and reporting them is appreciated!) release - For packages that have been determined to be suitable for general use. While minor bugs may be present in packages at this stage, the bugs present should not interfere with general use of the environments for users on supported distros and releases. Target ~ Represents a specific sequence of distro, codename, stage, and architecture for which a set of packages exist. Manifest ~ A file that specifies a set of the properties name, origin, and snapshot for a list of packages. A manifest is a file that represents a snapshot of a target in time. Package Manager ~ A set of formats and programs that allow for packages to be installed in a distro. The package manager may very by distro. Package Repository ~ A well defined source of binary packages that may be installed into an OS that supports a given package manager. Source Repositories # All Regolith packages are generated from git-versioned source repositories. These repositories house the source code for a given component. Mostly, each component is general for any given distro and codename. Source repositories are modeled in the Regolith build system via manifest files.\nManifests # The Regolith build system reads and writes text files known as manifests. The files are initially read as the source of truth for what a given target package repository should contain. If the build system determines if there are updates to the manifest present in the manifest\u0026rsquo;s source repositories, then any updates are built into package updates and published to the target repo along with the updated manifest. In the case that no updates are found, the build simply completes without any changes. As such, a given target\u0026rsquo;s manifest can be used to determine what packages, versions, and source branches/tags are present.\nManifest Schema # Manifests are simply text files with one package per line, and each element in on a line separated by a space (ASCII 32).\n\u0026lt;PACKAGE NAME\u0026gt; \u0026lt;PACKAGE REPO URL\u0026gt; \u0026lt;PACKAGE REPO BRANCH/TAG\u0026gt; \u0026lt;PACKAGE REPO COMMIT HASH\u0026gt; Package Model # The Regolith build system utilizes sets of JSON files to define what packages are specified for a given target. These JSON files are set in a specific structure to facilitate overriding higher-scoped contexts for lower-scoped contexts. For example, at the top level is the release directory. It specifies all packages for that release. Within a release, directories for specific distros exist. Package models in these directories may override or nullify packages specified from it\u0026rsquo;s parent. In this way, a top-level general package model can be tweaked for a given stage/distro/codename/architecture. To further illustrate this point here is the structure of the stage directory in the voulage repo (which is the name of the Regolith 2.x package builder) (NOTE: some files were removed for brevity):\nstage/ ├── package-model.json \u0026lt;--- Root package model ├── release │ ├── debian │ │ └── bullseye │ │ └── package-model.json │ ├── package-model.json \u0026lt;--- Package model for the release stage │ └── ubuntu │ └── jammy │ └── package-model.json ├── testing │ ├── debian │ │ └── package-model.json │ ├── package-model.json │ └── ubuntu │ └── jammy │ └── package-model.json └── unstable ├── debian │ ├── bullseye │ │ └── package-model.json │ └── testing │ └── package-model.json \u0026lt;--- Customizations for Debian Testing in unstable stage ├── package-model.json └── ubuntu └── jammy └── package-model.json Packages # As mentioned above, the build system generates packages for a given target from it\u0026rsquo;s manifest. The build system is designed to be agnostic to any particular package format. As such, package versions are not directly modeled in manifests. The mechanism that determines if a source change results in a version bump is delegated to package-manager specific extensions. After a package has been identified to require building, the build system delegates to the package-specific build system to generate the target packages, such as debian source and binary packages. If the package update builds successfully, another package-manager extension is called to inject the newly built package into the distro-dependant package repository.\nPackage Build System # The Regolith build system consists mainly of bash shell scripts. These scripts are run from GitHub workflows but are designed to be runnable directly from the appropriate local environment to facilitate easy testing and troubleshooting. The following is a high level summary of what the package builder does once invoked:\n Set up source state such as the target string, which is generated from \u0026lt;stage\u0026gt;-\u0026lt;distro\u0026gt;-\u0026lt;codename\u0026gt;-\u0026lt;architecture\u0026gt; Download the current manifest from the target repository Generate the merged package model starting from the root and working into each segment in the target string With the merged model, iterate over each package, generating a manifest entry by resolving the commit hash from the specified ref After all manifest entries are generated, compare the generated manifest with the earlier downloaded copy If no changes found, exit because no packages have changes on the specified refs Otherwise, package changes have been detected. Download the entire target repository For each difference found, delegate to distro-specific build package build and repo publish commands Publish the updated repository and manifest back to the target repository ISO Build System # The ISO builder is based on the open source project live-custom-ubuntu-from-scratch. The ISO builder uses a set of shell scripts to generate an Ubuntu ISO image for both a live environment and an installer. Regolith customizes this project in this repo with some specific packages to install and remove. A github workflow is used to generate the ISOs and upload them to GitHub for hosting.\nCookbook # How to add or update a package to the build system # Determine which stages, distros, codenames, and architectures the change applies to (ex: unstable-ubuntu-jammy-amd64) Edit the package model in the stage directory in the Voulage Add or edit the package stanza JSON for that package (example) Commit the change Execute the build workflow Once the build completes, check the releases in Voulage to verify that the generated packages were produced and published as expected How to determine what commit a package is built with in a given target package repo # Download the manifest contained in the target package repository (https://regolith-desktop.org/\u0026lt;STAGE\u0026gt;-\u0026lt;DISTRO\u0026gt;-\u0026lt;CODENAME\u0026gt;-\u0026lt;ARCH\u0026gt;/manifest.txt) Find the line containing the package name Note the branch and ref in the manifest, this is the repo commit from which the package was built How to extend the build system for a new package format # For an example read the Debian v4 build workflow Refer to the Debian extension script that the workflow uses Create an extension script that maps from the git source of each package to the target distro\u0026rsquo;s packaging format "},{"id":29,"href":"/posts/announce-regolith-2/","title":"Announcing Regolith 2","section":"Blog","content":"Introduction # Regolith 2 is the next major release of the Regolith Desktop environment. Here is a summary of the big changes in the release:\n Use i3 or i3-gaps interchangeably Simplify the loading of Xresources, discovery, and management of looks Support for i3 config partials, allowing for safer and richer extension capabilities Provide a package topography necessary for future changes including alternative sessions and backends Debian Bullseye support, along with Ubuntu Focal and Jammy Move to new custom desktop executor ilia from rofi for app and command launching, notifications, and more Regolith 1.6 is the end of the line for the existing Regolith desktop. The new major version 2 provides for a simplification of Regolith as a whole, with some new features as well. This upgrade will not be backwards compatible with 1.x series (but as always, users may choose to specify their own i3 config). However Regolith 2 is not radically different than the previous version. This major version bump is to allow for users to upgrade on their own schedules. As such, the 1.x package repository (PPA) will not be used for Regolith 2 packages.\nRelease Status # We\u0026rsquo;re currently in pre-alpha phase of the development process. The environment is generally stable for day to day work, however because we\u0026rsquo;re reserving the right to make big changes still, using it in a production context is not recommended at this time.\nShipped Changes # Convert i3 config to partials conf.d style Xresource discovery Migration from rofi to ilia as the desktop executor Migration to nerdfonts for looks to simplify and enhance font icons A new build system decoupled from launchpad.net facilitating easier and more consistent distro development Port of looks lascaille and nord from the 1.x looks Changes in Development # New website (this one!) Polish for ilia Bugs in wallpaper handling (gnome/dotfiles) Better HiDPI support out of the box Better first time user experience Porting most existing looks to new Xresource schema Rebranding from \u0026ldquo;Regolith Linux\u0026rdquo; to \u0026ldquo;Regolith Desktop Environment\u0026rdquo; Expected Release Date # Due to the volunteer nature of the Regolith project, it\u0026rsquo;s simply not possible to a promise ship date. However, we would like to have something usable by the time of the next LTS version of Ubuntu is released, in April 2022.\nExpected Upgrade Experience # The Regolith 2 desktop environment will require the removal of the existing Regolith 1.x PPA and the addition of a new Debian repository. regolith-desktop will continue to be the top-level package that provides the complete desktop environment. As before, i3 config files can be entirely controlled by users by staging a copy in their XDG user configuration directory, however with i3 4.20+, a new option of simply providing any additional configuration via config partials is also supported.\nLearn More # See here for details on how to install the current pre-release version of Regolith 2, and here for information on how you can provide feedback or contribute.\n"},{"id":30,"href":"/posts/attribution/","title":"Thanks to","section":"Blog","content":"The Regolith Desktop exists as an integration of many open source projects and a little bit of glue code and some unique desktop components. The Regolith project is built upon many projects.\nThe following projects in particular deserve special mention:\n The i3 community, including Michael Stapelberg and Ingo Bürk. The Rofi community, including Dave Davenport. Picom, an actively maintained desktop compositor, including yshui. The Gnome Flashback project, supported by Alberts Muktupāvels and Dmitry Shachnev. Other i3-GNOME integrations by Jesús Castro and Alex Palaistras. The i3status community, including Vivien Didelot. Design innovation by Arctic Ice Studio and Ethan Schoonover and Ayu Theme. Proper nouns sourced from the fiction of Alastair Reynolds. The beautiful GTK themes by Eliver Lara. Wallpapers by Psiu Puxa, Lucas Bellator, and Luca Bravo. Icons by Sam Hewitt. Simple and powerful build tools via the Cubic project by PJ Singh. Infrastructure by Canonical and GitHub. "},{"id":31,"href":"/posts/sway_integration_gsoc/","title":"Foundations for Regolith on Wayland (GSoC'22)","section":"Blog","content":"Introduction # Regolith is a modern desktop environment designed to let you work faster by reducing unnecessary clutter and ceremony. It offers a keyboard based workflow and a tiling window manager that allows efficient management of windows, monitors and workspaces. Built on top of Ubuntu, GNOME Flashback, and i3, Regolith stands on a well-supported and consistent foundation.\nIn its current implementation, the use i3 window manager binds Regolith to X11. While X11 is fairly mature, it was never built for modern systems and is based on assumptions that are valid only for computers of the ’90s. Some of the issues present in X11 based window managers are low framerates, poor support for HiDPi panels, higher latency, screen tearing etc. Wayland is a display protocol that is written from scratch and aims at simplicity and extensibility Wayland has been in development for quite some time now and its implementations are now stable enough to be considered for daily usage. In fact, many desktop environments like gnome are now providing their wayland implementations as default. Sway window manager was introduced as a drop-in replacement for i3. It is based on wayland and is devoid of most of the issues present in X11 based window managers and compositors.\n Note: The work described in this post was done as part of my Google Summer of Code (GSoC) 2022 project under the organisation CCExtractor.\n Objective # The project intends to achieve integration of swaywm with the regolith ecosystem. This means, compatibility with GNOME services, integration of a configuration management system, theming using regolith look and support for other extras provided by regolith in a wayland-based environment.\nIntegrating sway with regolith # In this section, I will described everything that I did to achieve sway integration with regolith. This required modifying several existing packages as well as writing code for new scripts and binaries.\nPorting the regolith app launcher (ilia) to wayland # After having a discussion with Ken, we decided that the most important part of a tiling window manager setup from a user\u0026rsquo;s perspective is the app-launcher. Regolith on X11 ships with its own app launcher called ilia. It also provides several features apart from launching apps. This includes showing keybindings, launching terminal commands, list applications and workspaces and search files just to name a few.\nIlia is written in vala and GTK. This means, ilia had support for wayland right out of the box. Despite this inherent compatibility, ilia seemed to crash everytime. After looking into the logs, I realised that the issue was not with ilia but with the way wayland roots (wlr) handles windows that need to be ignored by the compositor. Turns out, wlr provides an extension to the wayland protocols called wlr-layer-shell in order to handle panels and other applications that need to be positioned automatically. A client implementation of this protocol for GTK based applications is provided by the library gtk-layer-shell. To maintain support for both X11 and wayland, I check the XDG_SESSION_TYPE environment variable and use gtk-layer-shell library only if the session type is wayland.\nCurrently, the wayland compatible version of ilia is not packaged and exists in a seperate branch.\nTrawl - A backend agnostic configuration manager # Wayland lacks support for Xresources natively and requires the use XWayland. This might not be desirable as it forces users to enable Xwayland forcing them to be a part of a legacy ecosystem. This is the reason why we decided to create a display backend agnostic configuration manager that can be used by various applications. To maintain compatibility with the existing regolith ecosystem it was crutial to replicate the format and functionaility XResources as much as possible. Trawl is a file based configuration management system written in rust that tries to fulfill these requirements.\nTrawl is comprised of two parts - Configuration Daemon (trawld) and Trawl Client (trawldb). For IPC, it uses the DBus specification, which allows other applications to access trawl resources with ease. In fact, trawl comes with libraries for C and rust that make interaction with trawl clients hassle free. Trawl also tries to replicate most of the features provided by Xresources by replicating the functionality available using the xrdb CLI.\nSway - adding the set_from_resource command # Sway aims to be a drop in alternative for i3. But there are some features which make sense only within the X11 ecosystem, and one such feature is the set_from_resource command in the configs. This command allows users to set variables within the i3 configurations by querying XResources for specific keys. Due to the lack of XResources alternatives that are display backend agnostic, the creators of sway decided not to implement it, even if its at the cost of breaking compatibility with i3 configurations.\nRegolith relies heavily on XResources based configurations. This helps acheive functional configurations to some extent, such that you can replicate your window manager setup just by copying over your XResources and config partials. In order to maintain a consistent experience across the board, it was absolutely crutial to re-implement set_from_resource for sway.\nI created a fork of sway called sway-regolith which adds the set_from_resource command. In order to communicate with the trawl demon, I used the wrapper functions provided by the libtrawldb library, which provides several wrapper functions for the DBus methods. Finally, I renamed the sway binary to sway-regolith in order to allow the fork and the upstream versions of sway to co-exist.\nRegolith-displayd # In regolith, the de facto way for managing and changing settings is the use of gnome-control-center. Since the displays are managed by X11 in both i3 and Gnome on X11, the display panel of gnome-control-center works right out of the box. However, in the case of wayland based compositors and window managers like sway and mutter on wayland, the diplays are managed by the compositor itself. So gnome-control-center can manage displays only when mutter is the compositor in use.\nOn looking into gnome-control-center\u0026rsquo;s codebase, I discovered that the display settings are applied by communicating with the org.mutter.DisplayConfig DBus interface. So I created regolith-displayd, which creates a DBus interface with the same name. It primarily provides two DBus methods - GetCurrentState and ApplyMonitorsConfig. The GetCurrentState method gets the current configuration of monitors and maps it into a format understandable by gnome-control-center. Similarly, calls to the ApplyMonitorsConfig method applies the display settings changes made from gnome-control-center by mapping them into a format understandable by the IPC interface of sway.\nregolith-displayd also polls the sway IPC interface to check for changes in display configuration. If a change is detected, the MonitorsChanged signal is emmitted. gnome-control-center reacts to this message by making a call to GetCurrentState.\nIn order to achieve display configuration persistance, regolith-displayd generates kanshi profiles based on the displays that are currently in use. These configurations are then automatically applied whenever the same monitors are connected.\nRegolith-session # regolith-session package is probably the most important part of regolith as it essentially ties i3 with GNOME flashback. This package is also partly responsible for the regolith-look related functionality. The code for wayland version of the package can be found in the wayland-dev branch.\nMigrating regolith-session to wayland required work on the following sections.\nSession initialization script (regolith-session-wayland) # This script is responsible for loading the trawl resources set by the user, loading current look information, reformatting pango markup for workspace names, registering the session with gnome session manager and launching sway with the regolith configuration file.\n/usr/share/applications/regolith-wayland.desktop # This application file executes the regolith-session-wayland script. This application file will be read by gnome-session-binary while loading the Required Components from the session file.\n/usr/share/gnome-session/sessions/regolith-wayland.session # This file lists out the components required by the session in order to work correctly. If all the required components cannot be loaded, the session ends abruptly with an error. Most of these components are gnome-settings-daemon plugins. If the session is loaded using gnome-session --builtin, it launches the required components using their respective application files instead of launching their systemd services. The regolith-sway desktop file is also included in the required components section which launches ultimately starts the regolith session.\n/usr/share/wayland-sessions/regolith-sway.dektop # This file is read by the display manager / login manager and shows the entry Regolith on Wayland in the login screen. The command /usr/bin/gnome-session --builtin --session=regolith-wayland is executed as soon as you login. This command looks for /usr/share/gnome-session/sessions/regolith-wayland.session and loads the required components.\n/usr/lib/regolith/regolith-session-common.sh # This provides functionality that is used in multiple scripts (related to both X11 and wayland based sessions). It also contains some variables that are required by many of the scripts related to regolith-session. I\u0026rsquo;ve added several functions and environment variables that are required to provide functionality equivalent to what is provided by Regolith on X11 sessions.\nRegolith look script (/usr/bin/regolith-look) # This provides theming related functionallity, which is one of the defining features of the regolith ecosystem. I\u0026rsquo;ve added a check to determine if the current session type (X11 or Wayland). If the current session is wayland, trawlcat is used instead of xrescat and swaymsg reload is used instead of i3-msg refresh. When loading a look, if the current session is wayland, the configurations are loaded into trawl and if the session is X11, the resources are loaded using xrdb as XResources.\nRegolith Look # The functionality of the regolith-look script (located at /usr/bin/regolith-look) has been discussed in the previous section. In order to apply the theme, a loader script is required. This can either be provided by the look or the user. If no loader is provided, the default loader script (present in the regolith-look-default package) is used. To make this loader script compatible with trawl in wayland, I had to check if the current session is wayland and set the RESOURCE_GETTER variable to trawlcat accordingly.\nRegolith also uses gnome-terminal by default. So in order to provide terminal theming in wayland, the regolith-init-term-profile script also needs to use trawlcat as resource getter. This script is responsible for changing the terminal profile theme.\nRegolith-inputd # Similar to outut management, input management in wayland is also dependent on the compositor. This is the reason why changing input settings from gnome-control-center doesn\u0026rsquo;t work out of the box. In order to get the input panel of gnome-control-center to work, I created regolith-inputd, which monitors the gsettings schema org.gnome.desktop.peripherals. This allows to map changes in input properties to sway configuration commands which are then applied using the sway IPC interface.\nWhat\u0026rsquo;s next? # You can track work related sway integration in this GitHub projects page. All contributions are more than welcome. I have really enjoyed working on this project and I plan to continue even after I\u0026rsquo;m done with the final evaluation for Google Summer of Code.\nWhat doesn\u0026rsquo;t work # Lock Screen (Alternatives - swaylock) GNOME OSD overlays (Alternatives - wob) GNOME flashback / gnome-shell-related stuff Using any Display Manager other than GDM 3 causes issues swaybar status (requires several reloads to work properly) ilia keybindings page gnome-session-quit popup "},{"id":32,"href":"/docs/howtos/workspace-on-output/","title":"Assign a workspace to a specific Output (Display)","section":"How To","content":"i3 # NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. In order to configure i3 to assign a workspace to a given monitor, first find the device name for the monitor you wish to use with xrandr:\n$ xrandr --listmonitors Monitors: 1 0: +*eDP-1 1920/309x1080/173+0+0 eDP-1 In this case, the output name is eDP-1. Next add a line like this into a staged copy of your i3 config file:\nworkspace \u0026quot;$ws1\u0026quot; output DP1 Log back in for the changes to take effect.\nSway # The concept is the same, but swaymsg is used to display the available outputs.\n$ swaymsg -t get_outputs Output HDMI-A-2 'ViewSonic Corporation VG2448 V5E192121969' [...] To assign workspace $ws1 to the HDMI-A-2 output put the following line into a staged copy of your sway config file:\nworkspace $ws1 output HDMI-A-2 "},{"id":33,"href":"/docs/howtos/add-remove-blocklets/","title":"Change Bar Status indicators","section":"How To","content":"Adding or Removing status indicators # Finding Status Indicators # $ apt search i3xrocks- Installing a Status Indicator # $ sudo apt install i3xrocks-memory $ regolith-look refresh Customization of the i3 bar # Each status indicator on the bar is managed by a file. The name of the file maps to the position of the status indicator on the bar, e.g. a file\u0026rsquo;s name starting with 10_ mean its corresponding indicator will be positioned before an indicator which has a configuration file starting with 20_. Within each file there is some information that i3xrocks uses to execute a script that ultimately returns the data you see on the bar. Some of the status indicators have configuration parameters that can be adjusted to your liking. For example, if you would prefer that the battery status changes more frequently, the polling interval can be updated. The first thing to do in order to customize the bar is to copy the indicators you wish to see from /usr/share/i3xrocks/conf.d/ to ~/.config/regolith3/i3xrocks/conf.d. Each file in ~/.config/regolith3/i3xrocks/conf.d can be modified as you see fit. To change the order of status indicators on the bar, simply change the name of the files to the sort order you prefer.\nOnce you\u0026rsquo;ve made your changes, refreshing the session should cause the bar to update based on your new configuration.\nFor example, to change the order of the battery and net traffic blocks on the bar and not display notifications, perform the following steps:\n$ ls /usr/share/i3xrocks/conf.d/ 01_setup 30_net-traffic 80_battery 80_rofication 90_time $ mkdir -p ~/.config/regolith3/i3xrocks/conf.d $ cd /usr/share/i3xrocks/conf.d/ $ cp 01_setup ~/.config/regolith3/i3xrocks/conf.d/01_setup $ cp 80_battery ~/.config/regolith3/i3xrocks/conf.d/30_battery $ cp 30_net-traffic ~/.config/regolith3/i3xrocks/conf.d/80_net-traffic $ regolith-look refresh Note: If any block configuration exists in the user directory ~/.config/regolith3/i3xrocks/conf.d, then the defaults in /usr/share/i3xrocks/conf.d/ will be ignored.\nFurther Reading # The reference page for configurations has more details about the configuration files used with Regolith Linux.\n"},{"id":34,"href":"/docs/howtos/replace-notification-system/","title":"Change Notification Systems","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Regolith ships with a notification system called Rofication. It is designed to work in the background and not use pop-ups as a way of alerting the user to a new notification. Rather, a small bar item displays the current number of unread notifications and a dialog can activated to interact with the content of the current notifications. This page describes a way to install an alternative notification system which works in a more traditional way.\nWe will use dunst as an example but similar steps can be used with pretty much any other notification component.\n Replace rofication with dunst: $ sudo apt install dunst $ sudo apt purge regolith-rofication Log out and back in. Test your notifications with notify-send test123. You should see a pop-up notification from dunst. "},{"id":35,"href":"/docs/howtos/time-format/","title":"Change the Bar Date and Time Format","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. The time format (12 or 24 hour) can be specified in Settings:\nThe date format can be specified by selecting the appropriate region in Settings. A preview of the date format is provided, and logging back in is required for changes to take effect.\nThe date and time formats can also be explicitly set via Xresources. To do so, override the i3xrocks.date.format2 Xresource key. The format specification for date is simply the arguments that would be passed to the date command on the command line. For example, to print the year in 4 digits, specify +%Y.\n"},{"id":36,"href":"/docs/howtos/change-terminal/","title":"Change the Default Terminal","section":"How To","content":"The default terminal that ships with Regolith R1.4 is gnome-terminal, but any X terminal emulator can be used. To update Regolith to use your already installed terminal of your choice, use update-alternatives to specify it as default:\n Run update-alternatives --config x-terminal-emulator to see all available terminals installed on your system. Select the terminal you prefer. "},{"id":37,"href":"/docs/howtos/default-gap/","title":"Change the Default Window Gap","section":"How To","content":"Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. Like most configuration in Regolith, the i3-gaps gap size can be tuned via Xresources (See here for all Xresource definitions).\n Create or add the following value to your ~/.config/regolith3/Xresources file: wm.gaps.inner.size: 20 In this example we\u0026rsquo;re setting the default gap to 20 pixels.\nReload the Xresources configuration: $ regolith-look refresh Further Reading # See the reference page for configurations for more details about config files in Regolith.\n"},{"id":38,"href":"/docs/howtos/change-lockscreen/","title":"Change the lock screen program","section":"How To","content":"1. Configure gnome-flashback to Disable Built-in Lockscreen # By default gnome-flashback handles the lock screen for Regolith. This can be adjusted by modifying it\u0026rsquo;s configuration via the gsettings command line program:\n$ gsettings set org.gnome.gnome-flashback screensaver false 2. Cause Your Lock screen program to Run from i3 Keybinding # Specify the following override line in your ~/.config/regolith3/Xresources file (substituting your-script.sh with the command you wish to use for the locking your screen):\nRegolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. wm.program.lock: your-script.sh For example, assuming you have i3lock installed:\n$ echo \u0026quot;wm.program.lock: /usr/bin/i3lock\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources "},{"id":39,"href":"/docs/howtos/terminal-font/","title":"Change the Terminal Font Size","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Create or add the following value to your ~/.config/regolith3/Xresources file: gnome.terminal.font:\tJetBrains Mono 14 Reload the Xresources configuration: $ regolith-look refresh Open a new terminal to see the change take effect. "},{"id":40,"href":"/docs/howtos/change-workspace-icons/","title":"Change Workspace Icons and Labels","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Adding icons to workspaces can give your desktop a nice and functional look.\nFinding icons # Icons are actually characters from fonts installed by Regolith looks. Each look comes with a specific icon font. The icon font is defined in the typeface_bar variable in the typeface config file. For example, the look \u0026ldquo;Cahuella\u0026rdquo; uses the Material Design Icons font (see file /etc/regolith/styles/cahuella/typeface).\nYou can browse the icon font using the Gnome Character Map application from the gucharmap package:\n Open \u0026ldquo;Gnome Character Map\u0026rdquo;. Select your icon font in the top left combo. In the script pane select Common. Scroll down the characters pane until you find the icons. Double click on the icon you are looking to use and press the Copy button (bottom right). Tip: the icons are ordered alphabetically.\nChanging Icons # Follow these steps to override the default workspace label with your own:\n Find the character you want to use and copy to the clipboard. This example will use the Sigma glyph from Material Design Icons font (). Add a line to your Xresources overrides file with the workspace number and character you wish to use: Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. $ echo \u0026quot;wm.workspace.06.name: 6:\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources Refresh your UI: $ regolith-look refresh In i3, workspace labels are only updated when a workspace is created. Ensure you\u0026rsquo;re creating an new workspace 6 if following the example above:\nChanging Labels # The same approach can be used to specify textual descriptions of your workspaces. For example, adding the following lines to your ~/.config/regolith3/Xresources file will change the first three workspaces:\nwm.workspace.01.name: 1: Terminal wm.workspace.02.name: 2: Web wm.workspace.03.name: 3: Chat Adding support for icon fonts in text editors # Atom # Append the name of the icon font to Settings \u0026gt; Editor \u0026gt; Font Familly. Example: Menlo, Consolas, DejaVu Sans Mono, monospace, Material Design Icons Further Reading # See the reference page for configurations for more details about config files in Regolith.\n"},{"id":41,"href":"/docs/howtos/disable-unclutter/","title":"Disable Mouse Hiding (unclutter)","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. By default the mouse cursor disappears if unused for a few seconds. If you prefer that the mouse cursor always remains visible on the screen, follow these steps:\n Specify an empty value for the unclutter launcher program with an Xresources override: $ echo \u0026quot;i3-wm.program.unclutter: :\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources Log out and back in for changes to take effect. "},{"id":42,"href":"/docs/howtos/find-install-packages/","title":"Find and Install Packages","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Regolith is a Debian-based system. Debian packaging tools can be used to find and install packages.\nFind package via the command line # The apt command can be used to query installed or all packages:\n$ apt list --installed \u0026lt;package name\u0026gt; # finds installed packages $ apt list \u0026lt;package name\u0026gt; # finds all packages For example, to list all official Regolith looks that could be installed, run:\n$ apt list regolith-look-* ... To see which status indicators are installed on your system, run:\n$ apt list --installed i3xrocks-* Install packages via the command line # To install packages via the command line, again we can us the apt command, but must use sudo to gain the rights necessary for installation:\n$ sudo apt install \u0026lt;package name\u0026gt; To install the battery status indicator, run:\n$ sudo apt install i3xrocks-battery Find and Install Packages via GUI app # There are a number of apps that can provide a nice window interface on top of the apt packaging system, for example synaptic. Refer to the documentation for the tool of your choice to learn how to search for and install packages.\n"},{"id":43,"href":"/docs/howtos/customize-compositor/","title":"Customize Compositor","section":"How To","content":"How to customize your compositor (visual effects) # Pay special attention to this section if you are experiencing odd visual glitches or slow graphics performance. A compositor is a UI component that applies visual effects to windows before they are rendered on-screen. Many desktop environments integrate a compositor directly into the window manager, making it difficult to switch out or disable. In Regolith, the compositor is defined as a pluggable “extension point” in the packaging system. This means that compositors can be switched out simply by installing the packages that contain them. The underlying packaging system will ensure there are no conflicts and that all the dependencies of a given compositor are also installed.\nWARNING: In Regolith 2.x, the default compositor is \u0026ldquo;no compositor\u0026rdquo;. In Regolith 1.x, the default was Picom. Finding available compositors # The following command will list all compositors configured to work with Regolith:\napt search regolith-compositor- You should find at least the following:\n regolith-compositor-none [default]: No compositor. Best performance, no visual effects. regolith-compositor-picom-glx: Uses picom. Recommended for most users to resolve screen tearing and add visual effects. Modern and well-maintained fork of compton. Was the default compositor in Regolith 1.6. regolith-compositor-compton-glx: An ancestor of picom which is no longer maintained. regolith-compositor-xcompmgr: An early compositor that may offer more consistent performance if more complex compositors are problematic. Installing a compositor # Due to the way that the compositor is managed by i3-wm, you must log out and back in for compositor changes to take effect. Restarting i3 is not sufficient. Run the following package install command to swap out the compositor. In this case we’ll install picom:\napt install regolith-compositor-picom Log out and then log back in and the new compositor should be loaded. You can verify by checking the process list for picom:\nps aux | grep picom Overriding Regolith default compositor configuration # Compton/Picom # To provide your own Compton/Picom compositor config, copy the default or create your own and save it as ~/.config/regolith3/picom/config. Upon next session it will be loaded instead of the default config /etc/regolith/picom/config.\n"},{"id":44,"href":"/docs/howtos/hide-i3-bar-by-default/","title":"How to Hide i3-bar by default","section":"How To","content":"Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x. Add the line\nwm.bar.mode: hide to $HOME/.config/regolith3/Xresources file. The next time you log in the bar should be hidden by default.\n"},{"id":45,"href":"/docs/howtos/install-sway/","title":"Install the Sway Compositor","section":"How To","content":"To install the wayland session, follow these steps:\n Install the regolith-session-sway package and it\u0026rsquo;s dependencies. Reboot Select \u0026ldquo;Regolith on Wayland\u0026rdquo; session in the login panel Hardware Support # Those using proprietary nvidia drivers for their graphics cards must set regolith.sway.unsupported_gpu: true in their XResources. This is not an issue with the open source drivers nouveau. See more here.\nBar Changes # The wayland session uses i3status-rs rather than i3xrocks. i3status-rs provides a crisper and more resource-efficient approach to system monitoring. However at this time the i3xrocks packages for status indicators are not integrated with i3status-rs. To use a custom configuration with i3status-rs, users will need to put their config file at the location of their choosing and they\u0026rsquo;ll need to set the wm.bar.status_config to the absolute path of their config file in their XResources. See the upstream project documentation for further details.\n"},{"id":46,"href":"/docs/howtos/floating-window/","title":"Launch an app in a Floating Window","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Most X11 applications support a flag --class to specify the class under which the application runs. Regolith is configured such that apps with a class of floating_window will launch with i3\u0026rsquo;s floating window mode.\nExamples # gnome-terminal # Launch the terminal in floating mode:\n$ gnome-terminal --class=floating_window Firefox # Launch Firefox in floating mode:\n$ firefox --class=floating_window "},{"id":47,"href":"/docs/howtos/vanilla-i3-gaps/","title":"Launch Default i3 Session","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. To do so on Ubuntu, run sudo apt install i3-gaps-session to add an option on login that starts vanilla i3-gaps without regolith.\nUse Case # This is useful for, say, running an application that does not integrate well with GNOME. For example, Spotify\u0026rsquo;s unmaintained official Linux client mishandles its file selection dialogue and crashes when\n Setting user profile photo Setting album cover photo Adding a local directory to the library paths under GNOME and Regolith. Switching to vanilla i3 solves the crash.\nSource: Ken\u0026rsquo;s comment on the relevant issue on GitHub.\n"},{"id":48,"href":"/docs/howtos/tdcli-blocklet/","title":"Manage a To-Do List","section":"How To","content":"Regolith version 3.0 onward replaces \u0026ldquo;i3-wm\u0026rdquo; with \u0026ldquo;wm\u0026rdquo; in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use \u0026ldquo;i3-wm\u0026rdquo; instead of \u0026ldquo;wm\u0026rdquo; in the key names below. For example wm.foo.bar changes to wm.foo.bar for Regolith 1.x and 2.x. td-cli is a command line todo manager written in Python3 for organizing todo lists across multiple projects.\nRegolith includes a status bar blocklet for accessing td-cli directly from the bar. It can be installed as follows:\nsudo apt install i3xrocks-todo After installing td-cli you can access it via command line using td. The full documentation of td-cli\u0026rsquo;s API can be found online at their repository. For example, let\u0026rsquo;s create a todo list with a group name of Regolith, set it as the default project, and then add a new task to this group:\ntd ag regolith td g regolith p td a \u0026quot;Write a Howto for td-cli\u0026quot; Now, if you click on the td-cli blocklet (on the left of the time blocklet in the figure below) a floating terminal opens up with an interactive instance of td-cli:\nYou can set this blocklet to only show number of uncompleted tasks in the bar by setting the following key in your Xresource file, for example, ~/.config/regolith3/Xresources:\ni3xrocks.todo.uncompleted: true By default, this key is set to false. Moreover, you can add a keybinding for accessing td-cli via a floating terminal by adding the following line to your i3 config file, for example, ~/.config/regolith3/i3/config:\nbindsym $mod+Ctrl+d exec --no-startup-id \u0026quot;/usr/bin/gnome-terminal --class=floating_window -e 'td --interactive'\u0026quot; Alternatively, you add these lines to your i3 config file, first:\nset_from_resource $wm.bindsym.1 wm.bindsym.1 : set_from_resource $wm.bindsym.program.1 wm.bindsym.program.1 : bindsym $mod+$wm.bindsym.1 exec --no-startup-id \u0026quot;$wm.bindsym.program.1\u0026quot; Then, add the followings to your Xresources file:\nwm.bindsym.1: Ctrl+d wm.bindsym.program.1: /usr/bin/gnome-terminal --class=floating_window -e 'td --interactive' "},{"id":49,"href":"/docs/howtos/minimal-ubuntu-install/","title":"Minimal Ubuntu Install","section":"How To","content":"This page describes how to install the Regolith Desktop into Ubuntu Server. This approach produces a minimal setup as many of the standard GNOME desktop packages present in a desktop install will be avoided.\nSteps # 1. Install Ubuntu Server # Follow online instructions for installing a fresh copy of Ubuntu Server versions either 20.04 or 22.04.\n2. Add Regolith\u0026rsquo;s package key and apt repository # Once Ubuntu Server has been installed, log into a terminal session. Use the following URLs to download the installation directions as a text file:\nUbuntu 22.04: https://regolith-desktop.com/install-release-ubuntu-22.04-amd64.txt\nUbuntu 20.04: https://regolith-desktop.com/install-release-ubuntu-20.04-amd64.txt\nExample:\nwget https://regolith-desktop.com/install-release-ubuntu-22.04-amd64.txt cat install-release-ubuntu-22.04-amd64.txt Manually execute each step in the text file, or source the file if you\u0026rsquo;re feeling adventurous. Once complete, the Regolith Desktop package repositories are installed into the new system.\n3. Install the Regolith Ubuntu System # There is a special package that is used in the ISO that can also be used in a minimal install such as this: regolith-system-ubuntu. This package includes extra branding not used in typical desktop installs which may share multiple desktop environments. Run the following command to install Regolith Desktop and all of it\u0026rsquo;s dependencies:\nsudo apt install regolith-system-ubuntu 4. Reboot # Once the system boots back up, the lightdm login manager will allow you to log into your new Regolith environment.\n"},{"id":50,"href":"/docs/howtos/override-xres/","title":"Override Xresources","section":"How To","content":"Regolith relies on the Xresources system to provide a consolidated interface configuration. By changing Xresources values, Regolith can be customized in ways such as updating the user interface, specifying custom behaviors, or defining a specific format for some of the blocklets on the bar.\nIn Regolith, Xresources values can be changed via two methods: supplying your own Xresources files, and overriding the existing Xresources values. The latter approach is strongly recommended, as it makes upgrading to newer versions of Regolith less likely to break your customizations. If you copy the Xresources tree completely you\u0026rsquo;ll need to integrate any breaking changes in future versions manually. Initialization # When a Regolith session is started, Xresources are loaded in the following order:\n File Optional Notes ~/.Xresources Y Intended for non-Regolith settings /usr/share/regolith-look/**/ N The Regolith Xresources associated with looks ~/.config/regolith3/Xresources Y Applies specific overrides to Xresources defaults It is recommended to use ~/.config/regolith3/Xresources for customization as it doesn\u0026rsquo;t require the specification of redundant settings and is easier to maintain over time.\nDetermining which values can be changed # The xrdb tool can be used to list the existing Xresources values. There is a number of existing overrides in the R2.1 release:\n$ xrdb -query [...] gnome.terminal.scrollbar:\tnever gnome.terminal.use-transparent-background:\ttrue gtk.document_font_name:\tSans 12 gtk.font_name:\tBitstream Vera Sans 12 gtk.icon_theme_name:\tPapirus-Dark gtk.monospace_font_name:\tBitstreamVeraSansMono Nerd Font 13 gtk.theme_name:\tAyu-Mirage-Dark wm.bar.background.color:\t#1F2430 [...] Examples # Note that the commands presented below append text to a file, so running the command more than once will result in duplicate entires.\nExample - Update the UI for High DPI Screens # By using the ~/.config/regolith3/Xresources override file, we will only need to specify the values we wish to change. The xrdb tool can be used to determine what current values are set to.\n Create or add the following value to your ~/.config/regolith3/Xresources file: Xft.dpi: 192 Reload the Xresources configuration: $ regolith-look refresh Open a new terminal to see the change take effect. 192 is just an example value, please adjust as needed.\nExample - Change i3 bar position # $ xrdb -query | grep position wm.bar.position:\tbottom $ echo \u0026quot;wm.bar.position:\ttop\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources $ regolith-look refresh Example - Change GTK Theme # $ xrdb -query | grep gtk gtk.theme_name:\tAyu-Mirage-Dark $ echo \u0026quot;gnome.gtk.theme:\tAdwaita\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources $ regolith-look refresh Example - Disable the System Tray # $ echo \u0026quot;wm.bar.trayoutput:\tnone\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources $ regolith-look refresh Example - Use Alt instead of Win as Super # $ echo \u0026quot;wm.mod: Mod1\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources $ echo \u0026quot;wm.alt: Mod4\u0026quot; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources Then Reload i3 for the change to take effect. Some settings may require logging back into the session, for example anything that i3 launches as a separate process.\nFurther Reading # See the reference page for configurations for more details about config files in Regolith.\n"},{"id":51,"href":"/docs/howtos/remove-unneeded-deps/","title":"Remove Unneeded Dependencies","section":"How To","content":"When Regolith is installed via ISO, only the necessary desktop components or packages are installed by default. However when installing Regolith into an existing Ubuntu system, some desktop components that Regolith does not require will still be installed on the system. There is nothing wrong with keeping these additional packages, in fact they are important if you wish to switch back to the default Ubuntu session at some point, however some users prefer to remove them.\nNOTE: Removing packages may cause unexpected behavior or loss of functionality. Install LightDM # The lightdm display manager can be installed by with a variety of themes, but we\u0026rsquo;ll install the package regolith-lightdm-config:\n$ sudo apt install regolith-lightdm-config Inspect the output of apt to verify you approve of the package changes. When presented with a menu, choosing between gdm3 and lightdm, select lightdm.\nRemove Unneeded Packages # Now that we are using the lightdm display manager, we can remove the unneeded packages:\n$ sudo apt remove gdm3 gnome-shell evolution-data-server* Inspect the output of apt to verify you approve of the package changes.\nNow we can remove all of the dependencies of those packages:\n$ sudo apt autoremove Reboot # At this point the unneeded dependencies have been removed from the system. Reboot to complete the procedure.\nUndo # If you decide that you\u0026rsquo;d like to restore the existing setup, run the following and select gdm3 as the display manager.\n$ sudo apt install gdm3 gnome-shell evolution-data-server ubuntu-session $ sudo apt remove regolith-lightdm-session "},{"id":52,"href":"/docs/howtos/stage-configs/","title":"Stage Config Files","section":"How To","content":"If you only wish to override or provide new Xresources values, staging configs is not required and not recommended. Overriding Xresources value is described in a separate article. Regolith uses a number of configuration files to determine the behavior and look of various components. While it\u0026rsquo;s possible to simply edit these files directly, users who do so run the risk of having their configurations overwritten upon future updates. The Debian packaging system should ask users if they wish to take updates or keep the existing files, but this may have unintended side effects if users take partial updates of files. As such Regolith, upon login, will look for user-staged version of configuration files and load those instead of the defaults if they exist. This is recommended over editing the files directly as it gives the user more control over their configuration. This page describes how to create these files.\nDepending on what you wish to change, you may need your own copy if the i3 config file. If you\u0026rsquo;re looking to change the way Regolith looks, Xresources may be all you need. If you want to update or add keybindings or swap out components, you\u0026rsquo;ll most likely need to stage the i3 config file.\ni3 Config # Copy the default Regolith i3 config file into your home directory: $ mkdir -p ~/.config/regolith3/i3 $ cp /etc/regolith/i3/config ~/.config/regolith3/i3/config Log out and back in. The Regolith session will automatically detect and load your user-staged file. Verify the Change # Verify by running i3 --moreversion and noting the config file that is printed as a result. It should be the copy you just created. If not, be sure the path is correct. It must exactly be ~/.config/regolith3/i3/config for Regolith to load it. "},{"id":53,"href":"/docs/howtos/multiple-batteries/","title":"Support Multiple Batteries","section":"How To","content":"i3 # NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Out of the box the primary battery status will be displayed in the i3-bar. For some laptops that have multiple batteries, e.g. ThinkPads, you want to have both batteries displayed:\n Stage your i3xrocks configuration files, then open ~/.config/regolith3/i3xrocks/conf.d/80_battery in your editor of choice. Find the line that pertains to the battery blocklet: # Battery indicator # # Displays total percentage charge left of specified battery. [battery] interval=30 # instance=BAT0 List all the battery instances running on your machine by running: ls /sys/class/power_supply/ # AC BAT0 BAT1 Update the staged config file to have a new blocklet as such: ... # Battery indicator # # Displays total percentage charge left of specified battery. [battery] interval=30 instance=BAT0 [battery] interval=30 instance=BAT1 Sway # Stage your i3status-rust config file: cp /etc/regolith/i3status-rust/config.toml ~/.config/regolith3/i3status-rust/config.toml Configure to supply i3status-rust with your config file: echo \u0026#34;wm.bar.status_config: ~/.config/regolith3/i3status-rust/config.toml\u0026#34; \u0026gt;\u0026gt; ~/.config/regolith3/Xresources List all the battery instances running on your machine by running: ls /sys/class/power_supply/ # AC BAT0 BAT1 Update the staged config file to contain blocks for both of the batteries: [[block]] block = \u0026quot;battery\u0026quot; interval = 10 [...] device = \u0026quot;BAT0\u0026quot; [[block]] block = \u0026quot;battery\u0026quot; interval = 10 [...] device = \u0026quot;BAT1\u0026quot; Further Reading # See the reference page for configurations for more details about config files in Regolith.\n"},{"id":54,"href":"/docs/howtos/gnome-flashback-session/","title":"Verify behavior against upstream","section":"How To","content":"NOTICE: This page was copied from the Regolith 1.x website and has not been updated for Regolith 2. It may contain out of date information. Regolith is composed of several existing open-source projects plus some additional custom packages. Sometimes when a bug is found in Regolith, actually it\u0026rsquo;s a bug in an upstream project. Determining the source of bugs is a first step in getting them fixed.\nCheck gnome-flashback # Most of Regolith\u0026rsquo;s GNOME support comes from the gnome-flashback project. To run a gnome-flashback session, install the session and log back in to your account after selecting that session from the login screen.\n Install the gnome-session-flashback session: sudo apt install gnome-session-flashback Restart your computer and then select the GNOME Flashback (Metacity) session as shown here: Verify your behavior against Regolith. If the problematic behavior also exists in gnome-flashback then the bug is likely there. If the bug does not exist in the gnome-flashback then it\u0026rsquo;s likely to be in Regolith. "}] \ No newline at end of file diff --git a/en.search.min.e64675e449080f8366e8582e7684ade6e028038db999332dacdde305c9465aec.js b/en.search.min.62225031cff9cd9e1b18bcd0e07e236372d5645e25d06b23125c3ea37eea1d25.js similarity index 92% rename from en.search.min.e64675e449080f8366e8582e7684ade6e028038db999332dacdde305c9465aec.js rename to en.search.min.62225031cff9cd9e1b18bcd0e07e236372d5645e25d06b23125c3ea37eea1d25.js index 36506804..24cfcb62 100644 --- a/en.search.min.e64675e449080f8366e8582e7684ade6e028038db999332dacdde305c9465aec.js +++ b/en.search.min.62225031cff9cd9e1b18bcd0e07e236372d5645e25d06b23125c3ea37eea1d25.js @@ -1,4 +1,4 @@ -'use strict';(function(){const searchDataURL='/en.search-data.min.602c0b4a954cbb227ae880e0765bf3ddce3fc8db382da89eeb4c2cafb56b0809.json';const indexConfig=Object.assign({cache:true},{doc:{id:'id',field:['title','content'],store:['title','href','section']}});const input=document.querySelector('#book-search-input');const results=document.querySelector('#book-search-results');if(!input){return} +'use strict';(function(){const searchDataURL='/en.search-data.min.41ab4306ed57301a15c9950c9004427d3b0c69f9e886ba0dd4dc5642506fd7eb.json';const indexConfig=Object.assign({cache:true},{doc:{id:'id',field:['title','content'],store:['title','href','section']}});const input=document.querySelector('#book-search-input');const results=document.querySelector('#book-search-results');if(!input){return} input.addEventListener('focus',init);input.addEventListener('keyup',search);document.addEventListener('keypress',focusSearchFieldOnKeyPress);function focusSearchFieldOnKeyPress(event){if(event.target.value!==undefined){return;} if(input===document.activeElement){return;} const characterPressed=String.fromCharCode(event.charCode);if(!isHotkey(characterPressed)){return;} diff --git a/en/sitemap.xml b/en/sitemap.xml index 1b6ef293..41dc8fa8 100644 --- a/en/sitemap.xml +++ b/en/sitemap.xml @@ -1 +1 @@ -https://regolith-desktop.com/posts/status_update_11_23/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/customize-i3-configuration/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/using-regolith/install/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/keybindings/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-3.1-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/configurations/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/using-regolith/first-launch/2024-02-09T18:13:02-08:00https://regolith-desktop.com/posts/repo-url-change-2.1/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/using-regolith/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-3.0-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/using-regolith/basics/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-2.2-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/using-regolith/configuration/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-2.1-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-2.0-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.6.0-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/xresources/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.5.3-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.5.2-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.5.1-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.5-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.4.1-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.4-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.3.1-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.3-release-notes/2024-02-09T18:13:02-08:00https://regolith-desktop.com/posts/localization/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/reference/build-system/2024-02-09T18:13:02-08:00https://regolith-desktop.com/posts/announce-regolith-2/2024-02-09T18:13:02-08:00https://regolith-desktop.com/posts/attribution/2024-02-09T18:13:02-08:00https://regolith-desktop.com/posts/sway_integration_gsoc/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/workspace-on-output/2024-02-09T18:13:02-08:00https://regolith-desktop.com/posts/2024-02-09T18:13:02-08:00https://regolith-desktop.com/categories/https://regolith-desktop.com/docs/howtos/add-remove-blocklets/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/replace-notification-system/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/time-format/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/change-terminal/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/default-gap/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/change-lockscreen/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/terminal-font/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/change-workspace-icons/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/disable-unclutter/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/find-install-packages/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/customize-compositor/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/hide-i3-bar-by-default/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/install-sway/2024-02-09T18:13:02-08:00https://regolith-desktop.com/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/floating-window/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/vanilla-i3-gaps/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/tdcli-blocklet/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/minimal-ubuntu-install/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/override-xres/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/remove-unneeded-deps/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/stage-configs/2024-02-09T18:13:02-08:00https://regolith-desktop.com/docs/howtos/multiple-batteries/2024-02-09T18:13:02-08:00https://regolith-desktop.com/tags/https://regolith-desktop.com/docs/howtos/gnome-flashback-session/2024-02-09T18:13:02-08:00 \ No newline at end of file +https://regolith-desktop.com/posts/status_update_11_23/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/customize-i3-configuration/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/using-regolith/install/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/keybindings/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-3.1-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/configurations/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/using-regolith/first-launch/2024-02-10T10:59:15-08:00https://regolith-desktop.com/posts/repo-url-change-2.1/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/using-regolith/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-3.0-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/using-regolith/basics/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-2.2-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/using-regolith/configuration/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-2.1-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-2.0-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.6.0-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/xresources/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.5.3-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.5.2-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.5.1-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.5-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.4.1-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.4-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.3.1-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/Releases/regolith-1.3-release-notes/2024-02-10T10:59:15-08:00https://regolith-desktop.com/posts/localization/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/reference/build-system/2024-02-10T10:59:15-08:00https://regolith-desktop.com/posts/announce-regolith-2/2024-02-10T10:59:15-08:00https://regolith-desktop.com/posts/attribution/2024-02-10T10:59:15-08:00https://regolith-desktop.com/posts/sway_integration_gsoc/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/workspace-on-output/2024-02-10T10:59:15-08:00https://regolith-desktop.com/posts/2024-02-10T10:59:15-08:00https://regolith-desktop.com/categories/https://regolith-desktop.com/docs/howtos/add-remove-blocklets/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/replace-notification-system/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/time-format/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/change-terminal/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/default-gap/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/change-lockscreen/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/terminal-font/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/change-workspace-icons/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/disable-unclutter/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/find-install-packages/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/customize-compositor/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/hide-i3-bar-by-default/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/install-sway/2024-02-10T10:59:15-08:00https://regolith-desktop.com/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/floating-window/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/vanilla-i3-gaps/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/tdcli-blocklet/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/minimal-ubuntu-install/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/override-xres/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/remove-unneeded-deps/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/stage-configs/2024-02-10T10:59:15-08:00https://regolith-desktop.com/docs/howtos/multiple-batteries/2024-02-10T10:59:15-08:00https://regolith-desktop.com/tags/https://regolith-desktop.com/docs/howtos/gnome-flashback-session/2024-02-10T10:59:15-08:00 \ No newline at end of file diff --git a/fr/docs/howtos/add-remove-blocklets/index.html b/fr/docs/howtos/add-remove-blocklets/index.html index 6ed06296..9d70396a 100644 --- a/fr/docs/howtos/add-remove-blocklets/index.html +++ b/fr/docs/howtos/add-remove-blocklets/index.html @@ -1,4 +1,4 @@ -Modifier les indicateurs dans la barre | Regolith Desktop
\ No newline at end of file diff --git a/fr/docs/howtos/customize-compositor/index.html b/fr/docs/howtos/customize-compositor/index.html index ac11205a..03c5f2cc 100644 --- a/fr/docs/howtos/customize-compositor/index.html +++ b/fr/docs/howtos/customize-compositor/index.html @@ -1,4 +1,4 @@ -Modifier le Compositor | Regolith Desktop
\ No newline at end of file diff --git a/fr/docs/howtos/customize-i3-configuration/index.html b/fr/docs/howtos/customize-i3-configuration/index.html index e3a62dc3..2685ec69 100644 --- a/fr/docs/howtos/customize-i3-configuration/index.html +++ b/fr/docs/howtos/customize-i3-configuration/index.html @@ -1,4 +1,4 @@ -Personnaliser la config i3 | Regolith Desktop
\ No newline at end of file diff --git a/fr/docs/howtos/index.html b/fr/docs/howtos/index.html index 9b58f4ea..1f0e1897 100644 --- a/fr/docs/howtos/index.html +++ b/fr/docs/howtos/index.html @@ -1,4 +1,4 @@ -Guides | Regolith Desktop
\ No newline at end of file diff --git a/fr/docs/howtos/override-xres/index.html b/fr/docs/howtos/override-xres/index.html index 67f101b7..65be051e 100644 --- a/fr/docs/howtos/override-xres/index.html +++ b/fr/docs/howtos/override-xres/index.html @@ -1,4 +1,4 @@ -Modifier les Xresources | Regolith Desktop
\ No newline at end of file diff --git a/fr/docs/index.html b/fr/docs/index.html index b0dac441..93aa5bbb 100644 --- a/fr/docs/index.html +++ b/fr/docs/index.html @@ -1,4 +1,4 @@ -Docs | Regolith Desktop
Références -

Cette section contient les références qui peuvent vous aider avec Regolith.

\ No newline at end of file diff --git a/fr/docs/reference/keybindings/index.html b/fr/docs/reference/keybindings/index.html index c66d5ef7..2f4664c3 100644 --- a/fr/docs/reference/keybindings/index.html +++ b/fr/docs/reference/keybindings/index.html @@ -1,4 +1,4 @@ -Raccourcis clavier | Regolith Desktop
Raccourcis clavier -
ActionKey Binding
Lanceur - Application⊞ Win Space
Lanceur - Navigateur Web⊞ Win Shift Enter
Lanceur - Terminal⊞ Win Shift Space
Lanceur - Fichiers⊞ Win Shift n
Lanceur - Recherche de fichier⊞ Win Alt Space
Lanceur - Panneau des notifications⊞ Win n
Lanceur - Terminal⊞ Win Enter
Lanceur - Ce dialogue⊞ Win Shift ?
Modification - Paramètres Bluetooth⊞ Win b
Modification - Déplacer la fenêtre vers l’espace de travail en gardant le focus 1 - 10⊞ Win Alt 0..9
Modification - Déplacer la fenêtre vers l’espace de travail en gardant le focus 11 - 19⊞ Win Alt Ctrl 1..9
Modification - Espace de travail contenant⊞ Win Ctrl Shift ↑ ↓ ← →
Modification - Paramètres d’affichage⊞ Win d
Modification - Charge la disposition fenêtre⊞ Win .
Modification - Déplacer la fenêtre vers l’espace de travail 1 - 10⊞ Win Shift 0..9
Modification - Déplacer la fenêtre vers l’espace de travail 11 - 19⊞ Win Ctrl Shift 1..9
Modification - Se déplacer vers le bloc-note⊞ Win Ctrl m
Modification - Orientation de fenêtre suivante⊞ Win Backspace
Modification - Sauvegarde la disposition des fenêtres⊞ Win ,
Modification - Paramètres⊞ Win c
Modification - Active/Désactive le mode flottant⊞ Win Shift t
Modification - Affiche/Désaffiche la barre⊞ Win i
Modification - Paramètres WiFi⊞ Win w
Modification - Active le mode flottant pour la fenêtre⊞ Win Shift f
Modification - Active le mode plein écran pour la fenêtre⊞ Win f
Modification - Modifie la disposition des fenêtres⊞ Win t
Modification - Modifie la position des fenêtres⊞ Win Shift k j h l
Modification - Modifie la position des fenêtres⊞ Win Shift ↑ ↓ ← →
Navigation - Espace de travail suivant⊞ Win Tab
Navigation - Espace de travail suivant⊞ Win Alt →
Navigation - Espace de travai précédent⊞ Win Alt ←
Navigation - Espace de travail précédent⊞ Win Shift Tab
Navigation - Change la fenêtre focalisée⊞ Win k j h l
Navigation - Change la fenêtre focalisée⊞ Win ↑ ↓ ← →
Navigation - Scratchpad⊞ Win Ctrl a
Navigation - Lister les fenêtres par nom⊞ Win Ctrl Space
Navigation - Espaces de travail 11 - 19⊞ Win Ctrl 1..9
Navigation - Espaces de travail 1-10⊞ Win 0..9
Redimmensionnement - Activer/Désactiver le mode redimensionnement⊞ Win r
Session - Quitter l’application⊞ Win Shift q
Session - Verouiller l’écran⊞ Win Escape
Session - Fermer la session⊞ Win Shift e
Session - Éteindre⊞ Win Shift p
Session - Redémarrer⊞ Win Shift b
Session - Rafraîchir la session⊞ Win Shift r
Session - Recharger la configuration i3⊞ Win Shift c
Session - Redémarrer i3⊞ Win Ctrl r
Session - Veille⊞ Win Shift s
Session - Fermer l’app⊞ Win Alt q
\ No newline at end of file diff --git a/fr/docs/reference/xresources/index.html b/fr/docs/reference/xresources/index.html index 81d977aa..e9b02882 100644 --- a/fr/docs/reference/xresources/index.html +++ b/fr/docs/reference/xresources/index.html @@ -1,4 +1,4 @@ -Xresources | Regolith Desktop
Xresources
Regolith version 3.0 onward replaces “i3-wm” with “wm” in Xresource keys. The content on this page has been updated for Regolith 3.0+. If you are using an earlier version, use “i3-wm” instead of “wm” in the key names below. For example wm.foo.bar changes to i3-wm.foo.bar for Regolith 1.x and 2.x.
Xresources KeyDescription
gtk.theme_nameGTK Theme (“Legacy Applications” in gnome-tweaks)
gtk.icon_theme_nameGTK Icon Theme
gnome.terminal.audible-bellEnables audible bell in gnome-terminal (true / false)
gtk.document_font_nameGTK Document Font Name
gtk.font_nameGeneral purpose font for GTK apps and the desktop
gtk.monospace_font_nameFont for monospace areas such as i3bar and the terminal
gnome.terminal.background-transparency-percentBackground transparency value for gnome-terminal (0 - 100). See also gnome.terminal.use-transparent-background.
gnome.terminal.fontFont definition for gnome-terminal
gnome.terminal.scrollbarFlag to enable/disable scrollbar (never / always)
gnome.terminal.use-transparent-backgroundEnables transparent background in gnome-terminal (true / false). See also gnome.terminal.background-transparency-percent.
gnome.wallpaperGNOME Wallpaper (can be overridden in Settings)
gnome.wm.themeGNOME Window Manager Theme (unused)
wm.altKey mapping for Alt key. See the i3 User Guide for details.
wm.bar.background.colorBar Background Color
wm.bar.positionBar Screen Position
wm.bar.separator.colorColor of seperator between blocks
wm.bar.statusline.color
wm.bar.trayoutputEnable or disable the app tray in i3bar
wm.bar.workspace.active.background.color
wm.bar.workspace.active.border.color
wm.bar.workspace.active.text.color
wm.bar.workspace.focused.background.color
wm.bar.workspace.focused.border.color
wm.bar.workspace.focused.text.color
wm.bar.workspace.inactive.background.color
wm.bar.workspace.inactive.border.color
wm.bar.workspace.inactive.text.color
wm.bar.workspace.urgent.background.color
wm.bar.workspace.urgent.border.color
wm.bar.workspace.urgent.text.color
wm.client.focused.color.background
wm.client.focused.color.border
wm.client.focused.color.child_border
wm.client.focused.color.indicator
wm.client.focused.color.text
wm.client.focused_inactive.color.background
wm.client.focused_inactive.color.border
wm.client.focused_inactive.color.child_border
wm.client.focused_inactive.color.indicator
wm.client.focused_inactive.color.text
wm.client.unfocused.color.background
wm.client.unfocused.color.border
wm.client.unfocused.color.child_border
wm.client.unfocused.color.indicator
wm.client.unfocused.color.text
wm.client.urgent.color.background
wm.client.urgent.color.border
wm.client.urgent.color.child_border
wm.client.urgent.color.indicator
wm.client.urgent.color.text
wm.floatingwindow.border.sizeWindow border size in pixels for floating windows
wm.fontWindow manager font
wm.gaps.inner.sizeDefault gap size between windows in pixels
wm.gaps.outer.sizeDefault gap size at screen edge in pixels
wm.modKey mapping for Super key. See the i3 User Guide for details.
wm.window.border.sizeDefault border size in pixels
wm.workspace.01.name .. wm.workspace.19.nameWorkspace Labels
wm.workspace.01.key .. wm.workspace.10.keyWorkspace Shortucts
i3xrocks.action.volume.leftCommand to execute when volume indicator is left clicked (default: none)
i3xrocks.action.volume.middleCommand to execute when volume indicator is middle clicked (default: none)
i3xrocks.action.volume.rightCommand to execute when volume indicator is right clicked (default: mute through amixer)
i3xrocks.action.volume.scrollupCommand to execute when scroll wheel up is used on volume indicator (default: increase volume through amixer)
i3xrocks.action.volume.scrolldnCommand to execute when scroll wheel down is used on volume indicator (default: decrease volume through amixer)
i3xrocks.error.colorColor for bar module in error mode
i3xrocks.label.battery0Bar icon glyph
i3xrocks.label.battery100Bar icon glyph
i3xrocks.label.battery20Bar icon glyph
i3xrocks.label.battery50Bar icon glyph
i3xrocks.label.battery80Bar icon glyph
i3xrocks.label.batteryacBar icon glyph
i3xrocks.label.batterychargingBar icon glyph
i3xrocks.label.batteryunknownBar icon glyph
i3xrocks.label.capslockBar icon glyph
i3xrocks.label.colorBar icon glyph
i3xrocks.label.cpuBar icon glyph
i3xrocks.label.diskBar icon glyph
i3xrocks.label.dnBar icon glyph
i3xrocks.label.helpBar icon glyph
i3xrocks.label.mediapausedBar icon glyph
i3xrocks.label.mediaplayingBar icon glyph
i3xrocks.label.memoryBar icon glyph
i3xrocks.label.muteBar icon glyph
i3xrocks.label.notify.errorBar icon glyph
i3xrocks.label.notify.noneBar icon glyph
i3xrocks.label.notify.someBar icon glyph
i3xrocks.label.numlockBar icon glyph
i3xrocks.label.offBar icon glyph
i3xrocks.label.onBar icon glyph
i3xrocks.label.soundBar icon glyph
i3xrocks.label.thermometerBar icon glyph
i3xrocks.label.timeBar icon glyph
i3xrocks.label.upBar icon glyph
i3xrocks.label.wifiBar icon glyph
i3xrocks.label.wiredBar icon glyph
i3xrocks.nominalDefault bar icon color
i3xrocks.value.colorColor of numerical value in bar module
i3xrocks.value.fontFont for numerical value in bar module
i3xrocks.warningWarning color for bar module

Optional Xresources keys -#

The following Xresources keys are undefined by default but can be used by users to change behavior as desired.

Xresources KeyDescription
wm.gaps.focus_follows_mouseThe window under the mouse has focus if enabled
wm.program.launcher.appCommand i3 executes from the app launcher keybinding
wm.program.launcher.cmdCommand i3 executes from the command launcher keybinding
wm.program.launcher.windowCommand i3 executes for the window navigation keybinding
wm.program.helpCommand to launch from the help keybinding
wm.program.file_searchCommand to launch from the file search keybinding
wm.program.refresh_uiCommand to launch from the session refresh keybinding
wm.program.logoutCommand to launch from the logout keybinding
wm.program.rebootCommand to launch from the reboot keybinding
wm.program.shutdownCommand to launch from the shutdown keybinding
wm.program.lockCommand to launch from the lock screen keybinding
wm.program.sleepCommand to launch from the sleep keybinding
wm.program.settingsCommand to launch from the Control Panel keybinding
wm.program.displayCommand to launch from the Display Settings keybinding
wm.program.wifiCommand to launch from the Wifi Settings keybinding
wm.program.bluetoothCommand to launch from the Bluetooth Settings keybinding
wm.program.filesCommand to launch from the file browser keybinding
wm.program.notification_uiCommand to launch from the notification UI keybinding
wm.program.1…wm.program.3Optional programs to start with i3
i3xrocks.media-player.player-argsOptional arguments used by the media-player i3xrocks block. These arguments are fed straight into playerctl, eg. setting this value to -p spotify only makes the bar display/control spotify.
i3xrocks.action.mic.leftOptional command to run on left button click of microphone status indicator.
i3xrocks.action.mic.middleOptional command to run on middle button click of microphone status indicator.
i3xrocks.action.mic.rightOverride command to run on right button click of microphone status indicator.
i3xrocks.action.mic.scrollupOverride command to run on scroll up of microphone status indicator.
i3xrocks.action.mic.scrolldnOverride command to run on scroll down of microphone status indicator.
i3xrocks.action.volume.leftOptional command to run on left button click of microphone status indicator.
i3xrocks.action.volume.middleOptional command to run on middle button click of microphone status indicator.
i3xrocks.action.volume.rightOverride command to run on right button click of microphone status indicator.
i3xrocks.action.volume.scrollupOverride command to run on scroll up of microphone status indicator.
i3xrocks.action.volume.scrolldnOverride command to run on scroll down of microphone status indicator.
i3xrocks.action.disk-capacityOverride command to run on disk capacity status indicator.
i3xrocks.action.cpu-usageOverride command to run on cpu usage status indicator.
i3xrocks.action.memoryOverride command to run on memory status indicator.
i3xrocks.action.wifiOverride command to run on wifi status indicator.
i3xrocks.action.weatherOverride command to run on weather status indicator.
i3xrocks.action.media-player.leftOptional command to run on left button click of media player status indicator.
i3xrocks.action.media-player.middleOptional command to run on middle button click of media player status indicator.
i3xrocks.action.media-player.rightOverride command to run on right button click of media player status indicator.
i3xrocks.action.timeOverride command to run on date time status indicator.
i3xrocks.action.batteryOverride command to run on battery status indicator.
Calendar +#

The following Xresources keys are undefined by default but can be used by users to change behavior as desired.

Xresources KeyDescription
wm.gaps.focus_follows_mouseThe window under the mouse has focus if enabled
wm.program.launcher.appCommand i3 executes from the app launcher keybinding
wm.program.launcher.cmdCommand i3 executes from the command launcher keybinding
wm.program.launcher.windowCommand i3 executes for the window navigation keybinding
wm.program.helpCommand to launch from the help keybinding
wm.program.file_searchCommand to launch from the file search keybinding
wm.program.refresh_uiCommand to launch from the session refresh keybinding
wm.program.logoutCommand to launch from the logout keybinding
wm.program.rebootCommand to launch from the reboot keybinding
wm.program.shutdownCommand to launch from the shutdown keybinding
wm.program.lockCommand to launch from the lock screen keybinding
wm.program.sleepCommand to launch from the sleep keybinding
wm.program.settingsCommand to launch from the Control Panel keybinding
wm.program.displayCommand to launch from the Display Settings keybinding
wm.program.wifiCommand to launch from the Wifi Settings keybinding
wm.program.bluetoothCommand to launch from the Bluetooth Settings keybinding
wm.program.filesCommand to launch from the file browser keybinding
wm.program.notification_uiCommand to launch from the notification UI keybinding
wm.program.1…wm.program.3Optional programs to start with i3
i3xrocks.media-player.player-argsOptional arguments used by the media-player i3xrocks block. These arguments are fed straight into playerctl, eg. setting this value to -p spotify only makes the bar display/control spotify.
i3xrocks.action.mic.leftOptional command to run on left button click of microphone status indicator.
i3xrocks.action.mic.middleOptional command to run on middle button click of microphone status indicator.
i3xrocks.action.mic.rightOverride command to run on right button click of microphone status indicator.
i3xrocks.action.mic.scrollupOverride command to run on scroll up of microphone status indicator.
i3xrocks.action.mic.scrolldnOverride command to run on scroll down of microphone status indicator.
i3xrocks.action.volume.leftOptional command to run on left button click of microphone status indicator.
i3xrocks.action.volume.middleOptional command to run on middle button click of microphone status indicator.
i3xrocks.action.volume.rightOverride command to run on right button click of microphone status indicator.
i3xrocks.action.volume.scrollupOverride command to run on scroll up of microphone status indicator.
i3xrocks.action.volume.scrolldnOverride command to run on scroll down of microphone status indicator.
i3xrocks.action.disk-capacityOverride command to run on disk capacity status indicator.
i3xrocks.action.cpu-usageOverride command to run on cpu usage status indicator.
i3xrocks.action.memoryOverride command to run on memory status indicator.
i3xrocks.action.wifiOverride command to run on wifi status indicator.
i3xrocks.action.weatherOverride command to run on weather status indicator.
i3xrocks.action.media-player.leftOptional command to run on left button click of media player status indicator.
i3xrocks.action.media-player.middleOptional command to run on middle button click of media player status indicator.
i3xrocks.action.media-player.rightOverride command to run on right button click of media player status indicator.
i3xrocks.action.timeOverride command to run on date time status indicator.
i3xrocks.action.batteryOverride command to run on battery status indicator.
\ No newline at end of file diff --git a/fr/docs/using-regolith/basics/index.html b/fr/docs/using-regolith/basics/index.html index 15a1dd56..d851935b 100644 --- a/fr/docs/using-regolith/basics/index.html +++ b/fr/docs/using-regolith/basics/index.html @@ -1,4 +1,4 @@ -Les bases | Regolith Desktop
\ No newline at end of file diff --git a/fr/docs/using-regolith/configuration/index.html b/fr/docs/using-regolith/configuration/index.html index 73acfe42..673ecd37 100644 --- a/fr/docs/using-regolith/configuration/index.html +++ b/fr/docs/using-regolith/configuration/index.html @@ -1,4 +1,4 @@ -Configuration | Regolith Desktop
\ No newline at end of file diff --git a/fr/docs/using-regolith/first-launch/index.html b/fr/docs/using-regolith/first-launch/index.html index 4bc6ca78..43f7b141 100644 --- a/fr/docs/using-regolith/first-launch/index.html +++ b/fr/docs/using-regolith/first-launch/index.html @@ -1,4 +1,4 @@ -Premier lancement | Regolith Desktop
\ No newline at end of file diff --git a/fr/docs/using-regolith/index.html b/fr/docs/using-regolith/index.html index f621435b..a735ee38 100644 --- a/fr/docs/using-regolith/index.html +++ b/fr/docs/using-regolith/index.html @@ -6,6 +6,6 @@
    • Utilisation -
    \ No newline at end of file diff --git a/fr/index.html b/fr/index.html index 501739de..24f347f5 100644 --- a/fr/index.html +++ b/fr/index.html @@ -9,52 +9,7 @@

    L’environnement Regolith Desktop #

    La productivité d’abord #

    Regolith utilise i3: un gestionnaire de fenêtre en tuiles qui est populaire, rapide, configurable et très pratique pour tout piloter avec son clavier. Regolith intègre i3 avec d’autres composants comme i3bar, rofication, gnome-flashback, et ilia afin de fournir une interface de bureau complète.

    Système de gestion GNOME -#

    En fournissant une session gnome avec gnome-flashback, Regolith s’affranchi d’une bonne partie de la complexité des environnements typiques basés sur gnome-shell en fournissant un système de gestion simple et consistant.

    Obtenir Regolith 2.2 -#

    UPDATE: The Regolith repository key has changed. Update it by re-running the first step for your distro/version from below. More Details
    -

    Regolith peut être installé en tant que programme système. Cela permet de rendre la mise à jour et la suppression plus consistants. -Les étapes suivantes décrivent comment configurer votre système pour récupérer les paquets depuis le dépôt de paquets Regolith et installer le programme de bureau.

    1. Enregistrer la clé publique de Regolith localement dans apt:

      wget -qO - https://regolith-desktop.org/regolith.key | \
-gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg > /dev/null
-

    2. Ajouter l’URL du dépôt dans vos sources apt:

      echo deb "[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \
-https://regolith-desktop.org/release-ubuntu-kinetic-amd64 kinetic main" | \
-sudo tee /etc/apt/sources.list.d/regolith.list
-

    3. Mettre à jour les dépôts apt et installer Regolith

      sudo apt update
-sudo apt install regolith-desktop regolith-compositor-picom-glx
-sudo apt upgrade
-

    4. Redémarrer le système

    Le gestionnaire de connexion doit être redémarré pour que la nouvelle session de bureau soit reconnue. La manière la plus simple de faire est de redémarrer votre système.

    Le paquet regolith-desktop installe une configuration minimale qui devrait fonctionner sur la plupart des architectures. -Pour ajouter des paquets supplémentaires afin d’avoir un environnement plus riche et fonctionnel, vous pouvez lire Paquets recommandés pour les nouveaux utilisateurs.
    Remplacer arm64 par amd64 aux deux endroits dans les lignes ci-dessus pour une installation sur un système basé sur ARM.
    The regolith-compositor-picom-glx compositor should work on most computers. If you experience driver or visual issues, try another compositor.
    -

    Regolith peut être installé en tant que programme système. Cela permet de rendre la mise à jour et la suppression plus consistants. -Les étapes suivantes (aussi disponible sous la forme d’un script d’installation) décrivent comment configurer votre système pour récupérer les paquets depuis le dépôt de paquets Regolith et installer le programme de bureau.

    1. Enregistrer la clé publique de Regolith localement dans apt:

      wget -qO - https://regolith-desktop.org/regolith.key | \
-gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg > /dev/null
-

    2. Ajouter l’URL du dépôt dans vos sources apt:

      echo deb "[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \
-https://regolith-desktop.org/release-ubuntu-jammy-amd64 jammy main" | \
-sudo tee /etc/apt/sources.list.d/regolith.list
-

    3. Mettre à jour les dépôts apt et installer Regolith

      sudo apt update
-sudo apt install regolith-desktop regolith-compositor-picom-glx
-sudo apt upgrade
-

    4. Redémarrer le système

    Le gestionnaire de connexion doit être redémarré pour que la nouvelle session de bureau soit reconnue. La manière la plus simple de faire est de redémarrer votre système.

    Le paquet regolith-desktop installe une configuration minimale qui devrait fonctionner sur la plupart des architectures. -Pour ajouter des paquets supplémentaires afin d’avoir un environnement plus riche et fonctionnel, vous pouvez lire Paquets recommandés pour les nouveaux utilisateurs.
    Remplacer arm64 par amd64 aux deux endroits dans les lignes ci-dessus pour une installation sur un système basé sur ARM.
    The regolith-compositor-picom-glx compositor should work on most computers. If you experience driver or visual issues, try another compositor.
    -

    Regolith peut être installé en tant que programme système. Cela permet de rendre la mise à jour et la suppression plus consistants. -Les étapes suivantes (aussi disponible sous la forme d’un [script d’installation](<(/install-release-ubuntu-20.04-amd64.txt)»)) décrivent comment configurer votre système pour récupérer les paquets depuis le dépôt de paquets Regolith et installer le programme de bureau.

    1. Enregistrer la clé publique de Regolith localement dans apt:

      wget -qO - https://regolith-desktop.org/regolith.key | sudo apt-key add -
-

    2. Ajouter l’URL du dépôt dans vos sources apt:

      echo deb "[arch=amd64] https://regolith-desktop.org/release-ubuntu-focal-amd64 focal main" | \
-sudo tee /etc/apt/sources.list.d/regolith.list
-
    Remplacer arm64 par amd64 aux deux endroits dans les lignes ci-dessus pour une installation sur un système basé sur ARM.

    1. Mettre à jour les dépôts apt et installer Regolith

      sudo apt update
-sudo apt install regolith-desktop regolith-compositor-picom-glx
-sudo apt upgrade
-
    Le paquet regolith-desktop installe une configuration minimale qui devrait fonctionner sur la plupart des architectures. -Pour ajouter des paquets supplémentaires afin d’avoir un environnement plus riche et fonctionnel, vous pouvez lire Paquets recommandés pour les nouveaux utilisateurs.
    1. Redémarrer le système

    Le gestionnaire de connexion doit être redémarré pour que la nouvelle session de bureau soit reconnue. La manière la plus simple de faire est de redémarrer votre système.

    -

    Regolith peut être installé en tant que programme système. Cela permet de rendre la mise à jour et la suppression plus consistants. -Les étapes suivantes (aussi disponible sous la forme d’un [script d’installation](<(/install-release-debian-11-amd64.txt)»)) décrivent comment configurer votre système pour récupérer les paquets depuis le dépôt de paquets Regolith et installer le programme de bureau.

    1. Enregistrer la clé publique de Regolith localement dans apt:

      wget -qO - https://regolith-desktop.org/regolith.key | \
-gpg --dearmor | sudo tee /usr/share/keyrings/regolith-archive-keyring.gpg > /dev/null
-

    2. Ajouter l’URL du dépôt dans vos sources apt:

      echo deb "[arch=amd64 signed-by=/usr/share/keyrings/regolith-archive-keyring.gpg] \
-https://regolith-desktop.org/release-debian-bullseye-amd64 bullseye main" | \
-sudo tee /etc/apt/sources.list.d/regolith.list
-
    Remplacer arm64 par amd64 aux deux endroits dans les lignes ci-dessus pour une installation sur un système basé sur ARM.

    1. Mettre à jour les dépôts apt et installer Regolith

      sudo apt update
-sudo apt install regolith-desktop regolith-compositor-picom-glx
-sudo apt upgrade
-
    Le paquet regolith-desktop installe une configuration minimale qui devrait fonctionner sur la plupart des architectures. -Pour ajouter des paquets supplémentaires afin d’avoir un environnement plus riche et fonctionnel, vous pouvez lire Paquets recommandés pour les nouveaux utilisateurs.
    1. Redémarrer le système

    Le gestionnaire de connexion doit être redémarré pour que la nouvelle session de bureau soit reconnue. La manière la plus simple de faire est de redémarrer votre système.

    -

    Regolith Linux est un environnement de bureau Regolith installé dans une image customisée d’Ubuntu 22.04. Cela permet de démarrer depuis une clé USB afin d’exécuter Regolith sans avoir à l’installer. -Cela permet également d’installer sur le disque d’un ordinateur. Regolith Linux ajoute les fonctionnalités suivantes par rapport à Regolith Desktop:

    • Le design Regolith lors du démarrage et des écrans de connexion
    • Utilise lightdm comme gestionnaire d’affichage plutôt que gdm3 pour éviter les dépendances inutiles
    • Les paquets suivants ne sont pas installés: gdm3, gnome-shell, ubuntu-session, evolution-data-server, snapd. Ils peuvent néanmoins être installés par l’utilisateur.
    Download Regolith Linux 2.2

    Rendez-vous sur Regolith 2.2 release notes pour plus d’informations.

    Aperçu des fonctionnalités +#

    En fournissant une session gnome avec gnome-flashback, Regolith s’affranchi d’une bonne partie de la complexité des environnements typiques basés sur gnome-shell en fournissant un système de gestion simple et consistant.

    Aperçu des fonctionnalités #

    Lors de la première connexion, un dialogue (activé à n’importe quand avec super ?) présente les raccourcis clavier les plus important utilisés avec i3-wm.
    Pour celles et ceux qui travaillent dans le terminal, pressez super enter suffit à vous satisfaire.
    @@ -73,6 +28,6 @@ #

    Annonces #

    Discussions et Aide #

    Développement -#