index.md - sites - public wiki contents of suckless.org | |
git clone git://git.suckless.org/sites | |
Log | |
Files | |
Refs | |
--- | |
index.md (2761B) | |
--- | |
1 ipc | |
2 ==== | |
3 | |
4 Description | |
5 ----------- | |
6 dwm-ipc is a patch for dwm that implements inter-process communication t… | |
7 a UNIX socket. This allows you to query the window manager for informati… | |
8 listen for events such as tag changes or layout changes, as well as send | |
9 commands to control the window manager from other programs/scripts. | |
10 | |
11 The project is being managed and developed on this GitHub | |
12 [repo](https://github.com/mihirlad55/dwm-ipc). If you discover any bugs,… | |
13 free to create an issue there. | |
14 | |
15 | |
16 Requirements | |
17 ------------ | |
18 In order to build dwm you need the Xlib header files. The patch | |
19 additionally requires [yajl](https://github.com/lloyd/yajl) which is a t… | |
20 JSON library. | |
21 | |
22 | |
23 Applying the Patch | |
24 ------------------ | |
25 The patch is best applied after all of your other patches due to the num… | |
26 additions to dwm.c. The patch was designed with compatability in mind, s… | |
27 are minimal deletions. | |
28 | |
29 | |
30 Patch Compatability | |
31 ------------------- | |
32 At the moment, the patch will only work on systems that implement epoll … | |
33 not completely portable. Portability will be improved in the future. | |
34 | |
35 | |
36 Supported IPC Messages | |
37 ---------------------- | |
38 At the moment the IPC patch supports the following message requests: | |
39 * Run user-defined command (similar to key bindings) | |
40 | |
41 * Get information about available layouts | |
42 | |
43 * Get information about the tags available | |
44 | |
45 * Get the properties of all of the monitors | |
46 | |
47 * Get the properties of a specific dwm client | |
48 | |
49 * Subscribe to tag change, client focus change, layout change events, mo… | |
50 focus change events, focused title change events, and focused state ch… | |
51 events. | |
52 | |
53 For more info on the IPC protocol implementation, visit the | |
54 [wiki](https://github.com/mihirlad55/dwm-ipc/wiki/). | |
55 | |
56 | |
57 dwm-msg | |
58 ------- | |
59 `dwm-msg` is a cli program included in the patch which supports all of t… | |
60 message types listed above. The program can be used to run commands, que… | |
61 for information, and listen for events. This program is particularly use… | |
62 creating custom shell scripts to control dwm. | |
63 | |
64 | |
65 Download | |
66 -------- | |
67 * IPC Patch v1.5.7: | |
68 [dwm-ipc-20201106-f04cac6.diff](dwm-ipc-20201106-f04cac6.diff) | |
69 * IPC Patch v1.5.6 to v1.5.7 Update: | |
70 [dwm-ipc-v1.5.6-to-v1.5.7.diff](dwm-ipc-v1.5.6-to-v1.5.7.diff) | |
71 | |
72 The latest releases of the patch will always be available first on the p… | |
73 [Releases](https://github.com/mihirlad55/dwm-ipc/releases) page. There a… | |
74 "update" patches to update from previous versions of the patch. | |
75 | |
76 | |
77 Related Projects | |
78 ---------------- | |
79 * [dwmipcpp](https://github.com/mihirlad55/dwmipcpp) is a C++ client lib… | |
80 for interacting with an IPC-patched dwm | |
81 | |
82 * [polybar-dwm-module](https://github.com/mihirlad55/polybar-dwm-module) | |
83 requires this patch | |
84 | |
85 | |
86 Authors | |
87 ------- | |
88 * Mihir Lad - <mihirlad55 at gmail> |