https://github.com/gh0stzk/dotfiles

BSPWM environment with 18 themes. With a theme selector to change on the fly.
https://github.com/gh0stzk/dotfiles
alacritty archlinux bspwm bspwm-themes dotfiles eww hyprland jgmenu linux nvim-config onedark picom polybar polybar-scripts polybar-themes rice rofi rofi-theme unixporn window-manager
Last synced: 11 days ago
JSON representation
BSPWM environment with 18 themes. With a theme selector to change on the fly.
Host: GitHub
URL: https://github.com/gh0stzk/dotfiles
Owner: gh0stzk
License: gpl-3.0
Created: 2020-06-22T15:16:10.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2025-04-11T18:41:32.000Z (11 days ago)
Last Synced: 2025-04-11T23:54:41.820Z (11 days ago)
Topics: alacritty, archlinux, bspwm, bspwm-themes, dotfiles, eww, hyprland, jgmenu, linux, nvim-config, onedark, picom, polybar, polybar-scripts, polybar-themes, rice, rofi, rofi-theme, unixporn, window-manager
Language: Shell
Homepage:
Size: 222 MB
Stars: 3,444
Watchers: 40
Forks: 263
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project

README

        # A complete BSPWM Window Manager Environment



![bspwm-dotfiles](https://github.com/gh0stzk/dotfiles/assets/67278339/0340846a-74d4-4a43-9430-142b0832738d)

 [ 
 Install 
 ](#-installation) 

 [ 
 Features 
 ](#-features) 

 [ 
 Themes 
 ](#-the-themes) 

 [ 
 Keybindings 
 ](#very-useful-keybindigs-to-know) 

 [ 
 Wiki 
 ](https://github.com/gh0stzk/dotfiles/wiki) 








https://github.com/user-attachments/assets/3eaae1e2-04dc-4a9b-8c91-139f85f5fb9e




## 👻 Welcome

Welcome to my dotfiles. I’m gh0stzk from Mexico.

These dotfiles are designed with the goal of providing a bspwm environment that is lightweight, efficient, and functional, tailored for any use—whether it’s gaming, web browsing, or a productive work setting.

You’ll have 18 unique themes to choose from, each with its own style, colors, and navigation bar options. With this variety, you’re sure to find one that suits your preferences and needs.

## :book: Wiki

I already started writing the [**Wiki**](https://github.com/gh0stzk/dotfiles/wiki), you should give it a read. If it is your first time with a WM, you may be interested in reading [First steps after installing the dotfiles](https://github.com/gh0stzk/dotfiles/wiki/Firsts-steps-after-installing) or maybe read [frequently asked questions and answers](https://github.com/gh0stzk/dotfiles/wiki/Questions---Answers) [Keybinds](https://github.com/gh0stzk/dotfiles/wiki/Keyboard-Shortcuts) [Firefox Theme](https://github.com/gh0stzk/dotfiles/wiki/Firefox-Theme).

## 🚀 Features



**Change themes on the fly**

^{You can switch themes instantly, with no need to restart your session or environment. With just one click, the change is applied immediately.}

**Consistency Across the Environment**

^{Each theme not only changes the appearance of bspwm but also instantly transforms the color scheme in terminals (Alacritty & Kitty), eww widgets, polybar bars, notifications, gtk theme, launchers 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.}

**Eww Widgets**

^{4 different widgets, including a calendar, music player, profile card and a cheatsheet. These widgets are not only functional but also instantly adapt to the color scheme of the selected theme.}

**Jgmenu**

^{Explore an elegant right-click menu (Desktop) made with Jgmenu, which also syncs with themes for flawless visual consistency.}

**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 specifically tailored to the theme in use. But if surprises aren't your thing, our wallpaper menu lets you choose from over 5 exclusive wallpapers for each theme.}

**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 and Animations**

^{Each theme features a unique color palette, along with transparencies, shadows, and animations—all designed to maintain visual balance without impacting performance or overwhelming the environment.}

**Rofi Applets**

^{Rofi applets to simplify your workflow:}

- Network Manager

- Bluetooth Controller

- Clipboard Manager

- Screenshot Tool

- Android MTP Manager

- Power Menu

- Keyboard Layout

- Terminal Selector (Alacritty or Kitty)

- Rofi app launcher style selector

- Tab app switcher

**Tmux Configuration**

^{Benefit from a newly added tmux configuration and design, enhancing your terminal multiplexing experience.}

**Neovim Setup**

^{Simple yet powerful neovim configuration with the following features:}

- Treesitter

- Lsp servers

- Completions [blink.nvim](https://github.com/Saghen/blink.nvim)

- Formatting [conform.nvim](https://github.com/stevearc/conform.nvim)

- Picker [Snacks-picker](https://github.com/folke/snacks.nvim/blob/main/docs/picker.md)

- Explorer [Snacks-explorer](https://github.com/folke/snacks.nvim/blob/main/docs/picker.md)

- Tab Line [barbar.nvim](https://github.com/romgrk/barbar.nvim)

- Statusline [lualine.nvim](https://github.com/nvim-lualine/lualine.nvim)

- Autopairs [mini-autopairs](https://github.com/echasnovski/mini.nvim/blob/main/readmes/mini-pairs.md)

- Hipatterns [mini-hipatterns](https://github.com/echasnovski/mini.nvim/blob/main/readmes/mini-hipatterns.md)

- Indent guides [Snacks-indent](https://github.com/folke/snacks.nvim/blob/main/docs/indent.md)

- Dashboard [Snacks-dashboard](https://github.com/folke/snacks.nvim/blob/main/docs/dashboard.md)

- WhichKey [which-key.nvim](https://github.com/folke/which-key.nvim)

**Optimized ZSH Configuration**

^{Optimized, native ZSH configuration. Not __Oh-My-Zsh__ or other bloated plugin managers. Some features:}

- Fastest and optimized performance compinit function

- Autocompletion

- Syntax highlighting

- History substring search

- Fzf-tab completion with previews!!

---

### 🎨 Launchers

| :tshirt: Theme Selector |

|:-:|

|![Screenshot-11_12_2023-01-06-03](https://github.com/gh0stzk/dotfiles/assets/67278339/b11b5c58-b9ec-446b-8980-4f77bebb3432)|

| :traffic_light: Wallpaper Selector |

|:-:|

|![Shot-2024-11-08-134530](https://github.com/user-attachments/assets/dbac8c47-f12c-4242-97d6-38ad1193f76b)|

### 🎨 The themes

| Emilia |

|:-:|

||

| Jan |

|:-:|

|  |

| Aline |

|:-:|

|  |

| Andrea |

|:-:|

|  |

| Cynthia |

|:-:|

|  |

| Isabel |

|:-:|

|  |

| Silvia |

|:-:|

||

| Melissa |

|:-:|

|  |

| Pamela |

|:-:|

|  |

| Cristina |

|:-:|

|  |

| Karla |

|:-:|

|  |

| z0mbi3 |

|:-:|

|  |

| Brenda |

|:-:|

|  |

| Daniela |

|:-:|

|  |

| Marisol |

|:-:|

|  |

| h4ck3r |

|:-:|

|  |

| Varinka |

|:-:|

|  |

| Yael |

|:-:|

|  |

---

### Rofi applets

| ![Shot-2024-11-09-131850](https://github.com/user-attachments/assets/05107f74-e137-41c0-9132-31d9c4fa0bb4) | ![Shot-2024-11-09-131918](https://github.com/user-attachments/assets/c5680b39-9aba-41e5-a781-7f23f7f8e336) |

| :--------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------: |

|                                                 Power Menu                                                 |                                                Screenshoter                                                |

| ![Shot-2024-11-09-132031](https://github.com/user-attachments/assets/0893b0b6-1211-43cb-9923-f4e42af70f4b) | ![Shot-2024-11-09-133244](https://github.com/user-attachments/assets/03546cb9-cf0d-42a2-b424-458c887e67c2) |

| :--------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------: |

|                                              Keyboard Layout                                               |                                               Android Mount                                                |

| ![Shot-2024-11-09-150142](https://github.com/user-attachments/assets/f7d1c404-c2e8-43c0-ad5e-6b052e3918c3) | ![Shot-2024-11-09-155335](https://github.com/user-attachments/assets/889d2ccf-beff-402d-8804-6d82c5638860) |

| :--------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------: |

|                                              Network Manager                                               |                                             Clipboard Manager                                              |

| ![Shot-2024-11-09-153419](https://github.com/user-attachments/assets/4af56dfa-f61f-4b45-8350-d064fe67663a) | ![Shot-2024-11-09-153444](https://github.com/user-attachments/assets/9a5d86e3-d58c-4b26-bb3e-86ec4974261a) |

| :--------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------: |

|                                             Bluetooth Manager                                              |                                              Terminal Manager                                              |

| ![Shot-2025-04-08-084756](https://github.com/user-attachments/assets/835366c8-88c5-4daf-8260-5c822e27abc8) | ![Shot-2025-04-08-084924](https://github.com/user-attachments/assets/c32f3cdb-7a5a-4372-b6f2-3f4a09f50868) |

| :--------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------: |

|                                              Tab app switcher                                              |                                              Rofi style selector                                           |

---

### Rofi app launcher styles

| ![Shot-2025-04-08-090012](https://github.com/user-attachments/assets/57ebcc98-73ea-4f76-bb2b-fe3f187be5e7) | ![Shot-2025-04-08-090041](https://github.com/user-attachments/assets/26361cd3-c3b4-48a2-a550-8df5cff120f5) | ![Shot-2025-04-08-090107](https://github.com/user-attachments/assets/16da6b0f-5a9e-4410-bb95-cb9fe696ce55) |

| :---: | :---: | :---: |

| Normal | Full | Minimal |

### Fzf tab terminal completions with previews!

| ![fzf tab](https://github.com/user-attachments/assets/2771e549-f7cc-44da-baf2-6c9fa299f0fb) |

| :---: |

| cd, ls, pacman, systemctl, kill, cat, commands with preview! |

### Eww widgets

| ![ProfilePane](https://github.com/user-attachments/assets/07827cff-63b9-40db-b0ef-8c214a5d8ec3) | ![Calendar](https://github.com/user-attachments/assets/5ffcff9e-0852-4d9f-83b5-4bce71e69f7c) | ![MusicPlayer](https://github.com/user-attachments/assets/b96c49a1-57d1-43e5-bff0-cab2e6b4d101) |

| :---: | :---: | :---: |

| Profile Panel | Calendar | Music Player |

| ![Shot-2024-11-10-000520](https://github.com/user-attachments/assets/a0871d4e-5b2b-4e64-ae79-617feec71cf1) |

| :--------------------------------------------------------------------------------------------------------: |

|                                                Cheat Sheet                                                 |

---

### Rice Editor

| ![Shot-2024-11-09-155549](https://github.com/user-attachments/assets/2ac910c8-171f-47eb-8210-1469b6f75cc2) |

| :--------------------------------------------------------------------------------------------------------: |

|                                                Rice Editor                                                 |

### Lockscreen

| ![Lockscreen](https://github.com/user-attachments/assets/2f09b915-f426-49c3-b9b6-07be4e781f5a) |

| :--------------------------------------------------------------------------------------------: |

|                                           Lockscreen                                           |

### Jgmenu

| ![Jgmenu](https://github.com/user-attachments/assets/82daebec-66a6-4716-8e78-b02fcec7e77c) |

| :----------------------------------------------------------------------------------------: |

|                                           Jgmenu                                           |

## Yazi config

https://github.com/user-attachments/assets/8e15cc1a-88b8-4a7e-a4de-e7da76021406

## Tmux theme

| ![ezgif com-animated-gif-maker](https://github.com/gh0stzk/dotfiles/assets/67278339/dd5f7261-0631-4a91-b584-51ca8859c197) |

| :-----------------------------------------------------------------------------------------------------------------------: |

|                                                        Tmux theme                                                         |

## Scratchpad

https://github.com/user-attachments/assets/79764678-c519-4a41-a333-2a862a6d10f8

## Environment

| ![Gtk-Ranger-Music](https://github.com/user-attachments/assets/a7f7c082-5ffd-4a6c-babf-7361764cec80) |

| :--------------------------------------------------------------------------------------------------: |

|            The environment changes with each theme. In the gif: (Ranger, Thunar, Ncmpcpp)            |

### Firefox theme

| Firefox theme - z0mbi3 Fox |

|:-:|

|  |

### Neovim setup

| Neovim setup |

|:-:|

| ![Neovim setup](https://github.com/user-attachments/assets/a70a0ebb-9921-4d2d-88f3-5eabdc5d10f9) |

| Plugins included [Neovim setup wiki](https://github.com/gh0stzk/dotfiles/wiki/Neovim-setup) |

## Very useful keybindigs to know...

| Keys                                                                                                                                                                                                     | Action                                                                |

| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------- |

| super + Enter
super + alt + Enter                                                                                                              | Open a terminal
Open a floating terminal.                          |

| alt + @space                                                                                                                                                                       | Display menu to select a theme.                                       |

| super + @space                                                                                                                                                                     | Apps Menu.                                                            |

| super + alt + w                                                                                                                                                         | Opens a menu to select a wallpaper.                                   |

| super + alt + h
super + alt + u                                                                                                     | Hides bar/s
unhide bar/s                                           |

| super + alt + s                                                                                                                                                         | Takes screenshot.                                                     |

| ctrl + alt + [plus,minus,t]                                                                                                                                             | Changes transparency on focused window.                               |

| ctrl + super + alt + p
ctrl + super + alt + r
ctrl + super + alt + k | Power off computer
Restart computer
Brute kill a window/process |

| super + alt + r                                                                                                                                                         | Restart bspwm.                                                        |

| `alt` + `F1`                                                                                                                                                                                             | Show keybinds cheatsheet                                              |

And more.. You need to look sxhkdrc file for more, or press Alt + F1 for a cheatsheet.

---

> [!CAUTION]

> ⚠️⚠️⚠️ My dotfiles are designed for a **1600x900** resolution with **96 DPI** on a single monitor.

> Some elements may appear different on higher or lower resolutions. You may need to make adjustments to adapt them to your preferences and setup. ⚠️⚠️⚠️

> [!important]

> ✏️✏️✏️ The installer assumes you already have a **functional** Arch Linux installation, whether it’s a fresh install or an existing setup.

>

> A login manager of your choice is required; **lightdm** is recommended.

>

> The rofi connection manager applet, works with **NetworkManager**

>

> If using a virtual machine, be sure to change the Picom backend from **glx** to **xrender** before rebooting, and verify that hardware acceleration is correctly configured in your VM. ✏️✏️✏️

> [!warning]

> :wrench::wrench::wrench: I have tested the installation and functionality of these dotfiles on both high- and low-end machines.

>

> Some adjustments may still be needed, such as changing the Picom backend or VSync settings to ensure compatibility with your graphics card.

>

> If you encounter any issues, feel free to open an [issue](https://github.com/gh0stzk/dotfiles/issues). :wrench::wrench::wrench:

---

### 💾 Installation:

> [!NOTE]

> The installer only works for **ARCH** Linux, and based distros. (Except NO-Systemd ditros like Artix)

Before running this command, check [RiceInstaller](https://raw.githubusercontent.com/gh0stzk/dotfiles/master/RiceInstaller) to make sure it's working and confirm it's safe for your system.

- Open a terminal and execute this commands one by one:

```sh

# Download the installer in your $HOME

curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller

# Give it execution permission

chmod +x RiceInstaller

# Run the installer

./RiceInstaller

```
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/gh0stzk/dotfiles

Awesome Lists containing this project

README
