Git-Mirrors/onionshare
1
0
Fork 0
mirror of https://github.com/onionshare/onionshare.git synced 2024-10-01 01:35:40 -04:00
Code Issues Packages Projects Releases Wiki Activity
Securely and anonymously share files, host websites, and chat with friends using the Tor network
445 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%
5f2aa7272c
Go to file
Micah Lee 5f2aa7272c ignoring source files that get generated in some dev environments
2015-05-14 14:40:19 -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
images moving image files into /usr/share instead of /usr/lib (fixes #126) 2014-09-03 17:50:06 -07:00
locale remove translation disused 2014-09-28 21:53:47 +09:00
onionshare create the ZipFile with allowZip64=True. fixes #173 2015-02-12 17:03:56 -08:00
onionshare_gui pep8: too long lines, reformat lines to < 120 chars. removed redundancy from long_description in setup.py. 2014-11-18 18:59:48 +01:00
setup pep8: too long lines, reformat lines to < 120 chars. removed redundancy from long_description in setup.py. 2014-11-18 18:59:48 +01:00
tails fix typos 2014-10-26 14:40:41 +01:00
test pep8: remove empty lines at EOF 2014-11-18 19:03:31 +01:00
.gitignore ignoring source files that get generated in some dev environments 2015-05-14 14:40:19 -07: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 added code signing with Authenticode support Windows release script (fixes #72) 2014-09-24 14:05:53 -07:00
build_rpm.sh changed gtk deps to qt4 2014-06-20 00:01:03 -04:00
BUILD.md added code signing with Authenticode support Windows release script (fixes #72) 2014-09-24 14:05:53 -07:00
CHANGELOG.md fix typos 2014-10-26 14:40:41 +01:00
check_lacked_trans.py pep8: fix empty line counts 2014-11-18 18:29:32 +01:00
LICENSE added GPLv3 license 2014-05-20 20:56:45 +00:00
MANIFEST.in splits translations into multiple files (#146) 2014-09-19 23:15:20 +00:00
ppa_release.sh added script to publish to PPA 2014-08-22 12:31:46 -07:00
README.md fixed image height 2015-03-24 11:25:54 -04:00
screenshot_receiver.png version bump to 0.6, updated changelog, updated readme, and took new screenshots 2014-09-23 00:51:59 +00:00
screenshot_sender_osx.png fixed image height 2015-03-24 11:25:54 -04:00
screenshot_sender.png version bump to 0.6, updated changelog, updated readme, and took new screenshots 2014-09-23 00:51:59 +00:00
setup.cfg Refactored onionshare 2014-05-23 12:37:10 -03:00
setup.py pep8: too long lines, reformat lines to < 120 chars. removed redundancy from long_description in setup.py. 2014-11-18 18:59:48 +01: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.7dev 2014-09-25 20:08:41 +00: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 hidden 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 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.

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
  • Designed to work in Tails, for high risk users

Sender Screenshot Sender Screenshot OSX Receiver 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. You can also install OnionShare in your Tails persistent volume 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 hidden service.

Open OnionShare and drag and drop files and folders you wish to share, and start the server. It will show you a long, random-looking URL such as http://cfxipsrhcujgebmu.onion/7aoo4nnzj3qurkafvzn7kket7u 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. I recommend you use Off-the-Record encrypted chat to send the URL.

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.