Git-Mirrors/onionshare
1
0
Fork 0
mirror of https://github.com/onionshare/onionshare.git synced 2024-12-27 16:29:41 -05:00
Code Issues Packages Projects Releases Wiki Activity
Securely and anonymously share files, host websites, and chat with friends using the Tor network
351 Commits 21 Branches 45 Tags 57 MiB
Python 95.2%
JavaScript 1.7%
HTML 1.5%
CSS 0.9%
Shell 0.6%
Other 0.1%
c41dc68330
Go to file
Micah Lee c41dc68330 Merge pull request #133 from lazlolazlolazlo/nl 
Update Dutch translation and add missing strings
2014-09-03 14:04:20 -07:00
bin add utf-8 encoding to all .py files 2014-09-02 17:30:01 -07:00
git-hooks add push hook that runs test suite 2014-07-03 15:13:39 -07:00
onionshare Update Dutch translation and add missing strings 2014-09-03 20:26:13 +02:00
onionshare_gui squash bug in closing Flask web server (fixes #131) 2014-09-03 00:11:25 -07:00
setup add utf-8 encoding to all .py files 2014-09-02 17:30:01 -07:00
tails added python-socksipy to tails build 2014-08-30 00:06:02 +00:00
test fixed test_load_strings_loads_other_languages, because french strings were updated 2014-09-02 17:26:59 -07:00
.gitignore Add ctags to gitignore 2014-08-31 15:03:38 -05:00
.travis.yml including pysocks with onionshare, and updated code to use pysocks instead of socksipy (#118) 2014-09-02 17:21:19 -07:00
build_deb.sh starting debian/fedora packaging (#25) 2014-06-10 00:17:02 -04:00
build_dmg.sh wrote build_dmg.sh script, which creates a pretty dmg "drag-to-Applications" installer (#43) 2014-06-25 17:19:19 -07:00
build_exe.bat simplified windows build system, and only include .pyc and not .py in windows installer package 2014-06-26 18:57:28 -04:00
build_rpm.sh changed gtk deps to qt4 2014-06-20 00:01:03 -04:00
BUILD.md simplified windows build system, and only include .pyc and not .py in windows installer package 2014-06-26 18:57:28 -04:00
CHANGELOG.md added 0.5 to changelog 2014-08-20 17:51:03 -07:00
LICENSE added GPLv3 license 2014-05-20 20:56:45 +00:00
MANIFEST.in beginning ServerStatus layout 2014-08-27 16:11:43 -07:00
ppa_release.sh added script to publish to PPA 2014-08-22 12:31:46 -07:00
README.md adding Travis CI status to readme 2014-08-27 11:44:54 -07:00
screenshot.png updated readmes and screenshot to showcase new 0.3 features 2014-06-20 20:12:07 -04:00
setup.cfg Refactored onionshare 2014-05-23 12:37:10 -03:00
setup.py add utf-8 encoding to all .py files 2014-09-02 17:30:01 -07:00
stdeb.cfg including pysocks with onionshare, and updated code to use pysocks instead of socksipy (#118) 2014-09-02 17:21:19 -07:00
version version bump to 0.6dev 2014-08-26 18:39:33 -07:00

README.md

OnionShare

Build Status

OnionShare lets you securely and anonymously share a file of any size with someone. It works by starting a web server, making it accessible as a Tor hidden service, and generating an unguessable URL to access and download the file. It doesn't require setting up a server on the internet somewhere or using a third party filesharing service. You host the file on your own computer and use a Tor hidden service to make it temporarily accessible over the internet. The other user just needs to use Tor Browser to download the file from you.

Screenshot

OnionShare 0.3 is under active development and will be released soon. Features include:

  • A user-friendly GUI interface that works in Windows, Mac OS X, and Linux
  • Automatically copies the unguessable URL to your clipboard
  • Displays log of all requests, so you can see when someone is accessing your OnionShare service, or if someone is trying to guess your secret URL
  • Shows you the progress of the file transfer
  • When file is done transferring, automatically closes OnionShare to reduce the attack surface

Quick Start

You can download OnionShare to install on your computer from https://onionshare.org/.

You can set up your development environment to build OnionShare yourself by following these instructions. You can also install OnionShare in your Tails persistent volume by following these instructions (requires Tails 1.1 or later).

You can also install the command-line only version using pip: sudo pip install onionshare. When 0.3 is released the pip version will no longer be updated.

How to Use

Before you can share a file, you need to open Tor Browser in the background. This will provide the Tor service that OnionShare uses to start the hidden service.

Open OnionShare and browse to find the file you wish to share. It will show you a long, random-looking URL such as http://v645bzpxmdtclpv3.onion/73b44511983c08bf29df40d0b1d00a69 and copy it to your clipboard. This is the secret URL that can be used to download the file you're sharing. If you'd like multiple people to be able to download this file, uncheck the "close automatically" checkbox in the corner.

Send this URL to the person you're trying to send the file to. If the file you're sending isn't very secret, you can use normal means of sending the URL: emailing it, posting it to Facebook or Twitter, etc. If you're trying to send a secret file then it's important to send this URL secrely. I recommend you use Off-the-Record encrypted chat to send the URL.

The person who is receiving the file doesn't need OnionShare. All they need is to open the URL you send them in Tor Browser to be able to download the file.