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.Main Xresources keys
Xresources Key |
Description |
|---|---|
| gtk.theme_name | GTK Theme (“Legacy Applications” 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.
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…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. |
Last updated on