A minimal tiling window manager for X11.
- Xlib, Xinerama and Xrandr header files
- a standard C compiler
make
makepkg -sicmake
sudo make install
make cleanby default, the binary is installed to /usr/bin/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.
i strongly recommend using jotawm alongside jotacomp
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 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).
- 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
add the following line to your ~/.xinitrc to start jotawm-session using startx:
exec jotawm-sessionjotawm 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.).
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.
toggled on individual windows with Mod + w, it makes the selected window appear as a floating, draggable and resizable window.
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.
in this mode, windows are floating in a scrollable 2d canvas.
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).
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 1a rescan that finds nothing changed is a no-op.
this is software that i personally recommend to use alongside jotawm
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.
BSD-3 CLAUSE