From I2PWiki
Jump to: navigation, search

Introduction about PyBitmessage-I2P[edit]

Wikipedia: "Bitmessage is a decentralized, encrypted, peer-to-peer, trustless communications protocol that can be used by one person to send encrypted messages to another person, or to multiple subscribers."[1]

PyBitmessage-I2P is a fork of the software PyBitmessage (that use the clearnet), modified to run inside the I2P network (only, no connection with the clearnet).

As of 2016-01, the latest version of PyBitmessage-I2P is v0.2.0[2], it is quite experimental.

First release: 2015[3].

Note: Bitmessage is the name of the protocol and 'Py' abbreviates the Python language.

PyBitmessage-I2P vs I2P-Bote[edit]

PyBitmessage-I2P has these features that I2P-Bote does not have (as of 2016-02) :

  • Broadcast messages
  • Mailing lists
  • Anonymous Channels

Note: there is a official comparison table named "How does Bitmessage compare to other messaging methods" at

PyBitmessage-I2P vs PyBitmessage (clearnet)[edit]

The original PyBitmessage has these issues by design[4] (as of 2015) :

  • No transport layer security, ISP's can read your traffic
  • Published IPs of all users to all users


PyBitmessage-I2P v0.2.0 (2015. Forked from PyBitmessage v0.4.4)

Main screen > tab Send

Settings > UI

Start guide[edit]

I2P Setup (to do !)[edit]

  1. First enable the client "SAM application bridge" on your I2P node (you can find instructions in the IMule article)
  2. Optionally, if you run I2P 24/24 and use PyBitMessage-I2P often, you may help it by running a seedless node onto your I2P router: install the plugin Seedless.
    Note: having Seedless and Neodatis installed onto your I2P router is not necessary to make PyBitmessage-I2P work.

Where to download the software[edit]

Currently (2016-07) the software PyBitmessage-I2P it is not available inside I2P network.
The official (clearnet) URL is at the bottom of this wiki page.



The official user guide are the text files:


stored in the file ""


  1.  To see the GUI, you may have to install this: "sudo apt-get install python-qt4"
  2.  From a terminal, run PyBitmessage-I2P ("cd PyBitMessage-I2P-0.x.0/src/", "python")


  1.  Copy into a empty directory the file "PyBitmessage-I2P.exe"
  2.  Double click the file "PyBitmessage-I2P.exe"

All OS[edit]

  • When PyBitmessage-I2P, a splash screen appear, you can choose "[x] Connect now"
  • Run PyBitmessage-I2P then set it as portable (easier to move and backup the files later): menu Settings > line Settings > [x] "Run in Portable Mode" (bad idea since it is a beta version and may receive several updates)
  •  If this is the first time that you use PyBitmessage-I2P, you will have to create a 'mail address' (called a Identity) : go to the tab 'Your Identities' then click the button 'New'

Connection to other BM nodes[edit]

After 5 minutes, the led light (at the bottom right of the window) should color from red to yellow, and may switch to green later.

About the Led light :

  • Red means that PyBitmessage-I2P cannot connect to I2P or to any Seedless server (same as yellow).
  • Yellow means that PyBitmessage-I2P does not see any other PyBitmessage-I2P node connected (in the tab 'Network Status' you can then read 'Total Connections: 0')
  • Green means that PyBitmessage-I2P is connected to at least 1 other PyBitmessage-I2P node

This window does open if you click on the led light icon :

Led light icon glossary

Note: As of July of 2016, no I2P users were running PyBitmessage-I2P (i.e. nobody), hence no connect to other nodes will be possible at such times.
You may chat into IRC2P (channel #i2p or #i2p-chat) to ask to a other I2P user to test PyBitmessage-I2P at the same time with you (i.e. you can rendez-vouz on #i2p).

User guide[edit]

You can now use the official user guide:


Where are my files (and keys) stored ?[edit]

  • GNU/Linux: ~/.config/PyBitmessage-I2P/

Files names: keys.dat, knownnodes.dat, messages.dat

Can I run PyBitmessage-I2P and PyBitmessage (clearnet) at the same time ?[edit]

No, the other will refuse to run.

Note: tested with PyBitmessage-I2P v0.2.0 (based on v0.4.4) and PyBitmessage (v0.4.4), OS Linux.


Language: Python.



See also[edit]

External links[edit]

Links to the clearnet: