The [Wayfire] compositor provides access to its functionalities via Inter-Process Communication (IPC). This repository contains the source code for the python client bindings, as well as hosts many examples of how to use the IPC.

pip install wayfire

OR

git clone https://github.com/WayfireWM/pywayfire
cd pywayfire
python3 -m pip install .

Basic usage is simple, import the wayfire.ipc module, create a socket (it will auto-detect the compositor by using the WAYFIRE_SOCKET environment variable) and call its functions:

from wayfire import WayfireSocket

socket = WayfireSocket()
print(socket.list_views())

Many examples can be found in the scripts directory.