An open API service indexing awesome lists of open source software.

https://github.com/kpcyrd/sn0int-signal


https://github.com/kpcyrd/sn0int-signal

Last synced: about 1 year ago
JSON representation

Awesome Lists containing this project

README

          

# 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`](https://github.com/AsamK/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+