onionshare/BUILD.md

Building OnionShare

GNU/Linux

Start by getting a copy of the source code:

git clone https://github.com/micahflee/onionshare.git
cd onionshare

For .deb-based distros (like Debian, Ubuntu, Linux Mint):

Note that python-stem appears in Debian wheezy and newer (so by extension Tails 1.1 and newer), and it appears in Ubuntu 13.10 and newer. Older versions of Debian and Ubuntu aren't supported.

sudo apt-get install -y build-essential fakeroot python-all python-stdeb python-flask python-stem python-webkit
./build_deb.sh
sudo dpkg -i deb_dist/onionshare_*.deb

For .rpm-based distros (Red Hat, Fedora, CentOS):

sudo yum install -y rpm-build python-flask python-stem pywebkitgtk
./build_rpm.sh
sudo yum install -y dist/onionshare-*.rpm

Mac OS X

Note: This is a work-in-progress. The OnionShare GUI doesn't yet work in Mac OS X. See https://github.com/micahflee/onionshare/issues/43 for progress.

Get a copy of the source code:

git clone https://github.com/micahflee/onionshare.git
cd onionshare

Install py2app (if you don't have pip installed, you can sudo easy_install pip):

sudo pip install py2app

Then build the .app:

python setup.py py2app

Now you'll see dist/OnionShare.app with a nice icon. However, it won't run yet.

Windows

Note: Haven't started figuring this out yet.