Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eyedeekay/i2p-configuration-for-chromium
I2P configuration guides for Chromium-based browsers if you must, and a simple extension to ease the pain.
https://github.com/eyedeekay/i2p-configuration-for-chromium
chromium i2p i2p-browser webextension
Last synced: 4 days ago
JSON representation
I2P configuration guides for Chromium-based browsers if you must, and a simple extension to ease the pain.
- Host: GitHub
- URL: https://github.com/eyedeekay/i2p-configuration-for-chromium
- Owner: eyedeekay
- License: mit
- Created: 2020-01-05T00:35:38.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-04-20T12:52:31.000Z (over 2 years ago)
- Last Synced: 2024-06-21T06:34:08.550Z (5 months ago)
- Topics: chromium, i2p, i2p-browser, webextension
- Language: JavaScript
- Size: 24.8 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
How to tweak a Chromium-Based Web Browser to work with I2P
==========================================================
This is not a recommendation! This is a much more complicated procedure than
we wish to recommend to anyone. A great deal of thought went into the design of
the [Firefox extension](https://eyedeekay.github.io/I2P-in-Private-Browsing-Mode-Firefox/),
which is safer and better because of the way Mozilla has designed and maintained
it's webextension privacy API's. Moreover, Chrome is bad for the Internet. So is
Google. If you **must**, absolutely must, use Chrome, then you are part of a
different anonymity set, and in all likelihood, unique. You are subject to
changes in the way Chrome is configured, including possibly unstable
command-line flags which you might use to configure the proxy. This procedure
does not make these risks, which are inherent to the use of Chromium, any
greater or lesser, rather it teaches you to encapsulate a Chromium-based
browsing profile for I2P which is the best that is possible to create with
technology available across all Chromium variants. Also use Chromium or even
better, ungoogled-chromium because Chrome is an advertising delivery vehicle
with trivial browser-like characteristics.
This is an *EXPERIMENTAL* Procedure.
Privacy Policy
--------------
This browser extension does not collect any personal information. It requires
access to local storage and browsing data permissions in order to delete them
when directed to by the user. This browser extension does not transmit any
information to any third party, nor will it, ever.
This browser extension cannot influence telemetry carried out by browser vendors
to determine performance in their distribution channels, nor can it mitigate any
other browser vendor telemetry.
This browser extension is entirely Free, Open-Source software.
### Don't enable syncing for this Profile
You should not enable the use of a google account or plugin syncing for this
profile. If you see something like these:
* **Syncing Options:**
-  No!
-  No!
Say no, otherwise you will be sharing your profile data with google!
Profile+Plugin Solution, All Platforms
--------------------------------------
This solution is probably the easiest for the majority of people, but it may not
have the best privacy characteristics because it relies on API's and tooling
that Google makes available via extensions, which is pretty narrow.
**Step 1: Create an I2P Browsing Profile**
* **1A:** Open the people manager to create your I2P persona within Chromium.
- 
* **1B:** Add a person named I2P Browsing Mode.
- 
* **1C:** Give the person some cool shades to protect them on the *darkweb*.
- 
* **1D:** Awwwwwww...
- 
**Step 2: Install Extension on profile**
* **2A:** Open the following link in your I2P Browsing Mode persona and install
the extension like you normally would, by clicking the "Install in Chrome"
button. This is an *experimental* extension.
[i2pchrome.js](https://chrome.google.com/webstore/detail/i2pchromejs/ikdjcmomgldfciocnpekfndklkfgglpe)
Pure Terminal Solution, Unix-Only
---------------------------------
This solution uses a shell script to wrap the Chromium executable and apply
I2P-ready settings.
**Step 1: Create a file named /usr/bin/chromium-i2p with the following**
**contents.**
#! /usr/bin/env sh
# Launches Chromium, pre-configured for I2P
#
CHROMIUM_I2P="$HOME/i2p/chromium"
mkdir -p "$CHROMIUM_I2P"
/usr/bin/chromium --user-data-dir="$CHROMIUM_I2P" \
--proxy-server="http://127.0.0.1:4444" \
--proxy-bypass-list=127.0.0.1:7657 \
--safebrowsing-disable-download-protection \
--disable-client-side-phishing-detection \
--disable-3d-apis \
--disable-accelerated-2d-canvas \
--disable-remote-fonts \
--disable-sync-preferences \
--disable-sync \
--disable-speech \
--disable-webgl \
--disable-reading-from-canvas \
--disable-gpu \
--disable-auto-reload \
--disable-background-networking \
--disable-d3d11 \
--disable-file-system $@
### Notes
As you can see, it simply sets a group of flags. Of particular note are
the ```--user-data-dir=$CHROMIUM_I2P``` flag, which forces Chromium to treat
a new directory as the user data directory and prevents your clearnet Chromium
profile from polluting your I2P Chromium profile, and
```--proxy-server="http://127.0.0.1:4444" --proxy-bypass-list=127.0.0.1:7657```
which configure Chromium to use I2P's HTTP Proxy for everything *except* for
router console administration. The rest is just disabling telemetry and features
which may be fingerprintable in an effort to reduce the granularity available to
an attacker trying to measure Chromium.
**Step 2: To also add a shortcut for incognito mode, create another file named**
**/usr/bin/chromium-i2p-incognito with the following contents:**
#! /usr/bin/env sh
# Launches Chromium, pre-configured for I2P
#
CHROMIUM_I2P="$HOME/i2p/chromium"
mkdir -p "$CHROMIUM_I2P"
/usr/bin/chromium-i2p --incognito \
$@