https://github.com/i2p/i2pbutton
A browser plugin for the official I2P Browser
https://github.com/i2p/i2pbutton
anonymity browser browser-extension i2p i2p-browser privacy
Last synced: about 1 year ago
JSON representation
A browser plugin for the official I2P Browser
- Host: GitHub
- URL: https://github.com/i2p/i2pbutton
- Owner: i2p
- License: mit
- Created: 2019-06-05T21:06:28.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2021-05-29T15:10:29.000Z (about 5 years ago)
- Last Synced: 2025-03-21T17:23:27.661Z (about 1 year ago)
- Topics: anonymity, browser, browser-extension, i2p, i2p-browser, privacy
- Language: JavaScript
- Homepage:
- Size: 257 KB
- Stars: 13
- Watchers: 6
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
# I2Pbutton
I2PButton is an XUL plugin which we incorporate into the I2P Browser in order
to enable I2P-specific features and improve the user experience of the I2P
Browser. It can only be used in I2P Browser where it is specifically enabled,
but developers can build the plugin from source and side-load it to test their
changes.
## Development howto
You can build and update i2pbutton without the need of recompiling I2P browser
for most tasks.
To do this build it and copy it into your data directory. Note that these
examples assume that you only have one version of the .xpi file in the pkg/
directory where the finished product is built.
### OSX
On OSX, you will have an I2P Browser Data directory under ~/I2PBrowser-Data and
you can swap the plugin by copying it over the plugin in your working profile,
like in the following example:
```
./makexpi.sh
cp pkg/i2pbutton-*.xpi ~/I2PBrowser-Data/Browser/914o5i1s.default/extensions/i2pbutton@geti2p.net.xpi
```
### Linux
Although the browser on Linux can be run from any location available to the
user, it was probably downloaded and extracted to your ~/Downloads/ directory.
If that is the case, then you may simply:
```
./makexpi.sh
find $HOME/Downloads/i2p-browser_en-US/ -name 'i2pbutton*.xpi' -exec cp -v {} i2pbutton.xpi.bak \;
find $HOME/Downloads/i2p-browser_en-US/ -name 'i2pbutton*.xpi' -exec cp -v pkg/i2pbutton-*.xpi {} \;
```
to automatically replace the I2PButton in your I2P browser with your working
copy. If you want to reverse this process, then:
```
find $HOME/Downloads/i2p-browser_en-US/ -name 'i2pbutton*.xpi' -exec cp -v i2pbutton.xpi.bak {} \;
```
### Windows
On Windows, your browser is usually installed to your Desktop where it's
configuration can be accessed. Your profile will be in the following directory
under, along with a default profile called "profile.default." You should usually
use the working profile directory and not the default.
To test local changes, you need to copy the pkg/i2pbutton-*.xpi over the
i2pbutton@geti2p.net.xpi
```
Desktop\I2P Browser Beta\Browser\I2PBrowser\Data\Browser\%profile_directory%\extensions\
```