- 1 Introduction about PyBitmessage-I2P
- 2 Start guide
- 3 Misc
- 4 Development
- 5 References
- 6 See also
- 7 External links
Introduction about PyBitmessage-I2P
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."
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, it is quite experimental.
First release: 2015.
Note: Bitmessage is the name of the protocol and 'Py' abbreviates the Python language.
PyBitmessage-I2P vs I2P-Bote
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 https://bitmessage.org/wiki/FAQ
PyBitmessage-I2P vs PyBitmessage (clearnet)
The original PyBitmessage has these issues by design (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)
I2P Setup (to do !)
- First enable the client "SAM application bridge" on your I2P node (you can find instructions in the IMule article)
- 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
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 "PyBitmessage-I2P-0.x.0.zip"
- To see the GUI, you may have to install this: "sudo apt-get install python-qt4"
- From a terminal, run PyBitmessage-I2P ("cd PyBitMessage-I2P-0.x.0/src/", "python bitmessagemain.py")
- Copy into a empty directory the file "PyBitmessage-I2P.exe"
- Double click the file "PyBitmessage-I2P.exe"
- 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
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 :
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).
You can now use the official user guide: https://bitmessage.org/wiki/PyBitmessage_Help
Where are my files (and keys) stored ?
- 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 ?
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.
Links to the clearnet:
- https://github.com/Bitmessage/ - This is the original, not I2P compatible (as of 2016-07 v0.6.0)