Installation

Requirements

ThreePaneWindows requires Python 3.8 or later and works with the following operating systems:

The package has minimal dependencies:

The easiest way to install ThreePaneWindows is using pip:

pip install threepanewindows

This will install the latest stable version from PyPI.

To install the latest development version from GitHub:

pip install git+https://github.com/yourusername/threepanewindows.git

If you want to contribute to ThreePaneWindows or modify the source code:

git clone https://github.com/yourusername/threepanewindows.git
cd threepanewindows
pip install -e .[dev]

This installs the package in “editable” mode with development dependencies.

To verify that ThreePaneWindows is installed correctly:

import threepanewindows
print(threepanewindows.__version__)

Or run the built-in examples:

python -m threepanewindows.examples

ImportError: No module named ‘tkinter’

On some Linux distributions, tkinter is not installed by default:

# Ubuntu/Debian
sudo apt-get install python3-tk

# CentOS/RHEL/Fedora
sudo yum install tkinter
# or
sudo dnf install python3-tkinter

Display Issues on Linux

If you’re running on a headless Linux server or in a container, you may need to set up a virtual display:

sudo apt-get install xvfb
export DISPLAY=:99
Xvfb :99 -screen 0 1024x768x24 &

Permission Issues

If you encounter permission errors during installation:

pip install --user threepanewindows

This installs the package for the current user only.

If you encounter issues not covered here: