python-thr's Introduction

Thr

A small Threema Gateway library that focuses on easy usage.

Functionality

Send text messages
Send files
Lookup contacts
Receive messages

Usage

First, initialize the API without own API secrets.

threema = thr.Threema(
    identity="*MYIDENT", 
    key='717b1fb0f3e6888454f21a012cec6be6181a308ce89f4a733869848fd6ed74bb', 
    secret='w2kdj25yh1Ep81oP')

Lookup Contacts

In order to send end-to-end encrypted messages, you need the public key of the recipient. If you don't have it you can look-up the public key using the threema ID:

contact = threema.lookup("FMD1R5RX")

Send a Text Message

There is a shorthand function to send text messages:

threema.send_text_message(recipient=contact, content="Hello!")

The more verbose way would be to first, create a TextMessage and afterwards send it:

message = TextMessage("Hello!")
threema.send_message(recipient=contact, message=message)

Send a File

If you want to send a file with a thumbnail attached, you have to upload the thumbnail as well. The key must be the same, as the one for the file.

# Upload the file
message = threema.upload_file(filename="image.jpg")

# Optionally upload a thumbnail
with open("thumbnail.jpg", "rb") as thumnail_file:
    thumbnail_content = thumnail_file.read()
message.thumbnail_blob_id = threema.upload_thumbnail(thumbnail_content, key=message.key)

# Send the message
threema.send_message(
    message=message, 
    recipient=contact)

Recommend Projects