index.md - sites - public wiki contents of suckless.org | |
git clone git://git.suckless.org/sites | |
Log | |
Files | |
Refs | |
--- | |
index.md (2294B) | |
--- | |
1 betterswallow | |
2 ============= | |
3 | |
4 Description | |
5 ----------- | |
6 This patch adds "window swallowing" to DWM, similar to some existing pat… | |
7 but with a unique take on dynamic swallowing. | |
8 Unlike the existing [dynamicswallow](https://dwm.suckless.org/patches/dy… | |
9 `betterswallow` uses PID-based swallowing and a non-standard X11 ClientM… | |
10 for communication. | |
11 | |
12 As with `dynamicswallow`, an external tool, `betterswallow`, is required | |
13 to use this feature. `betterswallow` is a separate tool that does not re… | |
14 this patch but is enhanced by its presence. Without the patch, `bettersw… | |
15 defaults to the devour mechanism, which unmaps the parent window itself. | |
16 | |
17 Development of this patch should happen on the [GitHub repository](https… | |
18 of `betterswallow`. If you encounter any bugs, feel free to open an issu… | |
19 | |
20 Currently, only a version for DWM-6.3 exists. If you wish to update the … | |
21 a newer version of DWM, you can open a pull request on the `betterswallo… | |
22 | |
23 #### Patching | |
24 | |
25 The patch requires the `Xres` library. Ensure it's included in your buil… | |
26 Unlike `dynamicswallow`, you don’t need to worry about any IPC patches… | |
27 patch uses a simpler ClientMessage for registering swallowers. | |
28 If you have any patches that store geometry parameters in the `Client` s… | |
29 ensure they are copied in the `copyclientpos` function. | |
30 | |
31 #### Usage | |
32 | |
33 To have any graphical program swallowed, run it as `better-swallow <CMD>… | |
34 This will cause any windows spawned by the command to replace the parent… | |
35 Since `better-swallow` is quite long, I recommend creating an alias, suc… | |
36 | |
37 #### Limitations | |
38 | |
39 - Due to reliance on the `Xres` extension and PIDs, this will fail if th… | |
40 is not running on the same machine as `betterswallow`, and it may add … | |
41 entries to the "swallow queue". | |
42 - If a swallowed process opens a window deeper in the process tree, it w… | |
43 be swallowed. This may be fixed in the future by traversing the entire… | |
44 chain rather than just one step up. Open an issue if you encounter thi… | |
45 | |
46 Download | |
47 -------- | |
48 * [dwm-betterswallow-20250116-89eeca1.diff](dwm-betterswallow-20250116-8… | |
49 | |
50 Author | |
51 ------ | |
52 * Hubert Głuchowski - <[email protected]> |