GoblinShare

First, make sure there is a file at $XDG_CONFIG_HOME/goblins/tor-config.txt with the following content ($XDG_CACHE_HOME should be its actual value, usually /home/<user>/.cache where <user> is your user name):

 DataDirectory $XDG_CACHE_HOME/goblins/tor/data
 SocksPort unix:$XDG_CACHE_HOME/goblins/tor/tor-socks-sock RelaxDirModeCheck
 ControlSocket unix:$XDG_CACHE_HOME/goblins/tor/tor-control-sock RelaxDirModeCheck
 Log notice file $XDG_CACHE_HOME/goblins/tor/tor-log.txt

Then, ensure the requisite directories exist, such as by mkdir -p $XDG_CACHE_HOME/goblins/tor/data.

Finally, run tor -f $XDG_CONFIG_HOME/goblins/tor-config.txt. You should see some textual output. Assuming there are no errors, you can now leave this process running and use GoblinShare.

goblinshare send accepts one argument, the name of a file to send. Assuming you want to share a file called file.txt, that would look like:

 goblinshare send file.txt

This will print the magnet URL for the file, which includes an OCapN URL. Copy that and give it to your intended recipient through your preferred medium.

goblinshare receive also accepts one argument, the magnet URL of the file to download. It can also take one option, -o or --output, whose argument is the name of the file to write out. If we want to receive a file and write it to file.txt, that would look like this, putting a placeholder for the magnet URL for brevity:

 goblinshare receive magnet://... -o file.txt # or --output=file.txt

The standard --help and --version options are also supported.

And that's it! That's GoblinShare in a nutshell!