Installation

This page describes how to install qtile-expanded.

Prerequisites

• Python 3.8 or higher

• libqtile 0.22.0 or higher

• pip (Python package manager)

Optional dependencies: - dbus-python for automatic notification tracking - FontAwesome font for icons

Install from PyPI

The recommended way to install qtile-expanded is from PyPI:

pip install qtile-expanded

Install from Source

You can also install from the source repository:

# Clone the repository
git clone https://g.arns.lt/zordsdavini/qtile-expanded.git
cd qtile-expanded

# Install in development mode (recommended for development)
pip install -e .

# Or install normally
pip install .

Development Installation

For development, install with all dependencies:

git clone https://g.arns.lt/zordsdavini/qtile-expanded.git
cd qtile-expanded

# Create virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Linux/Mac
# venv\Scripts\activate  # On Windows

# Install in development mode with test dependencies
pip install -e ".[dev]"

Verification

After installation, verify that the package can be imported:

import qtile_expanded
print(qtile_expanded.__version__)

You can also verify the installation by running the tests:

pytest --no-xephyr -v

Troubleshooting

ImportError: No module named ‘libqtile’

Make sure you have Qtile installed. You can install it with:

pip install libqtile

Permission denied when installing

Try using a virtual environment or add --user to the pip command:

pip install --user qtile-expanded

dbus-python not found

For DBus notification support, install the Python DBus bindings:

# On Debian/Ubuntu
sudo apt-get install python3-dbus
pip install dbus-python

# On Fedora/RHEL
sudo dnf install python3-dbus
pip install dbus-python

Uninstalling

To uninstall qtile-expanded:

pip uninstall qtile-expanded