A command-line tool for interacting with Wayfire.
Installation
To install wfctl, run:
pip install wfctl
Usage
To use wfctl, run:
wfctl <command>
list views List all views currently available.
list outputs List all outputs connected to the system.
switch workspace Switch to a specific workspace.
get focused output Get the currently focused output.
get focused view Get the currently focused view.
get focused workspace Get the currently focused workspace.
next workspace Switch to the next workspace.
fullscreen view Set a view fullscreen from a given id.
get view info Get information about a specific view using a given {view_id}.
resize view Resize a specific view, wfctl resize view {view_id} width height.
move view Move a specific view, wfctl move view {view_id} x-coordinate y-coordinate.
close view Close a view using a given {view_id}.
minimize view minimize a view, wfctl minimize view {view_id} {true/false}.
maximize Maximize a view from a given id.
set view alpha Set view transparency, wfctl set view alpha {view_id} {0.4}.
list input Lists all input devices currently available in the Wayfire environment
configure device Configure a device input from a give ID, wfctl configure device {device_id} {enable/disable}
get option Get wayfire config value from a given option, wfctl get option section/option
set options Set wayfire config value from the given options, wfctl set options section_1/option_1:value_1 section_2/option_2:value_2
get keyboard Retrieve the current keyboard layout, variant, model and options.
set keyboard Set the keyboard layout, variant, model and options.
-m watch wayfire events
Contributing
Contributions are welcome! Please open an issue or submit a pull request.
License
This project is licensed under the MIT License.
Metadata
Release files for wfctl 0.8.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| wfctl-0.8.8.tar.gz | 8.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| wfctl-0.8.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.3 kB
Release files / wfctl-0.8.8.tar.gz
| Download URL | wfctl-0.8.8.tar.gz |
|---|---|
| Size | 8.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0a5053ce143737795ca25cafff5db0040af260d1ab623a8e7a8f29004a8ebe1e
|
|
BLAKE2b-256 checksum How to use checksums |
68a679bd3988400c753424888be32df0d3c690499ef681e9dbc397f5bd6588d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 14, 2025.
Transparency logRelease files / wfctl-0.8.8-py3-none-any.whl
| Download URL | wfctl-0.8.8-py3-none-any.whl |
|---|---|
| Size | 9.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
82977ea63cf9aa0e0d1de48ae655ca7c8fa1da4849b5e02c6b3c099048b3479a
|
|
BLAKE2b-256 checksum How to use checksums |
eaadcea7255461c6be4f6f858ecc81ca26d0d46b881977fe54c31f479d12ffb7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 14, 2025.
Transparency log