mirror of https://github.com/onionshare/onionshare.git synced 2024-12-28 16:59:35 -05:00

History

Micah Lee ceb705d20f PySide2 does not use QVariant		2020-10-14 14:00:02 -07:00
..
install	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
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
src/onionshare	PySide2 does not use QVariant	2020-10-14 14:00:02 -07:00
tests	Port from PyQt5 to PySide2	2020-10-13 22:28:21 -07:00
.gitignore	Move docs back to root, move onionshare_gui into briefcase app, and make modifications so briefcase app will work	2020-10-13 17:28:54 -07:00
BUILD.md	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
pyproject.toml	Port from PyQt5 to PySide2	2020-10-13 22:28:21 -07:00
README.md	Port from PyQt5 to PySide2	2020-10-13 22:28:21 -07:00

OnionShare Desktop

Building OnionShare

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

Get the source code and change to the desktop folder:

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

OnionShare uses Briefcase.

Install Briefcase dependencies by following these instructions.

Now create and/or activate a virtual environment.

python3 -m venv venv
. venv/bin/activate

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

pip install briefcase

Run OnionShare from the source tree like this:

briefcase dev

Install these packages inside your virtual environment:

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

Then run the tests:

./tests/run.sh