Files
i2p.plugins.tor-updater/index.html
2022-01-31 02:14:28 -05:00

110 lines
6.2 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<title>i2p.plugins.tor-manager - Tor Binary Manager</title>
<link rel="stylesheet" type="text/css" href ="/style.css" />
</head>
<body>
<h1 id="i2p.plugins.tor-updater">i2p.plugins.tor-updater</h1>
<p>A Tor package updater and runner as an I2P Plugin. This plugin is still being changed rapidly but it should be usable on most Linux distributions as of 23 Jan, 2022.</p>
<h2 id="usage">Usage:</h2>
<div class="sourceCode" id="cb1"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true"></a><span class="ex">Usage</span> of ./i2p.plugins.tor-manager:</span>
<span id="cb1-2"><a href="#cb1-2" aria-hidden="true"></a></span>
<span id="cb1-3"><a href="#cb1-3" aria-hidden="true"></a> <span class="ex">-apparmor</span></span>
<span id="cb1-4"><a href="#cb1-4" aria-hidden="true"></a> <span class="ex">Generate</span> apparmor rules</span>
<span id="cb1-5"><a href="#cb1-5" aria-hidden="true"></a> <span class="ex">-arch</span> string</span>
<span id="cb1-6"><a href="#cb1-6" aria-hidden="true"></a> <span class="ex">OS/arch</span> to download (default <span class="st">&quot;64&quot;</span>)</span>
<span id="cb1-7"><a href="#cb1-7" aria-hidden="true"></a> <span class="ex">-bemirror</span></span>
<span id="cb1-8"><a href="#cb1-8" aria-hidden="true"></a> <span class="ex">Act</span> as an in-I2P mirror when you<span class="st">&#39;re done downloading</span></span>
<span id="cb1-9"><a href="#cb1-9" aria-hidden="true"></a><span class="st"> -directory string</span></span>
<span id="cb1-10"><a href="#cb1-10" aria-hidden="true"></a><span class="st"> Directory operate in</span></span>
<span id="cb1-11"><a href="#cb1-11" aria-hidden="true"></a><span class="st"> -host string</span></span>
<span id="cb1-12"><a href="#cb1-12" aria-hidden="true"></a><span class="st"> Host to serve on (default &quot;127.0.0.1&quot;)</span></span>
<span id="cb1-13"><a href="#cb1-13" aria-hidden="true"></a><span class="st"> -i2pbrowser</span></span>
<span id="cb1-14"><a href="#cb1-14" aria-hidden="true"></a><span class="st"> Open I2P in Tor Browser</span></span>
<span id="cb1-15"><a href="#cb1-15" aria-hidden="true"></a><span class="st"> -lang string</span></span>
<span id="cb1-16"><a href="#cb1-16" aria-hidden="true"></a><span class="st"> Language to download</span></span>
<span id="cb1-17"><a href="#cb1-17" aria-hidden="true"></a><span class="st"> -os string</span></span>
<span id="cb1-18"><a href="#cb1-18" aria-hidden="true"></a><span class="st"> OS/arch to download (default &quot;linux&quot;)</span></span>
<span id="cb1-19"><a href="#cb1-19" aria-hidden="true"></a><span class="st"> -port int</span></span>
<span id="cb1-20"><a href="#cb1-20" aria-hidden="true"></a><span class="st"> Port to serve on (default 7695)</span></span>
<span id="cb1-21"><a href="#cb1-21" aria-hidden="true"></a><span class="st"> -shortcuts</span></span>
<span id="cb1-22"><a href="#cb1-22" aria-hidden="true"></a><span class="st"> Create desktop shortcuts</span></span>
<span id="cb1-23"><a href="#cb1-23" aria-hidden="true"></a><span class="st"> -torbrowser</span></span>
<span id="cb1-24"><a href="#cb1-24" aria-hidden="true"></a><span class="st"> Open Tor Browser</span></span>
<span id="cb1-25"><a href="#cb1-25" aria-hidden="true"></a><span class="st"> -verbose</span></span>
<span id="cb1-26"><a href="#cb1-26" aria-hidden="true"></a><span class="st"> Verbose output</span></span></code></pre></div>
<h2 id="status">Status:</h2>
<figure>
<img src="screenshot-console.png" alt="" /><figcaption>Screenshot 2</figcaption>
</figure>
<p>Linux: Usable, most things work. Windows: Unstable, mostly usable, does not work in some important cirumstances, cannot run from a flash drive OSX: Unstable, untested, not usable, WIP.</p>
<p>Other systems are not targeted and should use a Tor binary built from source, provided by TPO or, their prefered package management system and not this plugin. The plugin will not start a Tor instance if a SOCKS proxy is open on port 9050.</p>
<figure>
<img src="screenshot-i2pbrowser.png" alt="" /><figcaption>Screenshot</figcaption>
</figure>
<h3 id="primary-goals">Primary Goals</h3>
<ol type="1">
<li>Ship known-good public keys, download a current Tor for the platform in the background, authenticate it, and launch it only if necessary.</li>
</ol>
<ul>
<li>Works on Windows, Linux, probably also OSX</li>
</ul>
<ol start="2" type="1">
<li>Supervise Tor as a ShellService plugin to I2P</li>
</ol>
<ul>
<li>Works on Linux, Windows</li>
</ul>
<ol start="3" type="1">
<li>Keep Tor up-to-date</li>
</ol>
<ul>
<li>Works on Windows, Linux, probably also OSX</li>
</ul>
<ol start="4" type="1">
<li>Work as an I2P Plugin OR as a freestanding app to be compatible with all I2P distributions</li>
</ol>
<ul>
<li>Works on Linux, Windows</li>
</ul>
<ol start="5" type="1">
<li>Download Tor Browser from an in-I2P mirror(or one of a network of in-I2P mirrors)</li>
</ol>
<ul>
<li>Not done</li>
</ul>
<h3 id="secondary-goals">Secondary Goals:</h3>
<ol type="1">
<li>Launch Tor Browser</li>
</ol>
<ul>
<li>Works on Linux, Windows, maybe OSX</li>
</ul>
<ol start="2" type="1">
<li>Configure and launch Tor browser for use with I2P</li>
</ol>
<ul>
<li>Works on Linux, Windows.</li>
</ul>
<h4 id="optional-features-i-might-add-if-there-is-interest">Optional Features I might add if there is interest</h4>
<ol type="1">
<li>Mirror the files which it downloads to an I2P Site</li>
<li>Mirror the files which it downloads to I2P torrents</li>
<li>Set up an onion site which announces an I2P mirror exists</li>
<li>Use Bittorrent-over-I2P to download the Tor Browser software</li>
</ol>
<h3 id="similar-projects">Similar Projects:</h3>
<ul>
<li>https://github.com/micahflee/torbrowser-launcher</li>
<li>https://github.com/whonix/tb-updater</li>
</ul>
<p><a href="https://www.flaticon.com/free-icons/garlic" title="garlic icons">Garlic icons created by Icongeek26 - Flaticon</a> <a href="https://www.flaticon.com/free-icons/onion" title="onion icons">Onion icons created by Freepik - Flaticon</a></p>
<h3 id="more-screenshots">More Screenshots:</h3>
<ul>
<li><img src="screenshot.png" title="fig:" alt="Screenshot" /></li>
<li><img src="screenshot-dark.png" title="fig:" alt="Screenshot" /></li>
</ul>
</body>
</html>