Enigma2


Schemes	`enigma2://`, `enigma2s://`
Cargo feature	`service-enigma2`
Service	https://dreambox.de/
Body formats	`text` (first is the default)
Attachments	no
Title length	no title (merged into the body)
Body length	1,000 characters
Body lines	unlimited
Request throttle	500 ms between requests
Vendor URLs accepted	no

URL formats

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

{schema} is one of enigma2://, enigma2s://.

URL tokens

Token	Meaning	Type	Required	Notes
`{fullpath}`	Path	string	no
`{host}`	Hostname	string	yes
`{password}`	Password	string	no	secret
`{port}`	Port	int, 1 to 65535	no
`{user}`	Username	string	no

Query parameters

Parameter	Meaning	Type	Default	Notes
`timeout`	Server Timeout	int, min -1	`13`

Prefixed parameters:

+name=value: HTTP 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):

enigma2://localhost
enigma2s://localhost
enigma2://user@localhost
enigma2://localhost/a/b%20c/
enigma2s://localhost:8080/path/
enigma2://localhost?timeout=30
enigma2://user@localhost?timeout=-1
enigma2://localhost:8080/path?+HeaderKey=HeaderValue&+User-Agent=Custom

Rejected URLs:

enigma2://:@/
enigma2://
enigma2s://

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'enigma2://localhost'

Notes

Enigma2 (enigma2://, enigma2s://): on-screen messages on Enigma2 set-top boxes through their web API.