Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Kintaro/wtftw

Window Tiling For The Win. A tiling window manager written in Rust
https://github.com/Kintaro/wtftw

Last synced: 15 days ago
JSON representation

Window Tiling For The Win. A tiling window manager written in Rust

Host: GitHub
URL: https://github.com/Kintaro/wtftw
Owner: Kintaro
License: bsd-3-clause
Created: 2014-11-01T17:54:09.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2021-04-28T21:56:57.000Z (over 3 years ago)
Last Synced: 2024-10-16T12:21:22.607Z (23 days ago)
Language: Rust
Size: 19.8 MB
Stars: 2,383
Watchers: 60
Forks: 84
Open Issues: 23
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-repositories - Kintaro/wtftw - Window Tiling For The Win. A tiling window manager written in Rust (Rust)
awesome-starred - Kintaro/wtftw - Window Tiling For The Win. A tiling window manager written in Rust (others)

README

wtftw
=====

Window Tiling For The Win. A tiling window manager written in Rust

![Screenshot](https://i.imgur.com/8KzbKB9.jpg)

## Status
[![Build Status](https://travis-ci.org/Kintaro/wtftw.svg?branch=master)](https://travis-ci.org/Kintaro/wtftw)
[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/Kintaro/wtftw?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Issue Stats](http://www.issuestats.com/github/Kintaro/wtftw/badge/pr?style=flat)](http://www.issuestats.com/github/Kintaro/wtftw)
[![Issue Stats](http://www.issuestats.com/github/Kintaro/wtftw/badge/issue?style=flat)](http://www.issuestats.com/github/Kintaro/wtftw)

## Build

**Notice:** Wtftw is compiled against Rust1.2.0+, so make sure to have a recent enough *rustc*.

To build it, just run

```
cargo build
```

### Common build issues
On OSX, you might get a linker error when linking against X11 or Xinerama. For example:

```
ld: library not found for -lXinerama
```

You need to install XQuartz to get the X11 libraries, and make sure that they are found. Then just run

```
LIBRARY_PATH=/opt/X11/lib cargo build
```

On Ubuntu if you have this issue, simply install libxinerama-dev and restart cargo build

```
sudo apt-get install libxinerama-dev
```

## Testing

If you want to have your own custom config, create one in *~/.wtftw/src/config.rs*.
You can find an example config in *config/config.rs* in this repository.

For testing, install either **Xnest** or **Xephyr** on your system and run

```
Xephyr -screen 800x600 :1 &
DISPLAY=:1 ./target/release/wtftw &
DISPLAY=:1 thunar & (or whatever application you want to run)
```

or respectively

```
Xnest -geometry 800x600+0+0 :1 &
DISPLAY=:1 ./target/release/wtftw &
DISPLAY=:1 thunar &
```

## Installation

Compile it normally with **cargo build --release**, and then either use it with your .xinitrc
or your favorite display manager. If you want to configure it, take a look at the example config in
*config/*.

After the first start, the config needs to be placed in *~/.wtftw/src/config.rs*. Voila.

## Commands

In a default setting, the commands are hardcoded, but can be changed in your own config.

### Switch workspace
```
ALT+num
```

### Open terminal
```
ALT+SHIFT+Enter
```

## Additional layouts and other extensions

To keep wtftw as small and lean as possible, all layouts (except the standard one) have been moved to
[wtftw-contrib](https://github.com/Kintaro/wtftw-contrib)

## FAQ

#### Does it work with dual monitors?

Yes, yes it does. Just use xrandr and you're set. Wtftw will automatically detect the changed setup. It works with as many monitors as your xrandr and xinerama can handle.

#### What are the alternatives to xmobar?

Dzen

#### What font and programs are you using on the screenshot?

The font is Envy Code R, and the programs are xmobar, vim, htop, screenfetch, weechat and ncmpcpp.

#### Why should I use wtftw than dwm or even awesome?

That is more of a personal choice. Wtftw is akin to xmonad. You can do almost anything you want with the config file. Extend it, change it at runtime, your only boundary is the rust language itself. Plus, using it would help a Rust project to detect bugs and improve it.

## Tutorial

I will be making a tutorial series on how to write a window manager. A bit busy with my thesis
at the moment, but the first part is [here](https://kintaro.github.io/rust/window-manager-in-rust-01/)