mirror of https://github.com/onionshare/onionshare.git synced 2024-12-25 07:19:41 -05:00

History

Micah Lee a5f97b6c88 Version bump to 2.4.1		2022-01-16 16:06:29 -08:00
..
onionshare	Merge branch 'connect_to_tor_emitted_on_persistent_tabs' of https://github.com/mig5/onionshare into mig5-connect_to_tor_emitted_on_persistent_tabs	2022-01-16 14:23:52 -08:00
package	Codesign .dylib files too, and properly delete unused PySide2 files	2022-01-16 13:25:05 -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	Continue switching from briefcase to poetry	2021-12-19 17:33:11 -08:00
tests	Test javascript MIME type in different modes	2021-12-17 17:59:34 +11:00
org.onionshare.OnionShare.appdata.xml	Version bump to 2.4.1	2022-01-16 16:06:29 -08:00
org.onionshare.OnionShare.desktop	Move the rest of the desktop files out of the src folder	2021-12-19 17:33:00 -08:00
org.onionshare.OnionShare.svg	Move the rest of the desktop files out of the src folder	2021-12-19 17:33:00 -08:00
poetry.lock	Support cx_Freeze in macOS	2021-12-22 12:04:44 -08:00
pyproject.toml	Version bump to 2.4.1	2022-01-16 16:06:29 -08:00
README.md	Delete unused Qt5 files after Windows build	2021-12-23 11:49:43 -08:00
setup-freeze.py	Finish packaging and code signing for Mac	2022-01-13 15:13:03 -08:00
setup.py	Start implementing cx_Freeze	2021-12-21 14:16:10 -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/onionshare/onionshare.git
cd onionshare/desktop

Make sure you have Python 3 installed. If you're using Windows or macOS, install version 3.9.9 from python.org. For Windows, make sure to install the 32-bit (x86) version, and to check the box to add python to the path on the first page of the installer.

Make sure you have poetry installed, and then install the dependencies:

poetry install

Install platform-specific dependencies

Linux

In Ubuntu 20.04 you need the libxcb-xinerama0 package installed.

Download Tor Browser and extract the binaries:

poetry run ./scripts/get-tor-linux.py

macOS

Download Tor Browser and extract the binaries:

poetry run ./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 and install 7-Zip from https://7-zip.org/download.html. I downloaded 7z1900.exe. Add C:\Program Files (x86)\7-Zip to your path.

Download Tor Browser and extract the binaries:

poetry run python scripts\get-tor-windows.py

Compile dependencies

Install Go. The simplest way to make sure everything works is to install Go by following these instructions. (In Windows, make sure to install the 32-bit version of Go, such as go1.17.5.windows-386.msi.)

Download and compile meek-client:

./scripts/build-meek-client.py

Running OnionShare from the source code tree

To run OnionShare from the source tree:

poetry run onionshare
poetry run onionshare --help
poetry run onionshare -v
poetry run onionshare -v --local-only

You can also run onionshare-cli from the source tree, and it will look for Tor binaries in desktop/onionshare/resources/tor.

poetry run onionshare-cli --help

Running tests

Run the tests:

poetry run ./tests/run.sh

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

xvfb-run poetry run ./tests/run.sh