add window swallowing

the user can now specify which windows can swallow / can be swallowed.

7 files changed, 435 insertions, 67 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b8d5d86..320b2a5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,7 @@ All notable changes to this project will be documented in this file.
 - **NEW**: Can switch monitors via keyboard
 - **NEW**: Can move windows between monitors via keyboard
 - **NEW**: Can click on a window to set focus to it
+- **NEW**: Window swallowing
 - **CHANGE**: Renamed `focus_previous` to `focus_prev`
 - **CHANGE**: Invalid sample config
 - **CHANGE**: Parser `$HOME` searching order. XDG Compliance
diff --git a/README.md b/README.md
index 63830cf..2905b04 100644
--- a/README.md
+++ b/README.md
@@ -81,6 +81,9 @@ The file uses a `key : value` format. Lines starting with `#` are ignored.
 | `should_float`           | String  | `"st"`    | Always-float rule. Multiple entries should be comma-seperated. Optionally, entries can be enclosed in quotes.|
 | `new_win_focus`          | Bool    | `true`    | Whether openening new windows should also set focus to them or keep on current window.|
 | `warp_cursor`            | Bool    | `true`    | Warp the cursor to the middle of newly focused windows                      |
+| `exec`                   | String  | `Nothing` | Command to run on startup (e.g., `sxbar`, `picom`, "autostart", etc.).      |
+| `can_swallow`            | String  | `st`      | Windows that can swallow.                                                   |
+| `can_be_swallowed`       | String  | `mpv`     | Windows that can be swallowed.                                              |
 
 ---
 
diff --git a/default_sxwmrc b/default_sxwmrc
index 541afab..78ff91e 100644
--- a/default_sxwmrc
+++ b/default_sxwmrc
@@ -14,6 +14,8 @@ motion_throttle         : 60 # Set to screen refresh rate for smoothest motions
 should_float            : "pcmanfm"
 new_win_focus           : true
 warp_cursor             : true
+can_swallow             : "st"
+can_be_swallowed        : "mpv"
 
 # Keybinds:
 # Commands must be surrounded with ""
diff --git a/src/defs.h b/src/defs.h
index 74af271..77fa0b2 100644
--- a/src/defs.h
+++ b/src/defs.h
@@ -1,13 +1,13 @@
 /* See LICENSE for more information on use */
 #pragma once
 #include <X11/Xlib.h>
-#define SXWM_VERSION	"sxwm ver. 1.6"
-#define SXWM_AUTHOR		"(C) Abhinav Prasai 2025"
-#define SXWM_LICINFO	"See LICENSE for more info"
+#define SXWM_VERSION "sxwm ver. 1.6"
+#define SXWM_AUTHOR "(C) Abhinav Prasai 2025"
+#define SXWM_LICINFO "See LICENSE for more info"
 
-#define ALT		Mod1Mask
-#define SUPER	Mod4Mask
-#define SHIFT	ShiftMask
+#define ALT Mod1Mask
+#define SUPER Mod4Mask
+#define SHIFT ShiftMask
 
 #define MARGIN (gaps + BORDER_WIDTH)
 #define OUT_IN (2 * BORDER_WIDTH)
@@ -17,18 +17,17 @@
 #define MAX(a, b) ((a) > (b) ? (a) : (b))
 #define MIN(a, b) ((a) < (b) ? (a) : (b))
 #define LENGTH(X) (sizeof X / sizeof X[0])
-#define UDIST(a,b) abs((int)(a) - (int)(b))
-#define CLAMP(x, lo, hi) (( (x) < (lo) ) ? (lo) : ( (x) > (hi) ) ? (hi) : (x))
-#define MAXCLIENTS	99
-#define BIND(mod, key, cmdstr) { (mod), XK_##key, { cmdstr }, False }
-#define CALL(mod, key, fnptr) { (mod), XK_##key, { .fn = fnptr }, True }
-#define CMD(name, ...) 						\
-	const char *name[] = { __VA_ARGS__, NULL }
+#define UDIST(a, b) abs((int)(a) - (int)(b))
+#define CLAMP(x, lo, hi) (((x) < (lo)) ? (lo) : ((x) > (hi)) ? (hi) : (x))
+#define MAXCLIENTS 99
+#define BIND(mod, key, cmdstr) {(mod), XK_##key, {cmdstr}, False}
+#define CALL(mod, key, fnptr) {(mod), XK_##key, {.fn = fnptr}, True}
+#define CMD(name, ...) const char *name[] = {__VA_ARGS__, NULL}
 
-#define TYPE_CWKSP	0
-#define TYPE_MWKSP	1
-#define TYPE_FUNC	2
-#define TYPE_CMD	3
+#define TYPE_CWKSP 0
+#define TYPE_MWKSP 1
+#define TYPE_FUNC 2
+#define TYPE_CMD 3
 
 #define NUM_WORKSPACES		9
 #define WORKSPACE_NAMES		\
@@ -40,14 +39,9 @@
 	"6"					"\0"\
 	"7"					"\0"\
 	"8"					"\0"\
-	"9"					"\0"\
+	"9"					"\0"
 
-typedef enum {
-	DRAG_NONE,
-	DRAG_MOVE,
-	DRAG_RESIZE,
-	DRAG_SWAP
-} DragMode;
+typedef enum { DRAG_NONE, DRAG_MOVE, DRAG_RESIZE, DRAG_SWAP } DragMode;
 
 typedef void (*EventHandler)(XEvent *);
 
@@ -64,7 +58,7 @@ typedef struct {
 	int type;
 } Binding;
 
-typedef struct Client{
+typedef struct Client {
 	Window win;
 	int x, y, h, w;
 	int orig_x, orig_y, orig_w, orig_h;
@@ -75,7 +69,10 @@ typedef struct Client{
 	Bool floating;
 	Bool fullscreen;
 	Bool mapped;
+	pid_t pid;
 	struct Client *next;
+	struct Client *swallowed;
+	struct Client *swallower;
 } Client;
 
 typedef struct {
@@ -95,7 +92,9 @@ typedef struct {
 	Bool warp_cursor;
 	Binding binds[256];
 	char **should_float[256];
-    char *torun[256];
+	char **can_swallow[256];
+	char **can_be_swallowed[256];
+	char *torun[256];
 } Config;
 
 typedef struct {
diff --git a/src/parser.c b/src/parser.c
index 3fc2856..315013d 100644
--- a/src/parser.c
+++ b/src/parser.c
@@ -1,6 +1,6 @@
 #define _POSIX_C_SOURCE 200809L
 #include <ctype.h>
-#include <limits.h>
+#include <linux/limits.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -404,6 +404,41 @@ found:
 			}
 			torun++;
 		}
+		else if (!strcmp(key, "can_swallow")) {
+			char *token = strtok(rest, ",");
+			int i = 0;
+			while (token && i < 256) {
+				char *item = strip_quotes(strip(token));
+				if (*item) {
+					cfg->can_swallow[i] = malloc(2 * sizeof(char *));
+					if (!cfg->can_swallow[i]) {
+						fprintf(stderr, "sxwmrc:%d: malloc failed\n", lineno);
+						break;
+					}
+					cfg->can_swallow[i][0] = strdup(item);
+					cfg->can_swallow[i][1] = NULL;
+					i++;
+				}
+				token = strtok(NULL, ",");
+			}
+		}
+		else if (!strcmp(key, "can_be_swallowed")) {
+			char *token = strtok(rest, ",");
+			int i = 0;
+			while (token && i < 256) {
+				char *item = strip_quotes(strip(token));
+				if (*item) {
+					cfg->can_be_swallowed[i] = malloc(2 * sizeof(char *));
+					if (!cfg->can_be_swallowed[i]) {
+						break;
+					}
+					cfg->can_be_swallowed[i][0] = strdup(item);
+					cfg->can_be_swallowed[i][1] = NULL;
+					i++;
+				}
+				token = strtok(NULL, ",");
+			}
+		}
 		else {
 			fprintf(stderr, "sxwmrc:%d: unknown option '%s'\n", lineno, key);
 		}
diff --git a/src/sxwm.c b/src/sxwm.c
index 8c5bb5d..bbc2f12 100644
--- a/src/sxwm.c
+++ b/src/sxwm.c
@@ -17,10 +17,11 @@
 #include <X11/X.h>
 #include <err.h>
 #include <stdio.h>
-#include <limits.h>
+#include <linux/limits.h>
 #include <signal.h>
 #include <stdlib.h>
 #include <string.h>
+#include <strings.h>
 #include <sys/wait.h>
 #include <unistd.h>
 
@@ -47,6 +48,7 @@ Window find_toplevel(Window w);
 /* void focus_next(void); */
 /* void focus_prev(void); */
 int get_monitor_for(Client *c);
+pid_t get_pid(Window w);
 void grab_keys(void);
 void hdl_button(XEvent *xev);
 void hdl_button_release(XEvent *xev);
@@ -62,6 +64,7 @@ void hdl_root_property(XEvent *xev);
 void hdl_unmap_ntf(XEvent *xev);
 /* void inc_gaps(void); */
 void init_defaults(void);
+Bool is_child_proc(pid_t pid1, pid_t pid2);
 /* void move_master_next(void); */
 /* void move_master_prev(void); */
 void move_to_workspace(int ws);
@@ -82,11 +85,13 @@ void setup_atoms(void);
 int snap_coordinate(int pos, int size, int screen_size, int snap_dist);
 void spawn(const char **argv);
 void startup_exec(void);
+void swallow_window(Client *swallower, Client *swallowed);
 void swap_clients(Client *a, Client *b);
 void tile(void);
 /* void toggle_floating(void); */
 /* void toggle_floating_global(void); */
 /* void toggle_fullscreen(void); */
+void unswallow_window(Client *c);
 void update_borders(void);
 void update_client_desktop_properties(void);
 void update_monitors(void);
@@ -162,6 +167,9 @@ Client *add_client(Window w, int ws)
 	c->win = w;
 	c->next = NULL;
 	c->ws = ws;
+	c->pid = get_pid(w);
+	c->swallowed = NULL;
+	c->swallower = NULL;
 
 	if (!workspaces[ws]) {
 		workspaces[ws] = c;
@@ -621,6 +629,26 @@ int get_monitor_for(Client *c)
 	return 0;
 }
 
+pid_t get_pid(Window w)
+{
+	pid_t pid = 0;
+	Atom actual_type;
+	int actual_format;
+	unsigned long nitems, bytes_after;
+	unsigned char *prop = NULL;
+	Atom atom_pid = XInternAtom(dpy, "_NET_WM_PID", False);
+
+	if (XGetWindowProperty(dpy, w, atom_pid, 0, 1, False, XA_CARDINAL, &actual_type, &actual_format, &nitems,
+	                       &bytes_after, &prop) == Success &&
+	    prop) {
+		if (actual_format == 32 && nitems == 1) {
+			pid = *(pid_t *)prop;
+		}
+		XFree(prop);
+	}
+	return pid;
+}
+
 void grab_keys(void)
 {
 	const int guards[] = {0,
@@ -831,6 +859,21 @@ void hdl_destroy_ntf(XEvent *xev)
 			c = c->next;
 		}
 		if (c) {
+			if (c->swallower) {
+				unswallow_window(c);
+			}
+
+			if (c->swallowed) {
+				Client *swallowed = c->swallowed;
+				c->swallowed = NULL;
+				swallowed->swallower = NULL;
+
+				/* show swallowed window */
+				XMapWindow(dpy, swallowed->win);
+				swallowed->mapped = True;
+				focused = swallowed;
+			}
+
 			if (focused == c) {
 				if (c->next) {
 					focused = c->next;
@@ -902,6 +945,31 @@ void hdl_keypress(XEvent *xev)
 	}
 }
 
+void swallow_window(Client *swallower, Client *swallowed)
+{
+	if (!swallower || !swallowed || swallower->swallowed || swallowed->swallower) {
+		return;
+	}
+
+	XUnmapWindow(dpy, swallower->win);
+	swallower->mapped = False;
+
+	swallower->swallowed = swallowed;
+	swallowed->swallower = swallower;
+
+	swallowed->floating = swallower->floating;
+	if (swallowed->floating) {
+		swallowed->x = swallower->x;
+		swallowed->y = swallower->y;
+		swallowed->w = swallower->w;
+		swallowed->h = swallower->h;
+		XMoveResizeWindow(dpy, swallowed->win, swallowed->x, swallowed->y, swallowed->w, swallowed->h);
+	}
+
+	tile();
+	update_borders();
+}
+
 void swap_clients(Client *a, Client *b)
 {
 	if (!a || !b || a == b) {
@@ -1066,6 +1134,67 @@ void hdl_map_req(XEvent *xev)
 		XRaiseWindow(dpy, w);
 	}
 
+	/* check for swallowing opportunities */
+	{
+		XClassHint ch;
+		Bool can_be_swallowed = False;
+
+		if (XGetClassHint(dpy, w, &ch)) {
+			/* check if new window can be swallowed */
+			for (int i = 0; i < 256; i++) {
+				if (!user_config.can_be_swallowed[i] || !user_config.can_be_swallowed[i][0]) {
+					break;
+				}
+
+				if ((ch.res_class && strcasecmp(ch.res_class, user_config.can_be_swallowed[i][0]) == 0) ||
+				    (ch.res_name && strcasecmp(ch.res_name, user_config.can_be_swallowed[i][0]) == 0)) {
+					can_be_swallowed = True;
+					break;
+				}
+			}
+
+			/* if window can be swallowed look for a potential swallower */
+			if (can_be_swallowed) {
+				for (Client *p = workspaces[current_ws]; p; p = p->next) {
+					if (p == c || p->swallowed || !p->mapped) {
+						continue;
+					}
+
+					XClassHint pch;
+					Bool can_swallow = False;
+
+					if (XGetClassHint(dpy, p->win, &pch)) {
+						/* check if this existing window can swallow others */
+						for (int i = 0; i < 256; i++) {
+							if (!user_config.can_swallow[i] || !user_config.can_swallow[i][0]) {
+								break;
+							}
+
+							if ((pch.res_class && strcasecmp(pch.res_class, user_config.can_swallow[i][0]) == 0) ||
+							    (pch.res_name && strcasecmp(pch.res_name, user_config.can_swallow[i][0]) == 0)) {
+								can_swallow = True;
+								break;
+							}
+						}
+
+						/* check process relationship */
+						if (can_swallow) {
+							/* we know class matches — swallow now */
+							swallow_window(p, c);
+							XFree(pch.res_class);
+							XFree(pch.res_name);
+							break;
+						}
+						XFree(pch.res_class);
+						XFree(pch.res_name);
+					}
+				}
+			}
+			XFree(ch.res_class);
+			XFree(ch.res_name);
+		}
+	}
+
 	XMapWindow(dpy, w);
 	c->mapped = True;
 
@@ -1293,10 +1422,16 @@ void init_defaults(void)
 	default_config.border_foc_col = parse_col("#c0cbff");
 	default_config.border_ufoc_col = parse_col("#555555");
 	default_config.border_swap_col = parse_col("#fff4c0");
+
 	for (int i = 0; i < MAX_MONITORS; i++) {
 		default_config.master_width[i] = 50 / 100.0f;
 	}
 
+	for (int i = 0; i < 256; i++) {
+		default_config.can_be_swallowed[i] = NULL;
+		default_config.can_swallow[i] = NULL;
+	}
+
 	default_config.motion_throttle = 60;
 	default_config.resize_master_amt = 5;
 	default_config.resize_stack_amt = 20;
@@ -1318,6 +1453,47 @@ void init_defaults(void)
 	user_config = default_config;
 }
 
+Bool is_child_proc(pid_t parent_pid, pid_t child_pid)
+{
+	if (parent_pid <= 0 || child_pid <= 0) {
+		return False;
+	}
+
+	char path[PATH_MAX];
+	FILE *f;
+	pid_t current_pid = child_pid;
+	int max_iterations = 20;
+
+	while (current_pid > 1 && max_iterations-- > 0) {
+		snprintf(path, sizeof(path), "/proc/%d/stat", current_pid);
+		f = fopen(path, "r");
+		if (!f) {
+			printf("sxwm: could not open %s\n", path);
+			return False;
+		}
+
+		int ppid = 0;
+		if (fscanf(f, "%*d %*s %*c %d", &ppid) != 1) {
+			printf("sxwm: failed to read ppid from %s\n", path);
+			fclose(f);
+			return False;
+		}
+		fclose(f);
+
+		if (ppid == parent_pid) {
+			return True;
+		}
+
+		if (ppid <= 1) { /* Reached init or kernel */
+			printf("sxwm: reached init/kernel, no relationship found\n");
+			break;
+		}
+
+		current_pid = ppid;
+	}
+	return False;
+}
+
 void move_master_next(void)
 {
 	if (!workspaces[current_ws] || !workspaces[current_ws]->next) {
@@ -1475,8 +1651,11 @@ void reload_config(void)
 {
 	puts("sxwm: reloading config...");
 
+	/* free binding commands without */
 	for (int i = 0; i < user_config.bindsn; i++) {
-		free(user_config.binds[i].action.cmd);
+		if (user_config.binds[i].type == TYPE_CMD && user_config.binds[i].action.cmd) {
+			free(user_config.binds[i].action.cmd);
+		}
 		user_config.binds[i].action.cmd = NULL;
 		user_config.binds[i].action.fn = NULL;
 		user_config.binds[i].type = -1;
@@ -1484,14 +1663,52 @@ void reload_config(void)
 		user_config.binds[i].mods = 0;
 	}
 
-	memset(&user_config, 0, sizeof(user_config));
+	/* free swallow-related arrays */
+	for (int i = 0; i < 256; i++) {
+		if (user_config.can_swallow[i]) {
+			if (user_config.can_swallow[i][0]) {
+				free(user_config.can_swallow[i][0]);
+			}
+			free(user_config.can_swallow[i]);
+			user_config.can_swallow[i] = NULL;
+		}
+		if (user_config.can_be_swallowed[i]) {
+			if (user_config.can_be_swallowed[i][0]) {
+				free(user_config.can_be_swallowed[i][0]);
+			}
+			free(user_config.can_be_swallowed[i]);
+			user_config.can_be_swallowed[i] = NULL;
+		}
+	}
 
+	/* free should_float arrays */
+	for (int i = 0; i < 256; i++) {
+		if (user_config.should_float[i]) {
+			if (user_config.should_float[i][0]) {
+				free(user_config.should_float[i][0]);
+			}
+			free(user_config.should_float[i]);
+			user_config.should_float[i] = NULL;
+		}
+	}
+
+	/* free any exec strings */
+	for (int i = 0; i < 256; i++) {
+		if (user_config.torun[i]) {
+			free(user_config.torun[i]);
+			user_config.torun[i] = NULL;
+		}
+	}
+
+	/* wipe everything else */
+	memset(&user_config, 0, sizeof(user_config));
 	init_defaults();
 	if (parser(&user_config)) {
-		fprintf(stderr, "sxrc: error parsing config file\n");
+		fprintf(stderr, "sxwmrc: error parsing config file\n");
 		init_defaults();
 	}
 
+	/* regrab all key/button bindings */
 	grab_keys();
 	XUngrabButton(dpy, AnyButton, AnyModifier, root);
 	for (int ws = 0; ws < NUM_WORKSPACES; ws++) {
@@ -1499,16 +1716,12 @@ void reload_config(void)
 			XUngrabButton(dpy, AnyButton, AnyModifier, c->win);
 		}
 	}
-
 	XGrabButton(dpy, Button1, user_config.modkey, root, True, ButtonPressMask | ButtonReleaseMask | PointerMotionMask,
 	            GrabModeAsync, GrabModeAsync, None, None);
-
 	XGrabButton(dpy, Button1, user_config.modkey | ShiftMask, root, True,
 	            ButtonPressMask | ButtonReleaseMask | PointerMotionMask, GrabModeAsync, GrabModeAsync, None, None);
-
 	XGrabButton(dpy, Button3, user_config.modkey, root, True, ButtonPressMask | ButtonReleaseMask | PointerMotionMask,
 	            GrabModeAsync, GrabModeAsync, None, None);
-
 	for (int ws = 0; ws < NUM_WORKSPACES; ws++) {
 		for (Client *c = workspaces[ws]; c; c = c->next) {
 			XGrabButton(dpy, Button1, 0, c->win, False, ButtonPressMask, GrabModeSync, GrabModeAsync, None, None);
@@ -1523,8 +1736,8 @@ void reload_config(void)
 
 	update_client_desktop_properties();
 	update_net_client_list();
-
 	XSync(dpy, False);
+
 	tile();
 	update_borders();
 }
@@ -1676,6 +1889,7 @@ void setup(void)
 	            GrabModeAsync, GrabModeAsync, None, None);
 	XGrabButton(dpy, Button1, user_config.modkey | ShiftMask, root, True,
 	            ButtonPressMask | ButtonReleaseMask | PointerMotionMask, GrabModeAsync, GrabModeAsync, None, None);
+
 	XGrabButton(dpy, Button3, user_config.modkey, root, True, ButtonPressMask | ButtonReleaseMask | PointerMotionMask,
 	            GrabModeAsync, GrabModeAsync, None, None);
 	XSync(dpy, False);
@@ -2127,6 +2341,29 @@ void toggle_fullscreen(void)
 	}
 }
 
+void unswallow_window(Client *c)
+{
+	if (!c || !c->swallower) {
+		return;
+	}
+
+	Client *swallower = c->swallower;
+
+	/* unlink windows */
+	swallower->swallowed = NULL;
+	c->swallower = NULL;
+
+	XMapWindow(dpy, swallower->win);
+	swallower->mapped = True;
+
+	focused = swallower;
+	XSetInputFocus(dpy, swallower->win, RevertToPointerRoot, CurrentTime);
+	XRaiseWindow(dpy, swallower->win);
+
+	tile();
+	update_borders();
+}
+
 void update_borders(void)
 {
 	for (Client *c = workspaces[current_ws]; c; c = c->next) {
diff --git a/sxwm.1 b/sxwm.1
index 4ab4f25..4e05ea5 100644
--- a/sxwm.1
+++ b/sxwm.1
@@ -5,6 +5,7 @@ sxwm \- minimal, fast, and configurable tiling window manager for X11
 
 .SH SYNOPSIS
 .B sxwm
+[\fIOPTION\fR]
 
 .SH DESCRIPTION
 sxwm is a lightweight and efficient tiling window manager for X11, designed to be fast, minimal, and easy to configure. It supports workspaces, floating windows, mouse operations, and dynamic configuration reloading.
@@ -16,19 +17,21 @@ Live configuration reload without restart.
 Human-friendly configuration file requiring no recompilation.
 DWM-style master-stack layout.
 Mouse support for moving, resizing, and swapping windows.
-Depends only on libX11 and Xinerama.
+Depends only on libX11, Xinerama, and XCursor.
 Extremely lightweight (single C file).
 Multi-monitor support via Xinerama.
 Works well with external bars such as sxbar.
+Zero dependencies beyond X11 libraries.
+Fast and low resource usage.
 
 .SH LAUNCH ARGUMENTS
 
 .TP
-.B -v || --version
+.B \-v, \-\-version
 Displays current sxwm version
 
 .TP
-.B -b || --backup
+.B \-b, \-\-backup
 Uses default config along side the custom sxwmrc
 
 .SH CONFIGURATION
@@ -41,7 +44,7 @@ General options include:
 
 .TP
 .B mod_key
-Sets the primary modifier key (for example, "alt", "super", or "ctrl"). Default is "super".
+Sets the primary modifier key ("alt", "super", or "ctrl"). Default is "super".
 
 .TP
 .B gaps
@@ -72,6 +75,10 @@ Percentage of screen width allocated to the master window. Default is 60.
 Percentage to increase or decrease master width when resizing. Default is 1.
 
 .TP
+.B resize_stack_amount
+How many pixels to increase/decrease stack windows by. Default is 20.
+
+.TP
 .B snap_distance
 Pixels from screen edge before a floating window snaps to the edge. Default is 5.
 
@@ -81,7 +88,7 @@ Target updates per second for mouse drag operations (move, resize, swap). Defaul
 
 .TP
 .B should_float
-Lets you change which windows should float by default when opening them. Default is st
+Lets you change which windows should float by default when opening them. Multiple entries should be comma-separated. Optionally, entries can be enclosed in quotes. Default is "st".
 
 .TP
 .B new_win_focus
@@ -91,6 +98,18 @@ Whether newly opened windows should automatically gain focus. Default is true.
 .B warp_cursor
 If true, warps the mouse cursor to the center of newly focused windows. Default is true.
 
+.TP
+.B exec
+Command to run on startup (e.g., "sxbar", "picom", "autostart", etc.).
+
+.TP
+.B can_swallow
+Windows that can swallow other windows. Default is "st".
+
+.TP
+.B can_be_swallowed
+Windows that can be swallowed by others. Default is "mpv".
+
 .SH KEYBINDINGS
 Keybindings associate key combinations with actions, either running external commands or internal sxwm functions.
 
@@ -103,26 +122,29 @@ Modifiers can be mod, shift, ctrl, alt, or super. The key is the final key name
 
 Actions can be either a quoted external command or an internal function name.
 
+.TP
+.B workspace : modifier + modifier + ... + key : move n
+.TP
+.B workspace : modifier + modifier + ... + key : swap n
+
+For workspace switching and moving windows. n is the workspace number (1-9).
+
 Example bindings:
 
 .TP
 .B bind : mod + Return : "st"
-
 Open the st terminal.
 
 .TP
 .B bind : mod + shift + q : close_window
-
 Close any window that is selected.
 
 .TP
-.B bind : mod + 3 : change_ws3
-
+.B workspace : mod + 3 : move 3
 Go to workspace 3.
 
 .TP
-.B bind : mod + shift + 5 : moveto_ws5
-
+.B workspace : mod + shift + 5 : swap 5
 Move selected window to workspace 5.
 
 .SH AVAILABLE FUNCTIONS
@@ -145,6 +167,22 @@ Shifts focus to the next window in the stack.
 Shifts focus to the previous window in the stack.
 
 .TP
+.B focus_next_mon
+Switches focus to the next monitor.
+
+.TP
+.B focus_prev_mon
+Switches focus to the previous monitor.
+
+.TP
+.B move_next_mon
+Moves the focused window to the next monitor.
+
+.TP
+.B move_prev_mon
+Moves the focused window to the previous monitor.
+
+.TP
 .B increase_gaps
 Increases the gap size between windows.
 
@@ -153,7 +191,7 @@ Increases the gap size between windows.
 Moves the focused window down the master/stack order.
 
 .TP
-.B master_previous
+.B master_prev
 Moves the focused window up the master/stack order.
 
 .TP
@@ -220,6 +258,18 @@ Moves the focused window to the specified workspace (1 to 9).
 Window Management:
 
 .TP
+.B Mouse Click
+Focus window under cursor.
+
+.TP
+.B MOD + Left Mouse
+Move window with mouse.
+
+.TP
+.B MOD + Right Mouse
+Resize window with mouse.
+
+.TP
 .B MOD + Return
 Launch terminal (default: st).
 
@@ -232,10 +282,18 @@ Launch browser (default: firefox).
 Run launcher (default: dmenu_run).
 
 .TP
-.B MOD + q
+.B MOD + Shift + q
 Close focused window.
 
 .TP
+.B MOD + Shift + e
+Quit sxwm.
+
+.TP
+.B MOD + r
+Reload configuration.
+
+.TP
 .B MOD + 1 to 9
 Switch to workspace 1 through 9.
 
@@ -252,12 +310,12 @@ Focus next or previous window.
 Move window up or down in the master stack.
 
 .TP
-.B MOD + Shift + h / l
-Increase or decrease master size.
+.B MOD + h / l
+Resize master area (decrease/increase).
 
 .TP
-.B MOD + Ctrl  h / l
-Increase or decrease stack height.
+.B MOD + Ctrl + h / l
+Resize stack area (decrease/increase).
 
 .TP
 .B MOD + Space
@@ -272,42 +330,75 @@ Toggle floating mode for all windows.
 Increase or decrease gaps.
 
 .TP
-.B MOD + f
+.B MOD + Shift + f
 Toggle fullscreen mode.
 
 .TP
-.B MOD + .
-Focus next monitor.
+.B MOD + . / ,
+Focus next/previous monitor.
 
 .TP
-.B MOD + ,
-Focus previous monitor.
+.B MOD + Shift + . / ,
+Move focused window to next/previous monitor.
+
+.SH DEPENDENCIES
+sxwm requires the following libraries:
 
 .TP
-.B MOD + Shift + .
-Move focused window to next monitor.
+.B libX11
+Xorg client library
 
 .TP
-.B MOD + Shift + ,
-Move focused window to previous monitor.
+.B libXinerama
+Multi-monitor support
 
 .TP
-.B MOD + Left Mouse
-Move window with mouse.
+.B libXcursor
+Cursor support
 
 .TP
-.B MOD + Right Mouse
-Resize window with mouse.
+.B GCC or Clang & Make
+For building from source
 
 .SH FILES
 Configuration file:
 .B ~/.config/sxwmrc
 
+.SH EXAMPLES
+Example configuration snippets:
+
+.RS
+.nf
+# Set gaps and borders
+gaps : 15
+border_width : 2
+focused_border_colour : "#ff6b6b"
+
+# Custom keybindings
+bind : mod + Return : "alacritty"
+bind : mod + d : "rofi -show drun"
+
+# Workspace switching
+workspace : mod + 1 : move 1
+workspace : mod + shift + 1 : swap 1
+
+# Window swallowing
+can_swallow : Alacritty
+can_be_swallowed : sxiv, mpv, zathura
+.fi
+.RE
+
 .SH AUTHOR
-Written by El Bachir (elbachir-one), 2025.
+Written by Abhinav Prasai (uint23), 2025.
 
 .SH SEE ALSO
 sxbar(1), dmenu(1), st(1), X(7)
 
 .SH LICENSE
 MIT License. See the LICENSE file for full details.
+
+.SH BUGS
+Report bugs at: https://github.com/uint23/sxwm/issues
+
+.SH INSPIRATION
+sxwm draws inspiration from dwm, i3, sowm, and tinywm.