onionshare

mirror of https://github.com/onionshare/onionshare.git synced 2024-10-01 01:35:40 -04:00

History

Miguel Jacq d7ce658628 Pin Flask at 1.1.4 to avoid Flask 2.0.0 which requires Jinja2 3.0.0 but the latter of which conflicts with Briefcase		2021-05-17 09:02:47 +10:00
..
onionshare_cli	Use label tag for chat username label, and rename javascript function to checkUsernameTooLong to better reflect its purpose	2021-05-17 08:17:45 +10:00
tests	Move the cleanup() function from Onionshare class to Web class, so that the list of files to be cleaned up is always available (needed for website temp files)	2021-05-04 16:21:42 +10:00
poetry.lock	Pin Flask at 1.1.4 to avoid Flask 2.0.0 which requires Jinja2 3.0.0 but the latter of which conflicts with Briefcase	2021-05-17 09:02:47 +10:00
pyproject.toml	Pin Flask at 1.1.4 to avoid Flask 2.0.0 which requires Jinja2 3.0.0 but the latter of which conflicts with Briefcase	2021-05-17 09:02:47 +10:00
README.md	Update CLI ASCII art in readme	2021-05-03 21:49:42 -07:00
setup.py	Version bump to 2.3.2 and update changelog, and upgrade PySide to 5.15.2	2021-05-03 18:50:01 -07:00

README.md

╭───────────────────────────────────────────╮
│    *            ▄▄█████▄▄            *    │
│               ▄████▀▀▀████▄     *         │
│              ▀▀█▀       ▀██▄              │
│      *      ▄█▄          ▀██▄             │
│           ▄█████▄         ███        -+-  │
│             ███         ▀█████▀           │
│             ▀██▄          ▀█▀             │
│         *    ▀██▄       ▄█▄▄     *        │
│ *             ▀████▄▄▄████▀               │
│                 ▀▀█████▀▀                 │
│             -+-                     *     │
│   ▄▀▄               ▄▀▀ █                 │
│   █ █     ▀         ▀▄  █                 │
│   █ █ █▀▄ █ ▄▀▄ █▀▄  ▀▄ █▀▄ ▄▀▄ █▄▀ ▄█▄   │
│   ▀▄▀ █ █ █ ▀▄▀ █ █ ▄▄▀ █ █ ▀▄█ █   ▀▄▄   │
│                                           │
│          https://onionshare.org/          │
╰───────────────────────────────────────────╯

Installing OnionShare CLI

First, make sure you have tor installed. In Linux, install it through your package manager. In macOS, install it with Homebrew: brew install tor.

Then install OnionShare CLI:

pip install onionshare-cli

Then run it with:

onionshare-cli --help

Developing OnionShare CLI

You must have python3 and poetry installed.

Install dependencies with poetry:

poetry install

To run from the source tree:

poetry run onionshare-cli

To run tests:

poetry run pytest -v ./tests

Build a wheel package

poetry build

This will create dist/onionshare_cli-$VERSION-py3-none-any.whl.