mirror of https://github.com/onionshare/onionshare.git synced 2024-12-25 15:29:42 -05:00

History

Micah Lee ae621b4001 Change wording of waiting for Tor circuits message		2020-11-29 09:30:45 -08:00
..
package	Add .desktop launchers in both snap and flatpack packages	2020-11-23 20:51:16 -08:00
screenshots	Add onionshare CLI to cli folder, move GUI to desktop folder, and start refactoring it to work with briefcase	2020-10-12 22:40:55 -07:00
scripts	Make OnionShare briefcase work in macOS	2020-11-04 15:57:14 -08:00
src	Change wording of waiting for Tor circuits message	2020-11-29 09:30:45 -08:00
tests	End web thread successfully when cleaning up after a tab, which prevents crashes after running the tests; and fix msi_filename in Windows build script	2020-11-09 19:47:57 -08:00
check_lacked_trans.py	Start writing a proper macOS build script	2020-11-06 08:54:53 -08:00
pyproject.toml	Move psutil dependency from desktop to CLI	2020-11-17 17:45:04 -08:00
README.md	Update desktop readme to include instructions on using verbose mode	2020-11-27 12:16:04 -08:00

README.md

OnionShare Desktop

Building OnionShare

Start by getting the source code and changing to the desktop folder:

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

Install platform-specific dependencies

Linux

If you're using Linux, install tor and obfs4proxy from either the official Debian repository, or from your package manager.

macOS

Download and install Python 3.8.6 from https://www.python.org/downloads/release/python-386/. I downloaded python-3.8.6-macosx10.9.pkg. (You may need to also run /Applications/Python\ 3.8/Install\ Certificates.command.)

Install python dependencies:

pip3 install --user poetry requests

Download Tor Browser and extract the binaries:

./scripts/get-tor-osx.py

Windows

These instructions include adding folders to the path in Windows. To do this, go to Start and type "advanced system settings", and open "View advanced system settings" in the Control Panel. Click Environment Variables. Under "System variables" double-click on Path. From there you can add and remove folders that are available in the PATH.

Download Python 3.8.6, 32-bit (x86) from https://www.python.org/downloads/release/python-386/. I downloaded python-3.8.6.exe. When installing it, make sure to check the "Add Python 3.8 to PATH" checkbox on the first page of the installer.

Download and install 7-Zip from http://www.7-zip.org/download.html. I downloaded 7z1900.exe. Add C:\Program Files (x86)\7-Zip to your path.

Install python dependencies:

pip install poetry requests

Download Tor Browser and extract the binaries:

python scripts\get-tor-windows.py

Prepare the code

In order to work with the desktop app, you'll need to build a wheel of the CLI package first, and copy it into the desktop folder:

cd ../cli
poetry install
poetry build
cp dist/onionshare_cli-*.whl ../desktop
cd ../desktop

OnionShare uses Briefcase.

Install Briefcase dependencies by following these instructions.

Now create and/or activate a virtual environment.

Linux and macOS

python3 -m venv venv
. venv/bin/activate

Windows

python -m venv venv
venv\Scripts\activate.bat

While your virtual environment is active, install briefcase from pip.

pip install briefcase

Run OnionShare from the source tree like this (-d re-installs dependencies, which you'll have to do each time you update the onionshare-cli wheel):

briefcase dev -d

If you want to pass arguments into onionshare, such as to use verbose mode:

cd src
python -c "import onionshare; onionshare.main()" --help

Running tests

Install these packages inside your virtual environment:

pip install pytest pytest-briefcase pytest-faulthandler pytest-qt

Then run the tests:

./tests/run.sh

If you want to run tests while hiding the GUI, you must have the xvfb package installed, and then:

xvfb-run ./tests/run.sh