|0.0.0||Jan 6, 2021|
#8 in #bitmessage
Koibumi is an experimental Bitmessage client. Note that Koibumi is NOT an official project of The Bitmessage Developers.
Koibumi can connect to the Bitmessage network and relay Bitmessage objects.
It has a GUI.
Configuration and monitoring can be performed on the window.
If you do not need any GUI, use
Currently, this client can send and receive chan and broadcast messages.
By default, network connections are limited to via Tor only. In this case, you need a Tor SOCKS5 proxy running at localhost.
The objects loaded from the network and
the list of known node addresses are saved on local file system by using SQLite.
Configurations can be saved to the file in the user's configuration directory.
The data directory can be changed by specifying a
-d option on the command line.
To install the Koibumi Bitmessage client, issue the command:
cargo install koibumi-sync
To run the client, run
koibumi-sync command, and a GUI window popups.
On the window, you can configure several settings.
To connect to the Bitmessage network, push Start button on the window. When the client connected to some remote nodes, their addresses and user agents are shown on the window. You can monitor how many Bitmessage objects are downloaded and shared.
This client is experimental and under development,
so many debug logs are printed on the console.
-v option on the command line, more messages are printed.
Note that since database format can be changed among versions,
you may have to remove database files located at
$HOME/.config/koibumi when trying new version.
These are default settings:
- Spawn a Bitmessage server at 127.0.0.1:8444. But, currently, this does not fully work, and the client does not advertise its server address.
- Connect to the Bitmessage network via SOCKS5 proxy at 127.0.0.1:9050. It is the default local Tor proxy server address. Be careful, if this checkbox is turned off, no SOCKS proxy is used, and all connections are directly to Clearnet.
- The client can connect to Bitmessage nodes that have Onion addresses.
- The client can connect to Bitmessage nodes that have IP addresses. Be careful, if SOCKS checkbox above is turned off, then all connections are directly to Clearnet.
- Does not connect to myself.
- Use a user agent of a version of PyBitmessage.
- At first, connect to the seed Bitmessage node on the Tor network. This default address is embedded in PyBitmessage source code.
- Max 160 incoming connections can be accepted and max 128 incoming established connections can be managed.
- Max 32 outgoing connections can be initiated and max 8 outgoing established connections are keeped.
You can change these settings on the GUI window.
Some of the significant external crates which Koibumi uses:
Koibumi's internal implementation is divided into several crates:
- Other small libraries