Skip to content

i2p/i2p.itoopie

Repository files navigation

This is a simple standalone application that talks to the
"i2pcontrol" jsonrpc interface on I2P routers.

Current setup:
* Build itoopie:
    Dependencies: ant, Java SDK
    'ant' in the i2p.itoopie directory
* Run:
    Dependencies: Java runtime and an I2P router that supports the jsonrpc interface
    java -jar dist/itoopie.jar

The router jsonrpc interface is configured by default for https at localhost:7650.
7650 is the default port for i2pd and the old Java router console "i2pcontrol" plugin.

For i2pd, the jsonrpc interface is off by default.
You must set i2pcontrol.enabled=true in i2pd.conf.
See https://i2pd.readthedocs.io/en/latest/user-guide/configuration/#i2pcontrol-interface
for more information and other options.

The Java router console now bundles the jsonrpc interface by default
as a webapp on port 7657, and the i2pcontrol plugin is no longer necessary.
You may disable or remove the plugin at http://localhost:7657/configplugins
The jsonrpc webapp is off by default.
To start it, go to http://localhost:7657/configwebapps and start the
"jsonrpc" webapp. To always run it, click the "Run at Startup" setting
and click "Save WebApp Configuration".
You MUST change itoopie's "I2P Node port" to 7657 to connect to the jsonrpc webapp.
itoopie will automatically use http for port 7657.
If the console is on another port, it is assumed to be HTTPS, and you
must add "server.target=jsonrpc/" to the config file ~/.itoopie/itoopie.conf


Version 1 API specification:
http://i2p-projekt.i2p/en/docs/api/i2pcontrol
https://geti2p.net/en/docs/api/i2pcontrol

Version 2 API proposal (abandoned):
http://i2p-projekt.i2p/spec/proposals/118-i2pcontrol-api-2
https://geti2p.net/spec/proposals/118-i2pcontrol-api-2


Pre-built binaries for itoopie version 0.3 (2015-03-02):
Clearnet installer: https://github.com/robertfoss/itoopie.net/raw/master/files/itoopie-install.exe
Clearnet SHA512: https://raw.githubusercontent.com/robertfoss/itoopie.net/master/files/itoopie-install.exe.sha512
I2P installer: http://stats.i2p/i2p/plugins/others/itoopie-install.exe
I2P SHA512: http://stats.i2p/i2p/plugins/others/itoopie-install.exe.sha512
Source: i2p.itoopie branch in git: https://github.com/i2p/i2p.itoopie
java -jar itoopie-install.exe to install on non-Windows.


Server source:
Plugin (obsolete) https://github.com/i2p/i2p.plugins.i2pcontrol
Console bundled webapp: https://github.com/i2p/i2p.i2p/tree/master/apps/i2pcontrol
i2pd: https://github.com/PurpleI2P/i2pd/tree/openssl/daemon


Command line test client:
scripts/i2pcontrol.py in the server source


Discussion forum:
http://zzz.i2p/forums/16

Bugs:
Report on above forum, or http://trac.i2p2.i2p/ or https://trac.i2p2.de/


License: Apache 2

itoopie and I2PControl were sponsored by Relakks & Ipredator.
Development began during the summer of 2011 and the first alpha was launched in July.

Thanks to:
- Jan-Erik Fiske and Peter Sunde for actively helping privacy and anonymity online.
- KillYourTV for debugging and helping out with platform testing
  as well as fixing the shortcuts of the installer.
- User for tons of testing and a lot of good ideas and requests.
- ReturningNovice for testing and finding bugs.
- zzz for helping out with broad knowledge of I2P, build process and Jetty.