Rebus

Rebus is a D-Bus client for Elixir. It connects to a message bus or peer, makes method calls, sends and receives signals, and passes Unix file descriptors over local sockets.

Rebus supports Elixir 1.18 and later on Linux and macOS. Windows is not supported. It currently has no service-side API, proxies, or introspection; applications build and match D-Bus messages directly.

Installation

Add Rebus to your dependencies:

def deps do
  [
    {:rebus, "~> 0.3.0"}
  ]
end

Example

{:ok, conn} = Rebus.connect(:session)

message =
  Rebus.Message.new!(:method_call,
    path: "/org/freedesktop/DBus",
    interface: "org.freedesktop.DBus",
    destination: "org.freedesktop.DBus",
    member: "ListNames"
  )

{:ok, %Rebus.Message{type: :method_return, body: [names]}} =
  Rebus.call(conn, message)

:ok = Rebus.close(conn)

The HexDocs API reference documents connection options, results, errors, and wire-format modules. The practical guides cover authentication, signal subscriptions, and Unix file descriptors.

See CONTRIBUTING.md for development and testing instructions.

License

Rebus is licensed under the MIT License.