Module `I3ipc`Source

A pure OCaml implementation of the i3 IPC protocol.

Sourcetype protocol_error =

| No_IPC_socket
| Bad_magic_string of string
| Unexpected_eof
| Unknown_type of Stdint.Uint32.t
| Bad_reply of string

The different errors that may be raised.

Sourceval pp_protocol_error : Format.formatter -> protocol_error -> unit

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.

Connection to i3

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.

Event subscription

Sourcetype subscription =

| Workspace
| Output
| Mode
| Window
| BarConfig
| Binding
| Shutdown
| Tick

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.

Commands and queries

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

Run an i3 command. See http://i3wm.org/docs/userguide.html#_list_of_commands for a list of valid commands.

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.

Sourceval get_binding_modes : connection -> Reply.binding_modes Lwt.t

Get binding modes of i3.

Sourceval get_config : connection -> Reply.config Lwt.t

Get the config file as loaded by i3 most recently.

Sourceval send_tick : connection -> string -> bool Lwt.t

Sends a tick event with the specified payload.

package i3ipc

Module I3ipcSource

Connection to i3

Event subscription

Commands and queries

Module `I3ipc`Source