i3ipc-d provides a high-level D API to the window manager i3's interprocess communication interface.
See here for an example showing all available API methods and here for all examples. A connection in i3ipc-d has always exactly one of the following characteristics:
- threaded (events are automatically dispatched by a dedicated thread),
- fibered (events need to be explicitly dispatched by calling
connection.dispatch
), or - eventless (events are not supported at all).
The following shows how to setup a threaded connection:
module threaded;
import core.time : seconds;
import core.thread : Thread, dur;
import std.stdio : writeln;
import i3ipc;
void main(string[] args)
{
auto connection = i3ipc.connect!Thread;
connection.subscribe!"Workspace"((change, current, old) => writeln(change, " ", current, " ", old));
writeln("Connection open for approximately 3 seconds, please generate some i3 workspace events!");
/+ A thread-backed connection automatically dispatches events,
+ this just delays program termination.
+/
Thread.sleep(3.seconds);
}