Here’s a comprehensive README.md
file tailored for the repository you provided, which contains i3 window manager configuration files:
Welcome to my i3 window manager configuration repository! This repository contains my personal configuration files for the i3 tiling window manager, along with additional scripts, themes, and resources to enhance your i3 experience.
i3 is a lightweight, highly customizable tiling window manager for Linux. This repository houses my personal i3 configuration files, which are designed to provide a clean, efficient, and visually appealing desktop environment. Whether you're new to i3 or an experienced user, feel free to explore, use, and modify these configurations to suit your needs.
- Custom Keybindings: Optimized keybindings for productivity and ease of use.
- Theming: Includes a custom color scheme and styling for i3bar and applications.
- Workspace Management: Predefined workspaces for better organization.
- Integration with External Tools: Configurations for tools like
rofi
,polybar
,picom
, and more. - Autostart Scripts: Automatically launch essential applications and services on startup.
- Modular Structure: Easy to customize and extend.
- i3 window manager installed on your system.
- Basic dependencies like
dmenu
,i3status
, andfeh
(for wallpaper).
- Clone this repository to your local machine:
git clone https://github.com/KAPINTOM/i3-wm-config-files.git ~/.config/i3
- Backup your existing i3 configuration (if any):
mv ~/.config/i3/config ~/.config/i3/config.backup
- Copy the configuration files to your i3 directory:
cp -r ~/.config/i3/* ~/.config/i3/
- Restart i3 to apply the new configuration:
i3-msg restart
This configuration is designed to be modular and easy to customize. Here are some tips:
- Keybindings: Edit the
~/.config/i3/config
file to modify or add keybindings. - Theming: Adjust colors and styles in the
~/.config/i3/theme
file. - Autostart: Add or remove applications in the
~/.config/i3/autostart
script. - i3bar: Customize the status bar in the
~/.config/i3/i3status.conf
file.
This configuration relies on several external tools and utilities. Ensure you have the following installed:
- i3: The window manager itself.
- i3status: Status bar for i3.
- rofi: Application launcher.
- picom: Compositor for transparency and shadows.
- feh: Wallpaper manager.
- polybar (optional): Alternative status bar.
- nitrogen (optional): Alternative wallpaper manager.
Install them using your package manager:
sudo apt install i3 i3status rofi picom feh polybar nitrogen
Contributions are welcome! If you have suggestions, improvements, or bug fixes, feel free to open an issue or submit a pull request. Please ensure your changes align with the overall design and functionality of the configuration.
This project is licensed under the MIT License. See the LICENSE file for details.
Enjoy your i3 experience! If you have any questions or need assistance, feel free to reach out.