bspwm - xusiai/dotfiles GitHub Wiki
xbps-install -Su bspwm alacritty polybar rofi fzf mpc mpd ncmpcpp picom lm_sensors ksuperkey zathura starship dunst feh playerctl mpDris2 vscode neovim
paru -S bspwm alacritty polybar picom-ibhagwan rofi fzf mpc mpd ncmpcpp lm_sensors ksuperkey zathura starship dunst feh playerctl mpdris2 vscodium neovim
These should suffice but there are dotfiles included for other applications as well so pick and choose what you want to use.
Grab the files from this commit and place them in your home folder.
There are a number of SAGA themes available which are not included. A complete list can be found here. Instructions for the more common ones can be found below:
GTK accents
For a complete list of available theme accents click here. To install all of them:
git clone https://github.com/SAGAtheme/GTK.git
cp -r GTK cp -r GTK/themes/. ~/.local/share/themes
cp -r GTK cp -r GTK/icons/. ~/.local/share/themes
Select your preferred theme either in the $HOME/.config/gtk-3.0/settings.ini
or via something like LxAppearance.
NvChad/Neovim
- Install nvchad.
- Move the config
cp -r $HOME/dotfiles/Nvchad $HOME/.config/nvim/lua/custom
.
VScode
- Install recommended extensions
- Find the VScode folder name in
$HOME/.config
as it differs depending on your distribution and release. - Download the theme
wget https://raw.githubusercontent.com/SAGAtheme/VSCode/master/settings.json
- Move settings.json to
$HOME/.config/<VSCode folder name>/User/settings.json
Firefox
-
Open Firefox and enter
about:config
into the url bar. Search fortoolkit.legacyUserProfileCustomizations.stylesheets
and double click it to set it to true. If it's not there you can create it. -
Clone the theme
git clone https://github.com/SAGAtheme/Firefox.git
. -
Move the
chrome
folder into your Firefox profile folder. To find it you can enterabout:profile
into the url bar. -
Restart Firefox.
Spotify
- Requires Spicetify. Follow their instructions to install it. Once done run:
git clone --depth=1 https://github.com/SAGAtheme/Spotify.git $HOME/.config/spicetify/Themes/SAGA
spicetify config current_theme SAGA
spicetify apply
Restart Spotify.
Obsidian
wget https://raw.githubusercontent.com/SAGAtheme/Obsidian/master/SAGA.css
mv SAGA.css <your vault folder>/.obsidian/themes/SAGA.css
Logseq
wget https://raw.githubusercontent.com/SAGAtheme/LOGSEQ/master/custom.css
mv custom.css <your loseq folder>
Gedit
wget https://raw.githubusercontent.com/SAGAtheme/gedit/master/SAGA.xml
mv SAGA.xml $HOME/.local/share/gedit/styles/
Apply in Gedit preferences.
KEY | FUNCTION |
---|---|
MOD + RETURN | TERM |
MOD + BACKSPACE | FIREFOX |
MOD + C | CLOSE FOCUSED CLIENT |
ALT_L + F1 | ROFI |
MOD + M | NCMPCPP |
MOD + R | ENABLE REDSHIFT |
MOD + SHIFT + R | DISABLE REDSHIFT |
Look in sxhkdrc for the rest. The above should allow you to adjust the setup to your own preferrences. MOD is Mod4 or what is commonly referred to as the Windows key. If you installed ksuperkey pressing mod4 once will open rofi whilst still functioning as the main modifier (requires restarting bspwm or running ksuperkey if you did not reboot after linking the dotfiles).
- Some bar modules require additional dependencies to work:
- Pipewire (available but not enabled out of the box) requires pamixer.
- Update module is configured for Arch. There is a line included for Void Linux but you'll need to uncomment it and replace the Arch script with it in modules.ini. If you're on a different distribution you'll need to adapt it yourself.
- VPN module requires Mullvad but can be adapted to other providers. See the vpn script included and adapt it to your needs.
- Menus and VPN modules make use of rofi to some extent. VPN module will still show location in the bar but won't support interactive actions without rofi.
- GPU modules require an Nvidia card (and the their propriertary drivers).
- The rofi powermenu uses systemctl. Switch entries to loginctl if you're on a non-systemd-distribution like Void.
- The included .zshrc depends on the (also included) antigen file to automatically install plugins. Do not use one without the other.
- If fonts are not rendering make sure you run
fc-cache -v
. - Fonts, GTK theme and icons are included but you will have to switch to them (either via the config file or something like lxappearance). The font I use is a mix of SAGA Heavy and Sarasa Mono.
- Siduck whose dotfiles I've used for inspiration on several occasions ❤️
- Saimoomedits for the beautiful ncmpcpp config ❤️
- Manas140 for a few scripts ❤️
- Elenapan for the rofi-yt script ❤️