Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/r1vs3c/auto-bspwm
Bash script that automates the setup of a professional hacking environment for Kali Linux using the tiled window manager bspwm.
https://github.com/r1vs3c/auto-bspwm
bash-script bspwm dotfiles kitty oh-my-zsh picom polybar polybar-themes powerlevel10k rofi sxhkd zsh
Last synced: 7 days ago
JSON representation
Bash script that automates the setup of a professional hacking environment for Kali Linux using the tiled window manager bspwm.
- Host: GitHub
- URL: https://github.com/r1vs3c/auto-bspwm
- Owner: r1vs3c
- Created: 2023-10-01T03:39:00.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-10T02:59:05.000Z (4 months ago)
- Last Synced: 2024-10-02T04:01:24.532Z (about 1 month ago)
- Topics: bash-script, bspwm, dotfiles, kitty, oh-my-zsh, picom, polybar, polybar-themes, powerlevel10k, rofi, sxhkd, zsh
- Language: Shell
- Homepage:
- Size: 13.1 MB
- Stars: 301
- Watchers: 7
- Forks: 59
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# auto-bspwm
> This is a Bash script that automates the setup of a professional hacking environment for Kali Linux using the tiled window manager [bspwm](https://github.com/baskerville/bspwm).
## Installation
1. Install available updates.
```shell
sudo apt update
sudo apt upgrade -y
```
2. Clone the repository and navigate to it.
```shell
git clone https://github.com/r1vs3c/auto-bspwm.git
cd auto-bspwm
```
3. Grant execution permissions to the script.
```shell
chmod +x setup.sh
```
4. Execute the script.
```shell
./setup.sh
```
5. After the script has finished, you will be prompted to restart the system. Once you have rebooted, select `bspwm` as the window manager and then log in.
## Overview of the environment
## Keyboard shortcuts
- Windows + Enter: Open a terminal emulator window (kitty).
- Windows + W: Close the current window.
- Windows + Alt + R: Restart the bspwm configuration.
- Windows + Alt + Q: Log out.
- Windows + (⬆⬅⬇➡): Navigate through windows in the current workspace.
- Windows + D: Open Rofi. Press Esc to exit.
- Windows + (1,2,3,4,5,6,7,8,9,0): Switch to the respective workspace.
- Windows + T: Change the current window to tile mode.
- Windows + M: Toggle the current window to "full" mode (doesn't occupy the polybar). Press the same keys to return to tile mode.
- Windows + F: Change the current window to fullscreen mode (occupies the entire screen, including the polybar).
- Windows + S: Change the current window to floating mode.
- Windows + Shift + (1,2,3,4,5,6,7,8,9,0): Move the current window to another workspace.
- Windows + Alt + (⬆⬅⬇➡): Resize the current window (only works if it's in floating mode).
- Windows + Ctrl + (⬆⬅⬆➡): Change the position of the current window (only works if it's in floating mode).
- Windows + Shift + F: Open Firefox.
- Windows + Shift + B: Open Burpsuite.
- Ctrl + Alt + L: Lock the screen.
- Ctrl + Shift + ⬆⬇: Increase/decrease volume.
- Ctrl + Shift + M: Mute/unmute volume.
- Windows + Ctrl + Alt + (⬆⬅⬇➡): Show a preselection and then open a window (kitty, Firefox, File manager, etc.).
- Windows + Ctrl + Alt + Space: Undo the preselection.
- Ctrl + Shift + Enter: Open a sub-window in the current window.
- Ctrl + Shift + Z: Zoom in on the current sub-window.
- Ctrl + (⬆⬅⬇➡): Navigate between sub-windows in the current window.
- Ctrl + Shift + R: Resize the current sub-window. Afterward, use:
- W for 'Wider'
- N for 'Narrower'
- T for 'Taller'
- S for 'Shorter'
- R for 'Reset'
- Esc to quit resize mode.
- Ctrl + Shift + L: Toggle the arrangement of sub-windows.
- Ctrl + Shift + W: Close the current sub-window or tab.
- Ctrl + Shift + T: Open a tab in the current window.
- Ctrl + Shift + Alt + T: Rename the title of the current tab.
- Ctrl + Shift + (⬅➡): Navigate between current tabs.
- Ctrl + Shift + C: Copy to the clipboard.
- Ctrl + Shift + V: Paste from the clipboard.
- F1: Copy to buffer A.
- F2: Paste from buffer A.
- F3: Copy to buffer B.
- F4: Paste from buffer B.
## Software
This configuration uses the following software:
- **WM**: [bspwm](https://github.com/baskerville/bspwm)
- **Hotkey**: [sxhkd](https://github.com/baskerville/sxhkd)
- **Locker**: [i3lock-fancy](https://github.com/meskarune/i3lock-fancy)
- **Shell**: [zsh](https://www.zsh.org/)
- **Shell Theme**: [powerlevel10k](https://github.com/romkatv/powerlevel10k)
- **Shell configuration manager**: [ohmyzsh](https://github.com/ohmyzsh/ohmyzsh)
- **Bars**: [polybar](https://github.com/polybar/polybar)
- **Bars Theme**: [polybar-themes](https://github.com/adi1090x/polybar-themes)
- **Compositor**: [picom](https://github.com/yshui/picom)
- **File Manager**: [thunar](https://docs.xfce.org/xfce/thunar/start)
- **Fonts**: [iosevka](https://github.com/ryanoasis/nerd-fonts/tree/master/patched-fonts/Iosevka) and [hack](https://github.com/ryanoasis/nerd-fonts/tree/master/patched-fonts/Hack)
- **Application Launcher**: [rofi](https://github.com/davatorium/rofi)
- **Browsers**: [firefox](https://www.mozilla.org/en-US/firefox/new/)
- **Terminals**: [kitty](https://sw.kovidgoyal.net/kitty/) and [qterminal](https://github.com/lxqt/qterminal)
- **Static Wallpaper**: [feh](https://github.com/derf/feh)
- **Screenshot**: [flameshot](https://flameshot.org/)
## Credits
- This environment has been inspired by the functionalities of [S4vitar's](https://github.com/s4vitar) environment.
- Thanks to [Cube](https://github.com/ZLCube) for their contribution to the creation of the `archkali.png` wallpaper.