# go-threema

[![Go Reference](https://pkg.go.dev/badge/git.sr.ht/~bfiedler/go-threema.svg)](https://pkg.go.dev/git.sr.ht/~bfiedler/go-threema)
[![builds.sr.ht status](https://builds.sr.ht/~bfiedler/go-threema/commits/.build.yml.svg)](https://builds.sr.ht/~bfiedler/go-threema/commits/.build.yml?)

Go bindings for [gateway.threema.ch](https://gateway.threema.ch)

Threema Gateway is a paid service allowing you to write messages to and receive
messages from other Threema accounts using a dedicated Gateway account. For more
information see the [Threema.Gateway website](https://gateway.threema.ch).

## Features

The following features are supported:

 - [x] Lookup Threema IDs by phone/email
 - [x] \(E2E-only) Lookup public keys by ID
 - [x] Sending text messages to Threema IDs / phone numbers / e-mail addresses
 - [x] Querying receiver capabilities
 - [x] Uploading blobs (prerequisite for sending images, videos and files)

The following features are not (yet) supported:

 - [ ] Sending images
 - [ ] Sending videos
 - [ ] Sending files
 - [ ] Receiving messages
 - [ ] Integration tests

## tcli

The `tcli` binary provides basic gateway functionality. It is currently ran as
pseudo-integration test as running real integration tests against the live
gateway server costs credits (and thus money).

## License

This project is licensed under the 3-clause BSD license.