https://github.com/thefinn93/signald

An API for Signal. This repo is a mirror, please send issues and contributions to GitLab
https://github.com/thefinn93/signald

signal signal-messenger signald

Last synced: 12 days ago
JSON representation

An API for Signal. This repo is a mirror, please send issues and contributions to GitLab

• Host: GitHub
• URL: https://github.com/thefinn93/signald
• Owner: thefinn93
• License: gpl-3.0
• Created: 2018-01-01T20:41:18.000Z (almost 7 years ago)
• Default Branch: main
• Last Pushed: 2023-03-04T18:42:22.000Z (over 1 year ago)
• Last Synced: 2024-10-14T07:25:51.709Z (26 days ago)
• Topics: signal, signal-messenger, signald
• Language: Java
• Homepage: https://signald.org
• Size: 2.6 MB
• Stars: 154
• Watchers: 8
• Forks: 14
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - thefinn93/signald - An API for Signal. This repo is a mirror, please send issues and contributions to GitLab (others)

README

        
# signald - An (unofficial) Signal Daemon

a daemon that facilitates communication over Signal. It is unofficial, unapproved, and [not nearly as secure as the real Signal clients](https://gitlab.com/signald/signald/-/issues/101)

Signal does not offer any sort of official API. Unlike traditional messaging applications, the Signal server expects the

client software to perform encryption and key management. signald handles all of these client-side requirements and

exposes a plain-text API which can be easily used by developers to build custom Signal clients.

Documentation is available on [signald.org](https://signald.org)

## Installation

* [From source](https://signald.org/articles/install/source/)

* [Debian](https://signald.org/articles/install/debian/)

* [Docker](https://signald.org/articles/install/docker/)

## Usage

When started, signald will create a unix socket file which clients connect to. Clients software uses this socket file to

interact with signald. Most users will want to use an existing [client](https://signald.org/articles/clients/).

Developers wanting to write their own clients should consult the list of [libraries](https://signald.org/articles/libraries/).

Alternatively, build your own library: the socket protocol is documented in a machine-readable format that can be used to

generate libraries. For details, see the [Protocol Documentation](https://signald.org/articles/protocol/documentation/) page.

## Contributing/Questions/Feedback/Bugs

[Issues and MRs are accepted via GitLab.com](https://gitlab.com/signald/signald). There is also an [IRC/matrix channel](https://signald.org/articles/IRC/).

if you have a question, open an issue or come by the channel. Some aspects of signald aren't well documented, don't be afraid to ask "stupid" questions.

## License

This software is licensed under the GPLv3. See `LICENSE` file in this repository.