⛺ A complete bspwm configuration for Arch Linux

• Modern NEOVIM configuration.
• 18 different themes i collected for BSPWM and Polybar. With a theme selector to change on the fly.
• All the system initialization configuration you needed.

🌠 Thanks for dropping by!

This is my personal collection of configuration files.

You are probably here for my Aesthetic BSPWM and Aesthetic NEOVIM configuration.

Here are some details about my setup:

• WM: bspwm
• OS: Arch Linux
• Terminal: Alacritty/kitty
• Shell: zsh
• Bar: Polybar
• Music/Player: MPD/ncmpcpp
• Widgets: Eww
• Compositor: picom
• Editor: Neovim
• Browser: Firefox
• File Manager: Thunar
• Application Launcher: Rofi

📖 Wiki

Here is the wiki. I also wrote a tutorial about the installation of Arch Linux dual boot + dotfile usage, check Arch Linux 双系统 + Bspwm 配置小记.

If you have any problem, create issue or contact me: [email protected].

🚀 Features

Change themes on the fly

With our custom menu based on rofi launcher, switching between the 15 themes is as easy as a click. Enjoy the versatility of styles and color combinations instantly.

Consistency Across the Environment

Each theme not only changes the appearance of bspwm but also instantly transforms the color scheme in alacritty terminal, eww widgets, polybar bars, notifications, and more. Visual harmony is guaranteed in every corner of your system.

Unique Eww Widgets

Discover 4 unique eww widgets, including a calendar, power menu, music player, and user card. These widgets are not only functional but also instantly adapt to the color scheme of the selected theme.

Complete Customization

Explore an elegant right-click menu made with Jgmenu, which also syncs with themes for flawless visual consistency. Additionally, 10 polybar bars and 2 eww widgets offer a fully customizable user experience.

Variety of Wallpapers

Each login surprises you with a randomly selected wallpaper. But if surprises aren't your thing, our wallpaper menu lets you choose from overall wallpapers.

Visual Composition with Picom

Experience effortless beauty with picom as the compositor, providing a pleasing aesthetic without sacrificing performance. Enjoy a hassle-free working experience with delightful visual effects, balance between performance and beauty.. And you can adjust the transparency of your open windows with a simple key combination. Control the appearance of your desktop to perfectly suit your mood and style.

🔮 Additional Features

Local Music Control

Manage your local music from the polybar module and the ncmpcpp player, both with a unique design that adapts to the theme's color scheme.

Flexibility

Hide and show the polybar and eww widgets according to your needs, giving you complete control over your workspace.

Functional Scratchpad

Access the scratchpad functionality, a terminal window you can show or hide for tasks when you don't want the window taking up unnecessary space.

• Change themes on the fly: 15 different Rices now!
• Theme Selector: Alt + Space to launch it.
• Random wallpaper: Every time you switch between rices or reload bspwm with Space + R a new wallpaper is set depending on the rice you are on.
• Wallpaper Changer: Super + Shift + W changes between different wallpapers in the actual rice.
• Hide / Unhide Bar: If you need, you can hide bars!
• Change transparency on the fly: Increase and decrease transparency in focused or selected window.

And more...

Caution

This dotfiles are configured at 1600x900 resolution with 96 DPI and 1 monitor. Some stuff might break on lower or higher resolutions, but still work!

🎨 The themes

Rice-Selector.mp4

👕 Theme Selector

🚥 Wallpaper Selector

🐙 Emilia:

🐙 Jan

🐙 Aline

🐙 Andrea

🐙 Cynthia

🐙 Isabel

🐙 Silvia

🐙 Melissa

🐙 Pamela

🐙 Cristina

🐙 Karla

(Zombie-Night Color Scheme)

🐙 z0mbi3:

🐙 Brenda:

🐙 Daniela:

🐙 Marisol:

🐙 h4ck3r:

🐙 Varinka:

🐙 Yael:

☕ Very useful keybindigs to know...

• F1 Display keybinds cheat sheet.
• Alt + Space Display menu to select theme selector.
• Super + Space Apps Menu.
• Alt + Shift + W Wallpaper selector.
• Ctrl + Super + {h, u} Hide/Unhide bars
• Ctrl + Alt + S Take screenshot.
• Ctrl + Alt + {+,-,t} Changes transparency on focused window.
• Ctrl + Super + Shift + P Power off computer.
• Ctrl + Super + Shift + R Restart computer.
• Ctrl + Super + Shift + L Lockscreen.
• Ctrl + Super + Shift + Q Logout.
• Ctrl + Super + Shift + K Brute Kill a window/process.
• Alt + Shift + Return Open a terminal.
• Alt + Shift + F Open a floating terminal.
• Super + R Restart bspwm.
• Super + Esc Restart sxhkd.

Hold Super and left-click to move window, right-click to resize window.

💾 Installation

Important

The installer only works for Arch Linux, and based distros. This is step-by-step how to install this dotfiles. Just R.T.F.M.

• First, download the install script

curl https://raw.githubusercontent.com/CuB3y0nd/1llusion/master/install -o $HOME/install

• Then, give it execute permissions

chmod +x install

• Finally, run the install script

./install

🎐 About Neovim

The neovim configuration is modified base on NvChad.

If you want use my default configuration, choose N while in neovim's first startup.

If you wanna to configure it yourself based on NvChad, choose y.

For more information about customize your nvim, see NvChad.

🎃 References

• gh0stzk's rices: dotfiles
• NvChad: NvChad
• ElKowars wacky widgets: Eww