NOTE: This project is no longer actively maintained and has been archived. Thanks for all the fish! I might return to this in the future.
sara is a simple and lightweight dynamic window manager. What started out as an attempt to make catwm into a small and fully-functional window manager has turned into my primary project in C. At the moment, sara combines aspects of dwm and bspwm with some custom features. As my needs/wants change, so too will the program, and probably how much you like it.
If things like dwm-ipc scare the hell out of you because they're so big, this window manager might be for you. You want a window manager that works like a souped-up dwm with sane defaults that is also opinionated like all the cool kids. I think the combination of the tag system, the flexibility of sxhkd and IPC interaction, and the ease of parsing the window manager's internal state are good selling points.
- Tiling mode (master window with right-hand vertical stack).
- Monocle mode (fullscreen, but bar area still visible).
- Floating mode (clients freely set coordinates).
- Fullscreen mode (see Design Limitations).
- dwm-like:
- tags.
- Multihead support through Xinerama.
- patch-like:
- attachaside
- movestack
- pertag-like: layouts, master_size
- restartsig
- singularborders
- vanitygaps
- bspwm-like:
- IPC-based interaction via a client program,
sarasock
. - keyboard event handling via external program (like
sxhkd
).
- IPC-based interaction via a client program,
- output desktop information to the X server for external parsing (like with shell script +
lemonbar
/polybar
). - no window borders.
- no window titles.
- No support for urgency, because nothing I do is urgent.
- No support for iconified (i.e. "minimized") clients.
- No ICCCM. This is mostly felt in the lack of the applysizehints behavior that dwm has (ex. cmatrix won't redraw using larger window bounds if you give it more space via togglefs, changemsize, etc.).
- No EWMH support. Fullscreening is done manually (see examples/sxhkdrc).
man sara
If that doesn't answer your question, check out the wiki!
- v4.2 -
config.h
now supports running anything via shell script on startup like a traditionalrc
file: just add new lines to theconst char* progs[]
array inconfig.h
!sara
also now supports reloading this config file on-the-fly, without restarting, thanks to bringing in thedwm
approach to "adopting" unmanaged windows and much of therestartsig
patch (anything specified inprogs[]
will be re-run, FYI!). Andsarasock
no longer requires quoting all its arguments, though you can still do so! Updated directory structure for the repository so it's less messy. - v4.1 - Now sources a config file,
$XDG_CONFIG_HOME/sara/sararc
or$HOME/.config/sara/sararc
, which is a shell script that specifies programs to start ร labspwm
. My plan is to updatesarasock
to configure some variables at runtime in a similar fashion. Also including apolybar
script for tag information that has support for clickable areas. - v4.0 - A man page! Lots of """"bloat"""";
polybar
is now the suggested default! Huge shoutout to Jonas for the only post on his blog single-handedly making mypeachbar
problems obsolete. - v3.0 - Internal bar removed and bar scripts created. Floating layout. More Zoom-friendly client handling (nothing is sacred). Fixed longstanding math issues with
tile()
. - v2.0 - Keybinds are controlled by sxhkd now! A little bit of bspwm never hurt anyone. Pointer events (click into window, move and resize window) still handled internally.
- v1.0 - Finished it enough to share with the class. At this stage, very like dwm with some patches (see above) built-in, some cleaned-up code (and some not), some cut corners (not as much support for Atoms), but all is well and functional.
- Reinitializing monitors should update focus to a client and reset enternotify status.
- Sometimes after using physlock + betterlockscreen, clients need a redraw and don't do it until toggled/moved around.
- Can't round corners on some clients like
chromium
.
- Fix bugs.
- External pointer management: can
sxhkd
reasonably do this? - Partial standards compliance so things like
rofi -m -4
works. - Convert to XCB, starting with where it will improve performance.
Please submit bug reports! I've only tested this on my own system.