Skip to content

A Signal chatbot to broadcast Tor bridges in countries where Tor relays are blocked/monitored

License

Notifications You must be signed in to change notification settings

ninofiliu/gettor-bot

Repository files navigation

gettor-bot

A Signal chatbot to broadcast Tor bridges in countries where Tor relays are blocked/monitored

🥇 Ranked 1st at the DemHack 4 hackathon 🥇

Installation

  1. Install signald
  2. Start the signald daemon
  3. Register or link a phone number to signald
  4. Clone this repo, setup the python virtual environment, install deps, and setup the database
    git clone git@github.com:ninofiliu/gettor-bot
    cd gettor-bot
    python -m venv .env
    source .env/bin/activate
    pip install -r requirements.txt
    python setup_db.py

If you encounter

ImportError: cannot import name 'Bot' from 'semaphore'

while installing requirements, build semaphore manually instead

cd path/to/cloned/semaphore
pip install wheel
make build
make install
cd path/to/cloned/gettor-bot
pip install -r requirements.txt

Getting started

Inside the virtual env, run the main script with the phone number you're using with signald

python ./main.py +330123456789

If you encounter permission issues while doing this, add yourself to the signald group and restart your computer:

usermod -a -G signald $(whoami)

About

A Signal chatbot to broadcast Tor bridges in countries where Tor relays are blocked/monitored

Topics

Resources

License

Stars

Watchers

Forks

Languages