Skip to content
Curses-backed terminal interface for Signal using signal-cli
Python Makefile
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
screenshots readme and screenshots, bugfix Jun 30, 2018
scurses make QR code smaller during setup. fixes #12 Jul 22, 2019
LICENSE Add GPL3 to mirror signal-cli Nov 9, 2018
Makefile split up into separate files Jul 22, 2019
Pipfile drop python version requirement in Pipfile. fixes #15 Aug 3, 2019
Pipfile.lock drop python version requirement in Pipfile. fixes #15 Aug 3, 2019
README.md
main.py

README.md

signal-curses

Curses-backed terminal interface for Signal using signal-cli and npyscreen.

Setup

On Debian-based systems, make install should properly set up the required dependencies.

  • Install signal-cli (see Installation). Because signal-curses depends on JSON output features, only versions of signal-cli >= 0.6.1 will work.
  • Install libunixsocket-java (see DBus service)
  • Install pydbus dependencies, if needed (see Requirements)
  • Install python deps with pipenv install. If pipenv is not installed, run pip3 install pipenv.
  • Run with python3 main.py -u '+12345678901', giving your Signal phone number with country code (e.g. +1)
  • If signal-cli has not been run before, you will be prompted to link your phone with your computer. Scan the given terminal QR code in the Signal app under Settings > Linked Devices, and restart signal-curses. Your contacts and groups should appear, and you should be able to send messages.

Screenshots

Setup dialog

Setup dialog

Link dialog

Link dialog

Setup finished message

Setup finished message

User and group list

User and group list

In-message UI

In-message UI

Ctrl-X menu

Ctrl-X menu

You can’t perform that action at this time.