# workbench
[![crates.io](https://img.shields.io/crates/v/workbench.svg)](https://crates.io/crates/workbench)
[![docs](https://docs.rs/workbench/badge.svg)](https://docs.rs/workbench)
[![ci pipeline](https://img.shields.io/gitlab/pipeline/agausmann/workbench.svg)](https://gitlab.com/agausmann/workbench/pipelines)
[![downloads](https://img.shields.io/crates/d/workbench.svg)](https://crates.io/crates/workbench)
[![GPL-3.0](https://img.shields.io/crates/l/workbench.svg)](https://www.gnu.org/licenses/gpl.html#content)
A simple tiling window manager using Rust and Wayland.
## Alternatives
Though there are a couple of similar alternatives currently available, I've
found that each one fails to satisfy my personal requirements in some way,
usually because of a lack of quality/standards that made it unusable or
difficult to pick up as a new user.
Please be aware that some of my experiences with their quality may be outdated
and no longer accurate, especially since they were in an unstable/prerelease
state when I checked them out.I strongly suggest that you consider them before
trying workbench - they are certainly more popular and have larger communities
supporting them.
- **Sway** - an i3-compatible tiling compositor for Wayland, written in C.
- Some functionality does not work as expected, in particular, title bars
inside of tabbed/stacked panes were very broken when I tried it out.
- Possible memory leaks or other memory management issues - I recall seeing
errors like "use after free" in the log output.
- **Way Cooler** - A Lua-configurable tiling compositor for Wayland, written in
Rust.
- The build system is very complex and involves GNU Make and other tools
outside of the Rust/Cargo environment, and system dependencies are not
well-documented. This inhibited my ability to compile and run it myself, and
I encountered many errors that I had to resolve without official support
or documentation. This was a nightmare on Gentoo, and I gave up.
- May also have some behavioral issues or bugs, but none that I can
specifically remember.
## License
Copyright (C) 2018 Adam Gausmann
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.