joinpython 1.0.2

The Config File

Sample config file:

{
    "version": "VERSION",
    "apikey": "YOUR_API_KEY",
    "default_device": "Phone",
    "contacts": {
        "Name 1": "5555555555"
    },
    "devices": {
        "Phone": "PHONE_DEVICE_ID",
        "Tablet": "TABLET_DEVICE_ID"
    }
}

Contacts Setup

{
    "Name 1": "5555555555",
    "Name 2": "(555) 555-5555",
    "Name 3": "+1 555.555.5555"
}

--smscontactname can be used instead of contact setup, but contact setup is still required for --callnumber and --smsnumber

Irregularities

• The deviceNames parameter is used when --deviceId is given a comma separated list of names. deviceIds is never used.

• Including a comma anywhere in the --deviceId parameter will force it to use deviceNames, even if you only list one device. join.py -d Phone -c test won’t work without a config file, but join.py -d Phone, -c test will.

• --deviceId can take device names (with a config file or comma), groups (group.android, group.all, etc.), or use an ID directly.

• --deviceId can be ommitted if you provide a default device in the config file.

• --apikey can take an API key or be ommitted to use the key in the config file.

• --generateURL prints the Join API URL without actually calling it.

• --config allows you to choose what config file to use

As a module

#!/usr/bin/env python3
import joinpython
args = {
    "deviceId": "DEVICE_ID_HERE",
    "apikey": "API_KEY_HERE",
    "clipboard": "Clipboard Text",
    "find": True
}
response = joinpython.request(args)