6 releases

0.1.8 Jan 26, 2021
0.1.7 Feb 20, 2020
0.1.6 Jan 31, 2020

#434 in Unix APIs

Download history 1/week @ 2024-03-12 2/week @ 2024-03-26 22/week @ 2024-04-02

56 downloads per month


288 lines

Wmctrl Wrapper

A wrapper for the command line tool wmctrl written in Rust


wmctrl needs to be installed:

# Ubuntu
sudo apt install wmctrl

# Arch Linux
sudo pacman -S wmctrl

# Fedora 
dnf install -y wmctrl

# You get the idea


Add wmctrl to your dependencies in your Cargo.toml:

wmctrl = "0.1.7"

If you want the latest build use the GitHub repository as your uplink:

wmctrl = { git = "https://github.com/Treborium/rust-wmctrl" }


Please refer to the documentation for detailed information.

If you want to copy & paste the examples below you need to use the following import statement:

use wmctrl::{Self, Window};

Find a window based on the title:

let windows = wmctrl::get_windows();
let firefox = wmctrl::utils::find_window_by_title(&windows, "Firefox").unwrap();
println!("{}", firefox);

Resize and move a window to the specified coordinates:

let mut windows = wmctrl::get_windows();
let win = &mut windows[0];
// This will move the window to the top left corner and resize it to 960x540
win.transform(wmctrl::Transformation::new(0, 0, 960, 540));

Close the window gracefully:

// We need to move the window out of the vector so there is no reference left
let win: Window = wmctrl::get_windows().remove(0);

Make the window fullscreen:

let windows = wmctrl::get_windows();
let win = &windows[0];
// Make the window fullscreen
win.change_state(wmctrl::State::new(wmctrl::Action::Add, wmctrl::Property::Fullscreen));


~53K SLoC