Skip to content
JotaleaPublic
forked from 173duprot/wm

About

minimal X11 Tiling WM for Linux

Resources

Stars

41 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

jotawm

A minimal tiling window manager for X11.

showcase

dependencies

  • Xlib, Xinerama and Xrandr header files
  • a standard C compiler
  • make

installation

arch linux

makepkg -sic

other linux

make
sudo make install
make clean

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

hardware requirements

jotawm

jotawm itself requires at least 3 megabytes of memory to function, 16 megabytes being my recommendation. add the requirements to run an X session (roughly 80 megabytes of memory, and the minimum approximates 128 megabytes.

jotacomp

i strongly recommend using jotawm alongside jotacomp

jotarchy

the entire jotarchy desktop, with a status bar, the jotacompositor, this window manager, and a few other things, requires at least 300 megabytes to function. for graphic effects, a graphics card or integrated GPU with support for at least OpenGL 3 is required. more info on the jotarchy website

configuration

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

to modify the modifier key, default terminal, or keybinds, edit the variables in the jotawm.h 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 rofi. make sure these are installed or edit the termcmd and menucmd arrays to match your preferred software.

monitors are detected via Xinerama at startup and re-detected whenever RandR reports a change, so plugging a display in (or adding a virtual one with xrandr --setmonitor) is picked up live. a monitor that disappears hands its windows to the nearest remaining one. MAXMONITOR in jotawm.h caps how many outputs are tracked, and BAR_MONITOR picks which one reserves space for a status bar (an index, or -1 for every monitor).

keybinds

  • Mod + t : spawn terminal
  • Mod + e : spawn file explorer
  • Mod + b : spawn web browser
  • Mod + Space : spawn application menu
  • Mod + comma : show this keybind cheat-sheet
  • Mod + kLeft / kRight : focus next / previous window
  • Mod + Shift + kLeft / kRight : move focused window left / right
  • Mod + Alt + kLeft / kRight : shrink / expand the focused window
  • 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
  • Mod + s : take a fullscreen screenshot and copy it to the clipboard
  • Mod + Shift + s : take a screenshot of a selection and copy it to the clipboard
  • PrntScr : take a fullscreen screenshot and save it to ~/Pictures/
  • Mod + v : toggle split direction (horizontal/vertical)
  • Mod + w : toggle floating state for the focused window
  • Mod + Shift + w : open the wallpaper picker
  • Mod + m : toggle macOS stage manager
  • Mod + g : toggle canvas mode for the current workspace
  • Mod + Ctrl + left click drag : move around the canvas
  • Mod + LMB drag : move window around the canvas
  • Mod + RMB drag : resize window in floating and canvas mode
  • Mod + held drag near a screen edge : scroll the canvas while carrying a dragged file or selection
  • Mod + scroll : focus next / previous window
  • Mod + Ctrl + scroll : switch to next / previous workspace
  • Mod + PgUp / PgDown : switch to previous / next workspace
  • Mod + Alt + comma / period : move focus to the previous / next monitor
  • Mod + Shift + comma / period : move the focused window to the previous / next monitor
  • Mod + Shift + m : re-read the monitor layout (see multiple monitors)
  • XF86AudioRaiseVolume / LowerVolume : increase / decrease volume (pactl)
  • XF86MonBrightnessUp / Down : increase / decrease brightness

running

xinitrc

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

exec jotawm-session

display managers

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.).

modes

tiling mode

this is the standard for jotawm, the windows appear tiled one alongside the other. they appear in a binary tree structure, following the position of the mouse cursor, making a quite satisfactory effect.

floating mode

toggled on individual windows with Mod + w, it makes the selected window appear as a floating, draggable and resizable window.

stage manager

this mode is similar to a master-stack layout, where a main focused window will appear in the center and the other windows will appear stacked at the left. click on an unfocused window to switch it from stack to master.

canvas mode

in this mode, windows are floating in a scrollable 2d canvas.

multiple monitors

each monitor keeps its own tiling tree per workspace. switching workspaces (Mod + [1-9], Mod + PgUp/PgDown) changes what every monitor shows at once, since a workspace number is shared across all of them -- but each monitor's content for that workspace is independent, the same way Windows' virtual desktops work when a display isn't set to "show windows on all displays".

after a workspace switch, keyboard focus goes to whatever is under the cursor; if there's nothing there, it goes to the nearest window, even on another monitor; if there's nothing anywhere, nothing is focused. the cursor itself never moves on a workspace switch -- only Mod + Alt + comma/period warps it, since it also has to hand focus to a different monitor.

dragging a floating window across a monitor's edge reassigns it to that monitor once you let go of it (canvas mode is the exception: each monitor's canvas is its own independent coordinate space, so a canvas window can't currently be dragged across monitors -- send it with Mod + Shift + comma/period instead).

hotplug

plugging a display in or out is picked up live through RandR. a monitor whose rectangle is unchanged keeps its trees and layout modes; the windows of one that disappeared (or changed resolution) are re-tiled onto the nearest remaining monitor.

the X server emits no event for virtual monitors (xrandr --setmonitor / --delmonitor), so after creating one -- say, a 1200x800 region to stream to a tablet over VNC -- tell jotawm to look again, either with Mod + Shift + m or, from the script that sets the monitor up, by touching a root window property:

xrandr --fb 3120x1080
xrandr --setmonitor TABLET 1200/200x800/130+1920+0 none
xprop -root -f _JOTAWM_RESCAN 32c -set _JOTAWM_RESCAN 1

a rescan that finds nothing changed is a no-op.

recommended software

this is software that i personally recommend to use alongside jotawm

ownership

jotawm is a fork of 173duprot/wm. the original author has explicitly encouraged me to refer to this project as my own in casual and social contexts. this is their intended way for their software to be used. formal attribution is preserved in the license below and in the repository metadata.

license

BSD-3 CLAUSE

About

minimal X11 Tiling WM for Linux

Resources

Stars

41 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages