Installation

Windows

A C++ compiler for C++ 2003 is needed. We recommend using the Desktop development with C++ workload for Microsoft C++ Build Tools 2022.

Additionally, we strongly recommend installing condynsate in a virtual environment:

C:\Users\username> python -m venv .venv
C:\Users\username> .venv\Scripts\activate.bat

When done installing and using condynsate, deactivate the virtual environment with:

(.venv) C:\Users\username> deactivate

From PyPi (Recommended)

python>=3.8 and pip are required.

To install condynsate:

(.venv) C:\Users\username> pip install condynsate

From Source

python>=3.8, pip, and git are required.

To clone the repository:

(.venv) C:\Users\username> git clone https://github.com/condynsate/condynsate.git
(.venv) C:\Users\username> cd condynsate

To install condynsate:

(.venv) C:\Users\username\condynsate> pip install -e .

macOS

From PyPi (Recommended)

Coming soon!

From Source

Coming soon!

Linux

We strongly recommend installing condynsate in a virtual environment:

user@device:~$ python3 -m venv .venv
user@device:~$ source .venv/bin/activate

On Debian/Ubuntu systems you may need to first install the python3-venv package. For Python 3.10 this can be installed with:

user@device:~$ sudo apt update
user@device:~$ sudo apt install python3.10-venv

When done installing and using condynsate, deactivate the virtual environment with:

(.venv) user@device:~$ deactivate

Additionally, On Debian/Ubuntu systems, to build condynsate you may need to first install the Python and Linux development headers. These can be installed with:

user@device:~$ sudo apt update
user@device:~$ sudo apt install build-essential python3-dev linux-headers-$(uname -r)

Finally, the package that provides keyboard interactivity uses X. This means that for keyboard interactivity to work

1. an X server must be running, and

2. the environment variable $DISPLAY must be set.

If these are not true, then keyboard interactivity will not work. All other features will work, though. For example, to use keyboard iteractivity on Ubuntu 22.04, you must first add

WaylandEnable=false

to /etc/gdm3/custom.conf and then either reboot your system or run the command

user@device:~$ systemctl restart gdm3

From PyPi (Recommended)

python>=3.8 and pip are required.

To install condynsate:

(.venv) user@device:~$ pip install condynsate

From Source

python>=3.8, pip, and git are required.

To clone the repository:

(.venv) user@device:~$ git clone https://github.com/condynsate/condynsate.git
(.venv) user@device:~$ cd condynsate

To install condynsate:

(.venv) user@device:~/condynsate$ pip install -e .