onionshare/README.md

29 lines
1.7 KiB
Markdown
Raw Normal View History

2014-05-20 15:43:32 -04:00
# OnionShare
2014-05-20 14:22:16 -04:00
2014-08-27 14:44:54 -04:00
[![Build Status](https://travis-ci.org/micahflee/onionshare.png)](https://travis-ci.org/micahflee/onionshare)
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.
2014-05-20 15:43:32 -04:00
Features include:
2014-05-20 15:43:32 -04:00
* 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
2014-05-20 15:43:32 -04:00
2015-06-16 18:00:45 -04:00
If you're interested in exactly what OnionShare does and does not protect against, read the [Security Design Document](/SECURITY.md).
2015-06-16 18:00:45 -04:00
![Client Screenshot](/screenshots/client.png)
![Server Screenshot](/screenshots/server.png)
2014-09-22 20:57:07 -04:00
## Quick Start
Check out [the wiki](https://github.com/micahflee/onionshare/wiki) for information about how to use OnionShare and it's various features.
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](/BUILD.md).