sn0int-signal

Provides a simple api for the kpcyrd/notify-signal sn0int module.

You need a second phone number to register with signal. A landline number could work for this.

Setup

Make sure you have signal-cli installed, setup, and in your path!

Afterwards install the http api like this:

git clone 'https://github.com/kpcyrd/sn0int-signal'
cd sn0int-signal
cargo install --path .

Usage

sudo install -m 600 -o "$USER" /dev/null /etc/sn0int-signal.key
< /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1 > /etc/sn0int-signal.key
sn0int-signal -k /etc/sn0int-signal.key 127.0.0.1:4321 +31337

Testing

curl -v -H 'Content-Type: application/json' \
    -H "x-signal-auth: $(cat /etc/sn0int-signal.key)" \
    -d '{"to": "+313372", "body": "ohai"}' \
    http://127.0.0.1:4321/api/v0/send

Start on boot

# /etc/systemd/system/sn0int-your-other-service.service

[Unit]
Description=sn0int-signal: api for signal notifications

[Service]
User=your-user
ExecStart=/usr/local/bin/sn0int-signal -k /etc/sn0int-signal.key 127.0.0.1:4321 +31337

License

GPLv3+