[] (https://travis-ci.org/monetas/bmclient)

bmclient is a daemon handling Bitmessage identities for a single user. It acts as an RPC client to bmd and an IMAP and SMTP server for interfacing with traditional e-mail clients like Thunderbird, Outlook and Mail. It extensively shares code and design philosophy with btcwallet.

Private keys can be generated both randomly and deterministically using a seed. Due to the sensitive nature of these private keys, they are stored encrypted on disk using a key derived from the passphrase.

bmclient is not a network node and requires connection to a running instance of bmd using JSON-RPC over websockets. Full bmd installation instructions can be found here.

No graphical frontends are planned as of right now. All communication between the user and bmclient can be done using IMAP/SMTP or JSON-RPC over websockets for the more advanced users or use cases.

• Install Go according to the installation instructions here: http://golang.org/doc/install

• Run the following commands to obtain and install bm and all dependencies:

$ go get -u -v github.com/monetas/bmd/...
$ go get -u -v github.com/monetas/bmclient/...

• bmd and bmclient will now be installed in either $GOROOT/bin or $GOPATH/bin depending on your configuration. If you did not already add to your system path during the installation, we recommend you do so now.

• Run the following commands to update bmclient, all dependencies, and install it:

$ go get -u -v github.com/monetas/bmd/...
$ go get -u -v github.com/monetas/bmclient/...

The follow instructions detail how to get started with bmclient connecting to a localhost bmd.

• Run the following command to start bmd:

$ bmd -u rpcuser -P rpcpass

• Run the following command to create your first identity and send its public key to the network:

$ bmclient -u rpcuser -P rpcpass --create

• Run the following command to start bmclient:

$ bmclient -u rpcuser -P rpcpass

• Start your e-mail client and connect to localhost:143 for IMAP (with TLS) and localhost:587 for SMTP (with TLS) with rpcuser as username and rpcpass as password.

If everything appears to be working, it is recommended at this point to copy the sample bmd and bmclient configurations and update with your RPC and IMAP/SMTP username and password.

$ cp $GOPATH/src/github.com/monetas/bmd/sample-bmd.conf ~/.bmd/bmd.conf
$ cp $GOPATH/src/github.com/monetas/bmd/sample-bmclient.conf ~/.bmclient/bmclient.conf
$ $EDITOR ~/.bmd/bmd.conf
$ $EDITOR ~/.bmclient/bmclient.conf

The integrated github issue tracker is used for this project.

bmclient is licensed under the liberal ISC License.