Skip to content
Securely and anonymously send and receive files
Branch: develop
Clone or download
micahflee Merge pull request #941 from mig5/configurable_connect_timeout
Allow the bundled Tor connection timeout to be configurable from the CLI
Latest commit c102364 Mar 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Reorder args when running tests in CircleCI Jan 18, 2019
.github Add @mig5 as a code owner for all tests, and add @emmapeel2 as a code… Sep 28, 2018
apparmor Improve AppArmor profiles and enforce them. Jan 18, 2017
dev_scripts Delete obsolete dev_scripts/run_all_tests.sh script, and add xvfb-run… Oct 25, 2018
git-hooks Remove references to nosetests, and replace them with pytest Jul 9, 2017
install Unhardcode linux launcher icon Mar 2, 2019
onionshare Merge pull request #941 from mig5/configurable_connect_timeout Mar 23, 2019
onionshare_gui
screenshots Update share mode screenshots too Feb 18, 2019
share Merge pull request #941 from mig5/configurable_connect_timeout Mar 23, 2019
tests Merge pull request #935 from mig5/fix_receive_mode_folder_collision Mar 23, 2019
.gitignore
BUILD.md Remove python3-distutils from BUILD.md as well Feb 21, 2019
CHANGELOG.md
LICENSE
MANIFEST.in
README.md Tweak readme install language Feb 20, 2019
setup.cfg
setup.py
stdeb.cfg

README.md

OnionShare

OnionShare is an open source tool for securely and anonymously sending and receiving files using Tor onion services. It works by starting a web server directly on your computer and making it accessible as an unguessable Tor web address that others can load in Tor Browser to download files from you, or upload files to you. It doesn't require setting up a separate server, using a third party file-sharing service, or even logging into an account.

Unlike services like email, Google Drive, DropBox, WeTransfer, or nearly any other way people typically send files to each other, when you use OnionShare you don't give any companies access to the files that you're sharing. So long as you share the unguessable web address in a secure way (like pasting it in an encrypted messaging app), no one but you and the person you're sharing with can access the files.

Documentation

To learn how OnionShare works, what its security properties are, and how to use it, check out the wiki.

Installing OnionShare

You can download OnionShare for Windows and macOS from the OnionShare website.

For macOS you can also use Homebrew:

brew cask install onionshare

For Ubuntu-like Linux distributions, you can use this PPA:

sudo add-apt-repository ppa:micahflee/ppa
sudo apt install -y onionshare

OnionShare may also be available in your Linux distribution's package manager. Check this wiki page for more information.

Contributing to OnionShare

You can set up your development environment to build OnionShare yourself by following these instructions. You may also subscribe to our mailing list here, and join our public Keybase team here.

Test status: CircleCI

Screenshots

Share mode OnionShare

Share mode Tor Browser

Receive mode OnionShare

Receive mode Tor Browser

You can’t perform that action at this time.