Skip to content

KAPINTOM/my-qtile-config-file

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 

Repository files navigation

Qtile Window Manager Configuration

Welcome to my Qtile configuration repository! This repository contains my personal configuration files for the Qtile tiling window manager, a highly customizable and extensible window manager written in Python. Whether you're new to Qtile or an experienced user, feel free to explore, use, and modify these configurations to suit your needs.

Table of Contents


Introduction

Qtile is a dynamic, hackable tiling window manager written and configured in Python. This repository houses my personal Qtile configuration files, designed to provide a clean, efficient, and visually appealing desktop environment. The configuration is modular and easy to extend, making it a great starting point for your own setup.


Features

  • Custom Keybindings: Optimized keybindings for productivity and ease of use.
  • Theming: Includes a custom color scheme and styling for the bar and widgets.
  • Workspace Management: Predefined workspaces for better organization.
  • Integration with External Tools: Configurations for tools like rofi, dunst, picom, and more.
  • Autostart Scripts: Automatically launch essential applications and services on startup.
  • Modular Structure: Easy to customize and extend using Python.

Installation

Prerequisites

  • Qtile installed on your system.
  • Python 3.x installed.
  • Basic dependencies like rofi, dunst, and picom.

Steps

  1. Clone this repository to your local machine:
    git clone https://github.com/KAPINTOM/my-qtile-config-file.git ~/.config/qtile
  2. Backup your existing Qtile configuration (if any):
    mv ~/.config/qtile/config.py ~/.config/qtile/config.py.backup
  3. Copy the configuration files to your Qtile directory:
    cp -r ~/.config/qtile/* ~/.config/qtile/
  4. Restart Qtile to apply the new configuration:
    qtile cmd-obj -o cmd -f restart

Customization

This configuration is designed to be modular and easy to customize. Here are some tips:

  • Keybindings: Edit the ~/.config/qtile/config.py file to modify or add keybindings.
  • Theming: Adjust colors and styles in the ~/.config/qtile/theme.py file.
  • Autostart: Add or remove applications in the ~/.config/qtile/autostart.sh script.
  • Bar and Widgets: Customize the bar and widgets in the ~/.config/qtile/bars.py file.

Dependencies

This configuration relies on several external tools and utilities. Ensure you have the following installed:

  • Qtile: The window manager itself.
  • rofi: Application launcher.
  • dunst: Notification daemon.
  • picom: Compositor for transparency and shadows.
  • feh: Wallpaper manager.
  • nitrogen (optional): Alternative wallpaper manager.

Install them using your package manager:

sudo apt install qtile rofi dunst picom feh nitrogen
sudo pacman -Syu qtile rofi dunst picom feh nitrogen

Contributing

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.


License

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


Enjoy your Qtile experience! If you have any questions or need assistance, feel free to reach out.