add platform specific install instructions

Former-commit-id: b9778ed075
Former-commit-id: 6c86d90a7744d349bd3355dbc6656b0a1d85b034

LINUX.md

@@ -0,0 +1,33 @@
+### Linux Support
+
+It's possible to use this package in the following binary formats on
+Linux. These packages are for the **`amd64`** architecture.
+
+#### Linux jpackage: `.zip`
+
+```sh
+mkdir ~/tmp-i2pbrowser && cd ~/tmp-i2pbrowser
+wget https://github.com/eyedeekay/i2p.plugins.firefox/releases/download/1.0.2/i2pbrowser.zip
+unzip i2pbrowser.zip && cd i2pbrowser
+## THIS STEP IS OPTIONAL but it will force the system to use Tor Browser from within the i2pbrowser directory.
+# This probably offers better security than vanilla Firefox.
+# This will also make the directory the launcher is in relocatable to a flash drive, for instance.
+# This is commonly referred to as being portable.
+# If tor and torsocks are on the host system, Tor Browser will be downloaded over Tor.
+./lib/torbrowser.sh 
+# end of optional step.
+./bin/i2pbrowser
+```
+
+#### Debian/Ubuntu and variants Jpackage: `.deb`
+
+1. Start your I2P Router
+2. Run `sudo apt-get install ./i2pbrowser*.deb`(Only needs to be done once per update)
+3. Use the applications menu shortcut to launch the pre-configured I2P browser
+
+#### Fedora and variants Jpackage: `.rpm`
+
+1. Start your I2P Router
+2. Run `sudo rpm -i ./i2pbrowser*.rpm`(Only needs to be done the first time)
+3. Run `sudo rpm -U ./i2pbrowser*.rpm`(Only needs to be done once per update)
+4. Use the applications menu shortcut to launch the pre-configured I2P browser

README.md

@@ -1,6 +1,6 @@
 # i2p.plugins.firefox
 
-A port of the batch scripts from i2p.firefox to Java.
+A port of the batch scripts from `i2p.firefox` to Java.
 
 **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
@@ -41,8 +41,15 @@ directory for Firefox, and the `src/i2p.chromium.*.profile/extensions/*.js/*` di
 
 ### Using a Binary
 
-```sh
+For platform specific instructions, see
 
+- [LINUX.md](LINUX.md)/[LINUX.html](LINUX.html)
+- [OSX.md](OSX.md)/[OSX.html](OSX.html)
+- [WINDOWS.md](WINDOWS.md)/[WINDOWS.html](WINDOWS.html)
+
+#### All platforms, using a zip: `.zip` and a non-bundled Java
+
+```sh
 mkdir ~/tmp-i2pfirefox && cd ~/tmp-i2pfirefox
 wget https://github.com/eyedeekay/i2p.plugins.firefox/releases/download/1.0.2/i2pfirefox.zip
 unzip i2pfirefox.zip

WINDOWS.md

@@ -0,0 +1,30 @@
+### Windows Support
+
+It's possible to use this package on Windows, but it's recommended that
+you get it through the Easy-Install bundle which includes this functionality
+already. Use this only if you want to test new features or if you prefer
+an unbundled I2P router with an external JVM.
+
+#### Windows Jpackage: `.zip`
+
+**(Not Recommended! This functionality is already included in the Easy-Install Bundle for Windows)**
+
+1. Start your I2P Router
+2. Unzip the `.zip` directory
+3. run the `i2pbrowser.exe` file inside the unzipped directory.
+
+#### Windows Jpackage: `.msi`
+
+**(Not Recommended! This functionality is already included in the Easy-Install Bundle for Windows)**
+
+1. Start your I2P Router
+2. Run the `.msi` installer(Only needs to be done once per update)
+3. Use the start menu shortcut to launch the pre-configured I2P browser
+
+#### Windows Jpackage: `.exe`
+
+**(Not Recommended! This functionality is already included in the Easy-Install Bundle for Windows)**
+
+1. Start your I2P Router
+2. Run the `.msi` installer(Only needs to be done once per update)
+3. Use the start menu shortcut to launch the pre-configured I2P browser

preprelease.sh

@@ -4,7 +4,7 @@
 ant distclean clangFmt versionMd
 ./javadoc.sh
 NUMLINE=`grep release.number build.xml | head -n 1`
-READMELINE=`grep 'i2p.plugins.firefox/releases/download' README.md`
+READMELINE=`grep 'i2p.plugins.firefox/releases/download' README.md | grep i2pfirefox`
 sed -i "s|${READMELINE}|wget https://github.com/eyedeekay/i2p.plugins.firefox/releases/download/${GITHUB_TAG}/i2pfirefox.zip|g" README.md
 sed -i "s|${NUMLINE}|        <property name=\"release.number\" value=\"$GITHUB_TAG\" />|g" build.xml
 edgar && git push --all

src/java/net/i2p/i2pfirefox/I2PFirefox.java

@@ -237,6 +237,21 @@ public class I2PFirefox extends I2PCommonBrowser {
       return FIND_ALL_FIREFOX_SEARCH_PATHS();
     }
   }
+  static File searchFile(File file, String search) {
+    if (file.isDirectory()) {
+      File[] arr = file.listFiles();
+      for (File f : arr) {
+        File found = searchFile(f, search);
+        if (found != null)
+          return found;
+      }
+    } else {
+      if (file.getName().equals(search)) {
+        return file;
+      }
+    }
+    return null;
+  }
   private static String[] NEARBY_FIREFOX_SEARCH_PATHS() {
     // obtain the PLUGIN environment variable
     String plugin = System.getenv("PLUGIN");