Skip to content

Bot to anonymously send E2EE messages over Signal to a subscriber list.

License

Notifications You must be signed in to change notification settings

Era-Dorta/signalblast

Repository files navigation

signalblast

Signalblast is a tool to send encrypted messages anonymously over Signal to a subscriber list. The sender does not know who the subscribers in the list are, nor the subscribers know who the sender is.

A server is required to host the bot, find instructions on how the set it up below.

The idea for this bot came from Signalboost, which unfortunately is no longer alive.

Usage

Once the bot is up and running, several commands are available:

  • !subscribe send this to sign up to the list
  • !broadcast after subscribing any message preceded by this will be broadcasted to every subscriber
  • !unsubscribe to stop receiving messages
  • !help to be reminded of which commands are available
  • !admin send a message only to the list admin, useful for getting technical support

Installation

  • Install docker.
  • Set up signalbot as specified here
  • Create a python virtual environment
  • Clone the repo git
  • Install with poetry install
  • Run
    • Directly via python -m signalblast.main
    • Via systemd with systemd/signalblast.service
      • Run once with the password in the env file.
      • From there one, the password is stored encrypted and it can be removed from the env file

Roadmap

  • Fix docker deployment
    • Fix the Dockerfile and docker-compose.yaml files
    • Add hodolint to the pre-commit config
    • Build docker images for arm and x86 targets using the github CI
  • Figure out how to use poetry build with the git signalbot dependency
  • Split the bot_answers.py in several files
  • Make instructions clearer and add pictures to the readme