# Wmctrl Wrapper 
A wrapper for the command line tool wmctrl written in Rust

## Dependencies

[wmctrl](https://www.freedesktop.org/wiki/Software/wmctrl/) needs to be installed: 

```shell
# Ubuntu
sudo apt install wmctrl

# Arch Linux
sudo pacman -S wmctrl

# Fedora 
dnf install -y wmctrl

# You get the idea
```

## Usage

Add `wmctrl` to your dependencies in your `Cargo.toml`:

```toml
[dependencies]
wmctrl = "0.1.7"
```

If you want the latest build use the GitHub repository as your uplink:
```toml
[dependencies]
wmctrl = { git = "https://github.com/Treborium/rust-wmctrl" }
```

## Examples

Please refer to the [documentation](https://docs.rs/wmctrl/latest/wmctrl/) for detailed information. 

If you want to copy & paste the examples below you _need to use_ the following import statement: 

```Rust
use wmctrl::{Self, Window};
```

Find a window based on the title:

```Rust
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:

``` Rust
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:

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

Make the window fullscreen: 

```Rust
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));
```