2022-08-07 03:11:33 +00:00
|
|
|
# i2p.plugins.firefox
|
|
|
|
|
|
2022-10-23 22:42:18 -04:00
|
|
|
A port of the batch scripts from `i2p.firefox` to Java.
|
2022-08-07 03:11:33 +00:00
|
|
|
|
2022-09-06 20:21:04 -04:00
|
|
|
**Status:** This package is maintained. It cannot solve all your problems. Fingerprinting
|
|
|
|
|
is a reality in modern browsers. Exploits are too. This software attempts to provide a
|
|
|
|
|
best-possible baseline of privacy first, security a close second for browsing the web that
|
|
|
|
|
exists within I2P. Do not expect it to withstand attacks from very powerful adversaries
|
|
|
|
|
who can spend time and money to screw up your life. Do expect it to resist advertisers,
|
|
|
|
|
trackers, and jerks using off-the-shelf techniques and exploits. It is fundamentally unable
|
|
|
|
|
to make changes which un-trust your browser vendor, your OS, your package manager or any
|
|
|
|
|
other system that exists underneath it. **It is just a profile manager.**
|
|
|
|
|
|
|
|
|
|
**All packages require a running I2P router.**
|
|
|
|
|
|
|
|
|
|
**[Windows users should see the Easy-Install Bundle](https://i2pgit.org/i2p-hackers/i2p.firefox)**
|
|
|
|
|
|
2022-09-15 16:23:33 -04:00
|
|
|
## Credits
|
|
|
|
|
|
|
|
|
|
This profile manager makes use of a set of browser extensions which are largely the work of others.
|
|
|
|
|
It makes use of dependencies that are the work of others. In many ways, it's merely an elaborate
|
|
|
|
|
configuration tool. A smart one, but a configuration tool nonetheless. Many thanks to the following
|
|
|
|
|
projects, developers, and communities:
|
|
|
|
|
|
|
|
|
|
### Firefox and Chrome Extensions
|
|
|
|
|
|
|
|
|
|
- [NoScript - Giorgio Maone and others](https://noscript.net)
|
|
|
|
|
- [HTTPS Everywhere - Electronic Frontier Foundation](https://www.eff.org/https-everywhere)
|
|
|
|
|
- [uBlock Origin - Raymond Gorhill and others](https://ublockorigin.com/)
|
|
|
|
|
- [LocalCDN - nobody and others](https://www.localcdn.org/)
|
|
|
|
|
- [jShelter - Libor Polčák and others](https://jshelter.org/)
|
|
|
|
|
|
|
|
|
|
### Firefox Configuration Modifiations
|
|
|
|
|
|
|
|
|
|
- [Arkenfox - Thorin Oakenpants and Others](https://github.com/arkenfox/user.js/)
|
|
|
|
|
|
2022-09-15 18:30:48 -04:00
|
|
|
You can find the license files for each of the these projects in the `src/i2p.firefox.*.profile/extensions/*`
|
|
|
|
|
directory for Firefox, and the `src/i2p.chromium.*.profile/extensions/*.js/*` directories for Chromium.
|
|
|
|
|
|
2022-08-07 03:11:33 +00:00
|
|
|
## Getting started
|
|
|
|
|
|
2022-11-11 18:58:48 -05:00
|
|
|
### Building the package:
|
|
|
|
|
|
|
|
|
|
- See: [BUILD.md](docs/BUILD.md)/[BUILD.html](docs/BUILD.html)
|
|
|
|
|
|
2022-08-20 18:58:50 -04:00
|
|
|
### Using a Binary
|
|
|
|
|
|
2022-10-23 22:42:18 -04:00
|
|
|
For platform specific instructions, see
|
|
|
|
|
|
2022-12-31 20:03:29 +00:00
|
|
|
- [LINUX.md](docs/LINUX.md)/[LINUX.html](docs/LINUX.html)
|
|
|
|
|
- [OSX.md](docs/OSX.md)/[OSX.html](docs/OSX.html)
|
|
|
|
|
- [WINDOWS.md](docs/WINDOWS.md)/[WINDOWS.html](docs/WINDOWS.html)
|
2022-08-20 18:58:50 -04:00
|
|
|
|
2022-10-23 22:42:18 -04:00
|
|
|
#### All platforms, using a zip: `.zip` and a non-bundled Java
|
|
|
|
|
|
|
|
|
|
```sh
|
2022-08-20 18:58:50 -04:00
|
|
|
mkdir ~/tmp-i2pfirefox && cd ~/tmp-i2pfirefox
|
2023-07-01 17:56:18 -04:00
|
|
|
wget https://github.com/eyedeekay/i2p.plugins.firefox/releases/download/1.1.0/i2pfirefox.zip
|
2022-08-20 18:58:50 -04:00
|
|
|
unzip i2pfirefox.zip
|
2022-08-20 20:23:27 -04:00
|
|
|
./i2pfirefox.cmd
|
2022-08-20 18:58:50 -04:00
|
|
|
|
|
|
|
|
#or if you want to use a Chromium
|
|
|
|
|
|
2022-08-20 20:23:27 -04:00
|
|
|
./i2pchromium.cmd
|
2022-08-20 18:58:50 -04:00
|
|
|
```
|
