Module `I3ipc`Source

A pure OCaml implementation of the i3 IPC protocol.

Sourcetype protocol_error =

The different errors that may be raised.

Sourceexception Protocol_error of protocol_error

Sourcemodule Reply : sig ... end

Type definitions for the command replies.

Sourcemodule Event : sig ... end

Type definitions for the events that can be subscribed to.

Sourcetype connection

Type describing a connection to the i3 IPC endpoint.

Sourceval connect : unit -> connection Lwt.t

Connect to a running i3 instance.

Sourceval disconnect : connection -> unit Lwt.t

Close a connection.

Sourcetype subscription =

Sourceval subscribe : connection -> subscription list -> Reply.command_outcome Lwt.t

Subscribe to certain events.

Sourceval next_event : connection -> Event.t Lwt.t

Wait for the next event, among those subscribed to.

Sourceval command : connection -> string -> Reply.command_outcome list Lwt.t

Sourceval get_workspaces : connection -> Reply.workspace list Lwt.t

Get the list of current workspaces.

Sourceval get_outputs : connection -> Reply.output list Lwt.t

Get the list of current outputs.

Sourceval get_tree : connection -> Reply.node Lwt.t

Get the layout tree. i3 uses a tree data-structure to represent the layout of windows in a workspace.

Sourceval get_marks : connection -> Reply.mark list Lwt.t

Get a list of marks (identifiers of containers).

Sourceval get_bar_ids : connection -> Reply.bar_id list Lwt.t

Get the list of IDs of all configured bars.

Sourceval get_bar_config : connection -> Reply.bar_id -> Reply.bar_config Lwt.t

Get the configuration of the workspace bar with given ID.

Sourceval get_version : connection -> Reply.version Lwt.t

Get the version of i3.

package i3ipc