Skip to content

Jotalea/jotawm

 
 

Repository files navigation

jotawm

A minimal tiling window manager for X11.

Showcase

Dependencies

  • Xlib header files
  • A standard C compiler
  • make

Installation

make
sudo make install

By default, the binary is installed to /usr/bin/jotawm.

Configuration

Configuration is performed entirely at compile time by editing jotawm.h.

To modify the modifier key, default terminal, or keybindings, edit the Configuration block at the top of the source file. Recompile and restart jotawm to apply changes.

The default modifier key (Mod) is set to Mod4Mask (Super/Windows key).

The default terminal is kitty, and the default menu is dmenu_run. Ensure these are installed or edit the termcmd and menucmd arrays to match your preferred software.

Usage

  • Mod + t : Spawn terminal
  • Mod + Space : Spawn application menu
  • Mod + kLeft / kRight : Focus next / previous window
  • Mod + Shit + kLeft / kRight : Move focused window left / right
  • Mod + Alt + kLeft / kRight : Shrink / expand the master area
  • Mod + f : Toggle fullscreen for the focused window
  • Mod + q : Kill the focused window
  • Mod + Shift + q : Quit wm
  • Mod + [1-9] : Switch to workspace N
  • Mod + Shift + [1-9]: Move focused window to workspace N

Running

xinitrc

Add the following line to your ~/.xinitrc to start jotawm-session using startx:

exec jotawm-session

Display Manager

jotawm installs a desktop file to /usr/share/xsessions/jotawm.desktop, so it should appear as an option in most display managers (Ly, GDM, LightDM, SDDM, etc.).

Recommended software

this is software that i personally recommend to use alongside jotawm

License

MIT

About

minimal X11 Tiling WM for Linux

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • C 95.3%
  • Nix 2.5%
  • Makefile 2.2%