Julve-BSPWM

This is a Bash script that automates the setup of a professional hacking environment for Kali Linux using the tiled window manager bspwm.

Installation

1. Install available updates.

sudo apt update
sudo apt upgrade -y

2. Clone the repository and navigate to it.

git clone https://github.com/DonJulve/Julve-BSPWM.git
cd Julve-BSPWM

3. Grant execution permissions to the script.

chmod +x setup.sh

4. Execute the script.

./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

To change the polybar beetwen hack mode and normal mode use:

hack

To easily use wifi follow the instructions after using:

wifi

You can enable or disable an animated wallpaper using:

fuga

Wallpaper can be changed modfiying "~/Wallpapers/wallpaper.mp4"

Polybar Launcher

The Polybar includes a custom module launcher with the following mouse interactions:

• Left Click: Opens the application launcher (Rofi).
• Middle Click: Opens the Network Manager (networkmanager_dmenu) to manage connections.
• Right Click: Opens the color switcher script to easily change your Polybar theme.

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.
• Windows + Shift + O: Open Opera.
• Windows + Shift + V: Open Visual Studio Code.
• Windows + Shift + H: Open Hack Setup.
• 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
• Hotkey: sxhkd
• Locker: i3lock-fancy
• Shell: zsh
• Shell Theme: powerlevel10k
• Shell configuration manager: ohmyzsh
• Bars: polybar
• Bars Theme: polybar-themes
• Compositor: picom
• File Manager: thunar
• Fonts: iosevka and hack
• Application Launcher: rofi
• Browsers: firefox and opera gx
• Terminals: kitty and qterminal
• Static Wallpaper: feh
• Screenshot: flameshot
• Code Editor: neovim and vscode

Recommendations

• Please see the .zshrc file to know all comands (~/.zshrc).
• Please see all the plugins in neovim to know all comands (~/.config/nvim/lua/plugins).

Credits

• This environment has been inspired by the functionalities of S4vitar's environment.
• This environment has been inspired by the r1vs3c's environment (https://github.com/r1vs3c/auto-bspwm).