https://github.com/cub3y0nd/1llusion
My aesthetic dotfiles configuration.
https://github.com/cub3y0nd/1llusion
archlinux auto-config-linux bspwm config dotfiles eww init-system initscript install-script linux polybar rice rofi themes
Last synced: 7 days ago
JSON representation
My aesthetic dotfiles configuration.
- Host: GitHub
- URL: https://github.com/cub3y0nd/1llusion
- Owner: CuB3y0nd
- License: mit
- Created: 2023-06-23T06:59:12.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-05-01T05:56:19.000Z (12 days ago)
- Last Synced: 2025-05-01T06:31:31.468Z (12 days ago)
- Topics: archlinux, auto-config-linux, bspwm, config, dotfiles, eww, init-system, initscript, install-script, linux, polybar, rice, rofi, themes
- Language: Shell
- Homepage:
- Size: 82.8 MB
- Stars: 32
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# :tent: 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.
## :stars: 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
## :book: Wiki
Here is the [wiki](https://github.com/CuB3y0nd/1llusion/wiki). I also wrote a tutorial about the installation of Arch Linux dual boot + dotfile usage, check [Arch Linux 双系统 + Bspwm 配置小记](https://www.assembly.rip/posts/linux/archlinux-configure-note/).
## :rocket: 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.
### RiceEditor
Is an application designed to simplify the customization of your current theme. It allows you to easily adjust various visual and configuration aspects, tailoring your environment to your preferences without the need to manually edit configuration files.
### 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.
### LockScreen
The lockscreen automatically adapts to the active theme and offers two locking options: it can capture the current screen with a blur effect, or use a specific wallpaper depending on the selected theme.
### 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.
### Scratchpad
A scratchpad is a tool designed to provide quick, temporary access to applications or notes without disrupting the desktop workflow. When activated, the scratchpad appears over the current workspace, allowing the user to access applications like a terminal, text editor, or any configured tool. Minimizing it hides the scratchpad from view but keeps it running in the background, ready to be reopened with a simple keyboard shortcut.
It's ideal for quick note-taking, running commands, or accessing auxiliary tools without losing focus on the current task.
### 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.
## :crystal_ball: 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:** `Ctrl + Alt + 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!
## :art: The themes
| :tshirt: Theme Selector |
|:-:|
||
| :traffic_light: Wallpaper Selector |
|:-:|
||
### :octopus: Emilia
|
|
|---|
### :octopus: Jan
||
|---|
### :octopus: Aline
||
|---|
### :octopus: Andrea
||
|---|
### :octopus: Cynthia
||
|---|
### :octopus: Isabel
||
|---|
### :octopus: Silvia
||
|---|
### :octopus: Melissa
||
|---|
### :octopus: Pamela
||
|---|
### :octopus: Cristina
||
|---|
### :octopus: Karla
**(Zombie-Night Color Scheme)**
||
|---|
### :octopus: z0mbi3
||
|---|
### :octopus: Brenda
||
|---|
### :octopus: Daniela
||
|---|
### :octopus: Marisol
||
|---|
### :octopus: h4ck3r
||
|---|
### :octopus: Varinka
||
|---|
### :octopus: Yael
||
|---|
## :coffee: Very useful keybindigs to know
- `Alt + F1` Keybindings Cheat Sheet
- `Super + R` Restart bspwm
- `Super + Esc` Restart sxhkd
- `Alt + Space` Theme Selector
- `Super + Space` Apps Launcher
- `Ctrl + Alt + W` Wallpaper Selector
- `Alt + Return` Open a terminal
- `Alt + Shift + Return` Open a floating terminal
- `Super + Shift + {h, u}` Hide/Unhide Polybar/Eww bars
- `Ctrl + Alt + S` Screenshot
- `Ctrl + Shift + {+, -, i}` Changes transparency
- `Ctrl + Super + Shift + P` Power off
- `Ctrl + Super + Shift + R` Restart
- `Ctrl + Super + Shift + L` Lockscreen
- `Ctrl + Super + Shift + Q` Logout
- `Ctrl + Super + Shift + K` Brute Kill a window/process
Hold `Super` and left-click to move window, right-click to resize window.
## :floppy_disk: 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](https://en.wikipedia.org/wiki/RTFM).
- **First, download the install script**
```bash
curl https://raw.githubusercontent.com/CuB3y0nd/1llusion/master/install -o $HOME/install
```
- **Then, give it execute permissions**
```bash
chmod +x install
```
- **Finally, run the install script**
```bash
./install
```
## :jack_o_lantern: References
- **gh0stzk's rices:** [dotfiles](https://github.com/gh0stzk/dotfiles/tree/master)
- **ElKowars wacky widgets:** [Eww](https://github.com/elkowar/eww)