Skip to main content

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)

Source distribution for wfctl 0.8.8
File Size Uploaded
wfctl-0.8.8.tar.gz 8.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for wfctl 0.8.8
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

0.8.8 This release

2 release files

0.8.4

2 release files

0.8.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page