Git-Mirrors/onionshare
1
0
Fork 0
mirror of https://github.com/onionshare/onionshare.git synced 2024-12-28 08:49:30 -05:00
Code Issues Packages Projects Releases Wiki Activity
Securely and anonymously share files, host websites, and chat with friends using the Tor network
668 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%
0bcdad7db2
Go to file
tpltnt 0bcdad7db2 try local import if global fails
2016-09-18 19:29:14 +02:00
git-hooks add push hook that runs test suite 2014-07-03 15:13:39 -07:00
install try local import if global fails 2016-09-18 19:29:14 +02:00
onionshare Move imports to module level 2016-09-06 13:17:55 -07:00
onionshare_gui Sleep between launching threads in onionshare-gui, preventing a cx_Freeze crash related to loading the same modules in multiple threads while they're locked 2016-09-06 13:27:59 -07:00
resources Version bump to 0.9.1, and updated changelog 2016-09-06 10:09:46 -07:00
screenshots Reduced size of screenshots to be more reasonable 2016-04-13 12:37:44 -07:00
test Make sure tests can find the correct paths (fixes #284) 2016-09-05 10:41:20 -07:00
.gitignore Made sure switch to python3 and Qt5 works in OSX (#261). Updated OSX instructions in BUILD.md. 2016-02-12 15:45:26 -08:00
.travis.yml Updated .travis.yml 2016-02-15 23:09:09 -08:00
BUILD.md Migrate from PyInstaller to cx_Freeze for OSX 2016-09-04 19:21:09 -07:00
CHANGELOG.md Add instructions for using CLI version to README, and add supporting Windows/OSX CLI to changelog 2016-09-06 11:56:09 -07:00
LICENSE Update copyright year to 2016 2016-02-15 22:37:28 -08:00
MANIFEST.in Added a simple nautilus extension, written by the Subgraph developers (fixes #293) 2016-06-10 17:56:34 -07:00
README.md Add instructions for using CLI version to README, and add supporting Windows/OSX CLI to changelog 2016-09-06 11:56:09 -07:00
SECURITY.md Stop saying 'hidden service', start saying 'onion service' 2016-09-04 17:23:06 -07:00
setup.cfg Refactored onionshare 2014-05-23 12:37:10 -03:00
setup.py Oops, I can't have a variable called os 2016-09-05 11:06:30 -07:00
stdeb.cfg Added python-nautilus as a dependency (#293) 2016-06-10 18:03:34 -07:00

README.md

OnionShare

Build Status

OnionShare lets you securely and anonymously share files of any size. It works by starting a web server, making it accessible as a Tor onion service, and generating an unguessable URL to access and download the files. 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 onion service to make it temporarily accessible over the internet. The other user just needs to use Tor Browser to download the file from you.

Features include:

  • A user-friendly drag-and-drop graphical user interface that works in Windows, Mac OS X, and Linux
  • Ability to share multiple files and folders at once
  • Support for multiple people downloading files at once
  • Automatically copies the unguessable URL to your clipboard
  • Shows you the progress of file transfers
  • When file is done transferring, automatically closes OnionShare to reduce the attack surface
  • Localized into several languages, and supports international unicode filenames

If you're interested in exactly what OnionShare does and does not protect against, read the Security Design Document.

Client Screenshot Server Screenshot

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.

How to Use

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

Open OnionShare and drag and drop files and folders you wish to share, and click Start Sharing. It will show you a .onion URL such as http://asxmi4q6i7pajg2b.onion/egg-cain 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.

Send this URL to the person you're trying to send the files to. If the files you're sending aren't 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 secret files then it's important to send this URL securely.

The person who is receiving the files 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.

Using the command line version

In Linux: Just run onionshare from the terminal.

In Windows: Add C:\Program Files (x86)\OnionShare to your PATH. Now you can run onionshare.exe in a command prompt.

In Mac OS X: Run ln -s /Applications/OnionShare.app/Contents/MacOS/onionshare /usr/local/bin. Now you can run onionshare from the terminal.