README.markdown (1610B)
1 ![Build Status](https://github.com/godbus/dbus/workflows/Go/badge.svg) 2 3 dbus 4 ---- 5 6 dbus is a simple library that implements native Go client bindings for the 7 D-Bus message bus system. 8 9 ### Features 10 11 * Complete native implementation of the D-Bus message protocol 12 * Go-like API (channels for signals / asynchronous method calls, Goroutine-safe connections) 13 * Subpackages that help with the introspection / property interfaces 14 15 ### Installation 16 17 This packages requires Go 1.7. If you installed it and set up your GOPATH, just run: 18 19 ``` 20 go get github.com/godbus/dbus 21 ``` 22 23 If you want to use the subpackages, you can install them the same way. 24 25 ### Usage 26 27 The complete package documentation and some simple examples are available at 28 [godoc.org](http://godoc.org/github.com/godbus/dbus). Also, the 29 [_examples](https://github.com/godbus/dbus/tree/master/_examples) directory 30 gives a short overview over the basic usage. 31 32 #### Projects using godbus 33 - [notify](https://github.com/esiqveland/notify) provides desktop notifications over dbus into a library. 34 - [go-bluetooth](https://github.com/muka/go-bluetooth) provides a bluetooth client over bluez dbus API. 35 - [playerbm](https://github.com/altdesktop/playerbm) a bookmark utility for media players. 36 - [iwd](https://github.com/shibumi/iwd) go bindings for the internet wireless daemon "iwd". 37 38 Please note that the API is considered unstable for now and may change without 39 further notice. 40 41 ### License 42 43 go.dbus is available under the Simplified BSD License; see LICENSE for the full 44 text. 45 46 Nearly all of the credit for this library goes to github.com/guelfey/go.dbus.