mirror of
https://github.com/onionshare/onionshare.git
synced 2024-12-26 15:59:48 -05:00
.. | ||
install | ||
screenshots | ||
src/onionshare | ||
tests | ||
.gitignore | ||
BUILD.md | ||
pyproject.toml | ||
README.md |
OnionShare Desktop
Building OnionShare
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
Windows
Prepare the code
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 -d
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