summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMicah Lee <micah@micahflee.com>2014-05-22 14:35:39 -0400
committerMicah Lee <micah@micahflee.com>2014-05-22 14:35:39 -0400
commitf57207200ef4fc2258e15f3dc23b4e8cac7eccd9 (patch)
tree3498b630d2c0aa49a7413163de054613c92a3a0e /README.md
parent8b55df55c834c57c90a3cfa3c92b7eb2e61cc396 (diff)
downloadonionshare-f57207200ef4fc2258e15f3dc23b4e8cac7eccd9.tar.gz
onionshare-f57207200ef4fc2258e15f3dc23b4e8cac7eccd9.zip
updated readme about using in Windows (#6)
Diffstat (limited to 'README.md')
-rw-r--r--README.md24
1 files changed, 23 insertions, 1 deletions
diff --git a/README.md b/README.md
index eed6541b..2a7d29df 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@ OnionShare lets you securely and anonymously share a file of any size with someo
## Quick Start
-At the moment OnionShare is a command line program. It works in normal desktop GNU/Linux distributions, Tails, and Mac OS X (Windows coming soon). To get started, either git clone the onionshare repository or [download this zip file](https://github.com/micahflee/onionshare/archive/master.zip) and extract it. Open a terminal and navigate to the onionshare directory.
+At the moment OnionShare is a command line program. It works in Mac OS X, GNU/Linux, and Windows (see special Windows and Tails instructions below). To get started, either git clone the onionshare repository or [download this zip file](https://github.com/micahflee/onionshare/archive/master.zip) and extract it. Open a terminal and navigate to the onionshare directory.
OnionShare relies on Tor. You need to either have a system Tor installed (`sudo apt-get install tor`), or you can open Tor Browser so that OnionShare can use the Tor server provided there. Start Tor, and then run `onionshare.py`, passing in the file that you want to share, like this:
@@ -26,6 +26,28 @@ OnionShare relies on Tor. You need to either have a system Tor installed (`sudo
Securely send the URL to the person you are sending the file to (like by using Jabber and OTR). When they load the website in Tor Browser, they will be connecting directly to your computer to download the file. Once you confirm that they have downloaded the file you're sending (ask them if they have the file), press Ctrl-C to shut down the server.
+## Using OnionShare in Windows
+
+OnionShare isn't properly packaged for Windows yet. This mean you'll need to install Python 2.x yourself. [Download the latest 2.x version of python](https://www.python.org/downloads/) for your architecture and install it. Your python binary should be something like `C:\Python27\python.exe`.
+
+Since OnionShare is a command line program, and using it involves copying and pasting a URL from a command prompt window, it's less frusturating if you use the Windows PowerShell rather than the Command Prompt (in PowerShell, select text you want to copy and then right-click to copy it onto the clipboard). But you can use either. Open either PowerShell or a Command Prompt, cd to your onionshare folder, and run `python.exe onionshare.py` with the path to the file you want to share. For example:
+
+ PS C:\Users\user\Desktop\onionshare> C:\Python27\python.exe onionshare.py C:\Users\user\Desktop\secrets.pdf
+ Connecting to Tor ControlPort to set up hidden service on port 40867
+
+ Give this URL to the person you're sending the file to:
+ http://nkcdw6bgokit3tcn.onion/912d927863347b7b97f7a268a4210694
+
+ Press Ctrl-C to stop server
+
+ * Running on http://127.0.0.1:40867/
+ 127.0.0.1 - - [22/May/2014 11:30:55] "GET /912d927863347b7b97f7a268a4210694 HTTP/1.1" 200 -
+ 127.0.0.1 - - [22/May/2014 11:30:57] "GET /favicon.ico HTTP/1.1" 404 -
+ 127.0.0.1 - - [22/May/2014 11:30:57] "GET /favicon.ico HTTP/1.1" 404 -
+ 127.0.0.1 - - [22/May/2014 11:30:59] "GET /favicon.ico HTTP/1.1" 404 -
+ 127.0.0.1 - - [22/May/2014 11:31:02] "GET /912d927863347b7b97f7a268a4210694/download HTTP/1.1" 200 -
+ 127.0.0.1 - - [22/May/2014 11:31:14] "GET /912d927863347b7b97f7a268a4210694/download HTTP/1.1" 200 -
+
## Using OnionShare in Tails
You need to run OnionShare as root in Tails, so make sure you set an administrator password when you boot Tails. Follow the same instructions as above, except run `onionshare-tails` instead of `onionshare.py`, and run it with sudo like this: