2wm — two-bit Window Manager

2wm is a tiny X11 window manager inspired by tinywm and 1wm, designed to provide a minimalistic graphical experience.

Usage

Unlike traditional window managers, 2wm is primarily intended to be used as a prefix command to launch a specific X11 application within its own X server session. For example:

2wm firefox

This command will:

1. Start a new X server instance running 2wm.
2. Launch Firefox inside that X server.
3. Stop the X server automatically when Firefox exits.

Alternatively, you can start 2wm standalone by running:

2wm

and launch applications inside it as you normally would (eg, DISPLAY=:0 firefox &).

The following shortcuts can be used with 2wm:

Shortcut	Action
Meta + 🖱️ click	Focus and raise the window under the cursor
Meta + 🖱️ click-and-drag	Move the window by dragging
Meta Shift + 🖱️ click-and-drag	Resize the window by dragging
Meta + Tab	Cycle (focus and raise) through all open windows
Meta + F	Resize the window to full-screen
Meta + K	Close (kill) the window under the cursor
Meta + Q	Quit 2wm and stop the X server

Installation

Binary

Ubuntu:

sudo add-apt-repository ppa:ppa-verse/dev
sudo apt install 2wm

Debian:

p=2wm v=0.1
wget https://github.com/dimitry-ishenko-cpp/${p}/releases/download/${v}/${p}_${v}_amd64.deb
sudo apt install ./${p}_${v}_amd64.deb

RaspberryPi:

p=2wm v=0.1
wget https://github.com/dimitry-ishenko-cpp/${p}/releases/download/${v}/${p}_${v}_arm64.deb
sudo apt install ./${p}_${v}_arm64.deb

From source

Stable version (requires CMake >= 3.16, libx11-dev, libxrandr-dev and pkgconf):

p=2wm v=0.1
wget https://github.com/dimitry-ishenko-cpp/${p}/archive/v${v}.tar.gz
tar xzf v${v}.tar.gz
mkdir ${p}-${v}/build
cd ${p}-${v}/build
cmake ..
make
sudo make install

Latest master (requires git, CMake >= 3.16, libx11-dev, libxrandr-dev and pkgconf):

p=2wm
git clone --recursive https://github.com/dimitry-ishenko-cpp/${p}.git
mkdir ${p}/build
cd ${p}/build
cmake ..
make
sudo make install

Authors

• Dimitry Ishenko - dimitry (dot) ishenko (at) (gee) mail (dot) com

License

This project is distributed under the GNU GPL license. See the LICENSE.md file for details.