Delta Chat


Schemes	`deltachat://`, `deltachats://`
Cargo feature	`service-deltachat`
Service	https://delta.chat/
Body formats	`text` (first is the default)
Attachments	yes
Title length	no title (merged into the body)
Body length	32,768 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{host}
{schema}://{host}:{port}
{schema}://{host}:{port}/{targets}
{schema}://{host}/{targets}
{schema}://{user}@{host}
{schema}://{user}@{host}/{targets}
{schema}://{user}@{host}:{port}
{schema}://{user}@{host}/{targets}
{schema}://{user}@{host}:{port}/{targets}
{schema}://{user}:{password}@{host}
{schema}://{user}:{password}@{host}/{targets}
{schema}://{user}:{password}@{host}:{port}
{schema}://{user}:{password}@{host}:{port}/{targets}

{schema} is one of deltachat://, deltachats://.

URL tokens

Token	Meaning	Type	Required	Notes
`{host}`	Domain	string	yes
`{password}`	Password	string	no	secret
`{port}`	Port	int, 1 to 65535	no
`{target_email}`	Target Email	string	no
`{targets}`	Targets	list	no	any of `target_email`; separated by `/`
`{user}`	User Name	string	no

Query parameters

Parameter	Meaning	Type	Default	Notes
`bcc`	Blind Carbon Copy	list		separated by `,` or space
`cc`	Carbon Copy	list		separated by `,` or space
`from`	From Email	string
`inline`	Inline Attachments	bool	`no`
`mode`	Secure Mode	choice	`starttls` (usually; depends on the URL)	one of `starttls`, `ssl`, `insecure`
`name`	From Name	string
`pgp`	PGP Security Mode	choice	`no`	one of `no`, `sign`, `encrypt`; `sign`: Ed25519 or RSA (2048 to 8192 bits) private key; `encrypt`: cv25519 or RSA public key; without the `service-deltachat-pgp` feature a PGP mode fails with `Unsupported`
`pgpprv`	PGP Private Key Path	string		secret; path, `file://` or `http(s)://`; default: the storage folder
`pgppub`	PGP Public Key Path	string		secret; path, `file://` or `http(s)://`; default: the storage folder
`reply`	Reply To	list		separated by `,` or space
`smtp`	SMTP Server	string
`to`	To Email	string
`wkd`	Web Key Directory	bool	`no`

Prefixed parameters:

+name=value: Email Header

The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.

Examples

Accepted URLs (tokens are fake):

deltachat://user:pass@smtp.example.com/friend@example.org
deltachats://user:pass@smtp.example.com/friend@example.org
deltachats://user:pass@smtp.example.com/friend@example.org?format=html
deltachats://user:pass@smtp.example.com/friend@example.org?cc=other@example.org&+X-Extra=1

Rejected URLs:

deltachat://
deltachat://user:pass@smtp.example.com/friend@example.org?pgp=invalid

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'deltachat://user:pass@smtp.example.com/friend@example.org'

Delta Chat (deltachat://, deltachats://): messages to Delta Chat users as e-mail, delivered with a Chat-Version: 1.0 header, plain-text bodies and a Chat: <excerpt> subject built from the body (the title is merged into the body).

Differences with Apprise

PGP works as for email (feature service-deltachat-pgp), with the subject Chat: when signing and Chat: Encrypted message when encrypting, the Autocrypt header and key generation included.

Keyboard shortcuts