Skip to content

Configuration

Dan K edited this page Jul 25, 2024 · 3 revisions

This page contains some setup guides for TilingOS:

Feel free to request any additional guidance in issues section.


Configuring multi-monitor setups

The easiest way to do so is to use ArandR GUI tool that is pre-installed. Note that ArandR settings are session-wide, to keep it after reboot, use Save As button in the ArandR, then make this .sh script executable and add the following line into your .xinitrc before exec bspwm: bash /path/to/arandr/script.

Note: if your setup includes different monitor resolutions and you want to use them as monitors with equal software resolution, the bug-free way to do so is --scale option for the xrandr command. Refer to xrandr manual for details.

Change default cursor theme/size

Just edit your .xinitrc file: by default there's an entry like xsetroot -cursor_name left_ptr, that entry only sets default cursor type, not the theme nor size. You can use xsetroot -xcf /path/to/cursor <size> to set any custom cursor as default.

Note: sometimes on setups with different monitor resolution cursor size may be displayed incorrectly. To fix this replace that xsetroot line with xsetroot -xcf /usr/share/icons/Adwaita/cursors/left_ptr 16.

Change screen blanking behaviour

For runtime settings you can use xset dpms s off to turn off screen blanking or xset dpms s <SECONDS> to set custom screen blanking timeout. To save this settings after reboot just add this command into your .xinitrc before exec bspwm or change settings directly in the Xorg configuration files (xorg.conf).

Applying dark theme system-wide

Since most of the apps use GTK ot Qt framework to draw GUI and there are lots of themes like Adwaita that supports both of this frameworks, it's enough to set default GTK theme with gsettings set org.gnome.desktop.interface gtk-theme "theme-name" and default variant with gsettings set org.gnome.desktop.interface color-scheme "prefer-dark(OR lite)".

Copy-paste command to apply "Adwaita-dark" theme system-wide: gsettings set org.gnome.desktop.interface gtk-theme "Adwaita-dark"; gsettings set org.gnome.desktop.interface color-scheme "prefer-dark"; sed -i '/exec bspwm/ i\export GTK_THEME="Adwaita-dark"' ~/.xinitrc

But there are some applications like nemo which are more demanding of theme. To ensure that theese apps are displayed correctly, add into your .xinitrc before exec bspwm: export GTK_THEME="theme-name".

Note: Some apps may have problems with default Adwaita theme, so if it's your case and some of the apps wouldn't change it's appearance into the dark mode, it's recommended to use another theme like "Yaru-dark", for example. Copy-paste command to apply "Yaru-dark": sudo apt install yaru-theme-gtk; gsettings set org.gnome.desktop.interface gtk-theme "Yaru-dark"; gsettings set org.gnome.desktop.interface color-scheme "prefer-dark"; sed -i '/exec bspwm/ i\export GTK_THEME="Yaru-dark"' ~/.xinitrc

Clone this wiki locally