i2psnark-launcher
ALPHA version 0.2 2020-05-10
==============================

This is a simple file and URL handler script that stuffs the magnet URL
or torrent file path into i2psnark.

It also checks to see if i2p is running first, and starts it if not.



SUPPORTED PLATFORMS
-------------------

Linux Debian/Ubuntu type systems only.
I2P must be installed either as a debian package,
or as a manual install in $HOME/i2p.

For best results, I2P dev build 0.9.45-18 or higher required.

I2P dev build 0.9.45-18 or higher required for clicking on files.
magnet links will still work, but you have to click on the
'Add Torrent' header in i2psnark to get it to open up.

Browser: It tries first the routerconsole.browser configuration in i2p,
then sensible-browser (it's a debian wrapper script), then firefox.


INSTALLATION
------------

Don't trust me, read the install.sh and i2psnark scripts before
installing them.

If you want to test before running install.sh,
try './i2psnark foo' to see what it does.

To install it, run './install.sh'
It will ask for your sudo password to put it in /usr/bin


USAGE
-----

After installing it, clicking on a .torrent file in nautilus
will ask you if you want to open the file with i2psnark.

In your browser, when you click on a magnet link or torrent file link,
it will ask you what application to open it with.
Browse to /usr/bin and select i2psnark.

All the script does is copy the magnet link or path
to i2psnark "Add Torrent" form.


BUGS
----

Please report bugs and patches on zzz.i2p or http://git.idk.i2p/zzz/i2psnark-launcher

If things go well maybe we'll add this to our installers and packages.

zzz