I2Pd Browser

This is a script-based builder of the I2Pd Browser for Linux-based systems, supporting both x86_64 and i686 architectures. Any contribution is highly appreciated.

The I2Pd browser is a pre-configured version of Firefox ESR for use on the I2P network. It is the fastest and easiest way to start surfing the web on the Invisible Internet.

Features

• Auto-detecting system architecture: The script automatically detects the system architecture to configure Firefox accordingly.
• Pre-configuring Firefox: Firefox is pre-configured for use with I2Pd, including necessary settings adjustments.
• Automatic downloads:
  • NoScript extension: The script downloads and installs the NoScript extension for added security.
  • Language packs: Language packs for Firefox are automatically downloaded.
• Checksum verification: Ensures the integrity of the downloaded Firefox package.
• Environment preservation: Maintains the environment variables and arguments when executing the start-i2pd-browser script, ensuring consistent configuration and behavior.
• Self-modifying .desktop file:
  • Supports relocation of the .desktop file.
  • Can register and unregister itself as a desktop application for the current user.
  • Supports being used as a portable app.

Dependencies

Ensure you have the following dependencies installed on your Linux system before using the I2Pd Browser:

• I2Pd: Follow the installation guide
• curl: Used for downloading files
• tar: For extracting compressed files
• screen: Required for managing detached sessions

Usage

1. Install the dependencies if they are not already installed.

2. Clone or download this repository:

   git clone https://github.com/daviduhden/i2pd-browser.git

   cd i2pd-browser

3. Build the pre-configured Firefox using the build shell script from the build directory:

   cd build

   ./build

4. Run I2Pd by executing the i2pd shell script from i2pd directory:

   cd ../i2pd

   ./i2pd

5. Run Firefox by executing the start-i2pd-browser.desktop desktop entry:

   cd ../

   ./start-i2pd-browser.desktop

Additional information

• The i2pd shell script from the i2pd directory starts a screen session with I2Pd in it.
• To stop the I2Pd router, you can execute the commands Start graceful shutdown or Force shutdown from the I2Pd web console page: http://127.0.0.1:7070/?page=commands.
• The pre-compiled i2pd binaries available for Unix-like operating systems such as Linux and *BSD do not have built-in support for UPnP by default, which makes it very inconvenient for client use. If you want UPnP to work you need to compile I2Pd yourself. For more information refer to the official documentation.

Licensing

The scripts and configuration files in this repository, along with the i2pd software, are licensed under the BSD 3-Clause "New" or "Revised" License. However, the software downloaded and used by these scripts and configuration files is subject to different terms and conditions.