# 🖥️ Kali BSPWM Custom Setup

Welcome to the **kali-bspwm** repository! This project provides a tailored configuration of BSPWM for a dual monitor setup on Kali Linux, optimized for productivity. Whether you're a developer, a cybersecurity enthusiast, or just someone who values an efficient workspace, this configuration is designed to enhance your daily workflow.

![Kali BSPWM Setup](https://example.com/path-to-your-image.jpg)

## 📜 Table of Contents

- [Features](#features)
- [Installation](#installation)
- [Configuration Files](#configuration-files)
- [Included Scripts and Tools](#included-scripts-and-tools)
- [Usage](#usage)
- [Customization](#customization)
- [Contributing](#contributing)
- [License](#license)
- [Links](#links)

## 🚀 Features

- Dual monitor support
- Clean and modern look using **Polybar**
- Fast and lightweight window management with **BSPWM**
- Custom shortcuts managed by **sxhkd**
- Beautiful terminal experience using **Kitty**
- Visual enhancements with **Picom**
- Elegant prompt with **Powerlevel10k**
- Easy-to-use application launcher via **Rofi**

## ⚙️ Installation

To install the configuration, follow these steps:

1. Clone the repository:
   ```bash
   git clone https://github.com/JatinMatrix/kali-bspwm.git

2. Change into the directory:

   cd kali-bspwm

3. Run the installation script:

   ./install.sh

   Ensure you have the required packages installed. The script will prompt you if anything is missing.

📂 Configuration Files

The repository includes configuration files for various applications, allowing for a seamless setup experience:

• BSPWM: Custom window management rules.
• SXHKD: Keybindings for efficient navigation and control.
• Polybar: Status bar configuration with modules for system monitoring.
• Kitty: Terminal settings for optimal use.
• Picom: Window compositor settings for smooth transitions.

You can find the specific configuration files in the config folder of the repository.

🛠️ Included Scripts and Tools

This setup comes with various scripts designed to enhance your experience:

• Startup Scripts: Automatically run essential applications on startup.
• Window Management Scripts: Control window behavior easily.
• Custom Commands: Tailor commands to fit your workflow.

Refer to the scripts folder for all available tools.

🖱️ Usage

Once everything is installed, simply log out and log back into your session. You should see the new BSPWM desktop environment. Here are a few basic commands to get you started:

• Open a terminal: Use Mod + Enter
• Open Rofi: Use Mod + d
• Close a window: Use Mod + Shift + q
• Switch between workspaces: Use Mod + {1,2,...}

✨ Customization

You can customize the configuration to suit your personal taste. Modify the configuration files found in the config directory:

• Change themes in Polybar.
• Adjust keybindings in SXHKD.
• Customize the appearance of your terminal in Kitty.

Adding New Features

Feel free to create new scripts or modify existing ones. Contributing to this repository is encouraged!

🤝 Contributing

We welcome contributions to the project. Here’s how you can help:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Submit a pull request.

Please ensure your code follows the project's structure and style for easy integration.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🔗 Links

For the latest updates and releases, visit the Releases Section.

Feel free to explore the features, modify the configuration, and make this setup your own. Happy computing!