Utility Functions

Some useful utility functions.

Hashing functions

local md5_hash = mympd.hash_md5(string)
local sha1_hash = mympd.hash_sha1(string)
local sha256_hash = mympd.hash_sha256(string)

Parameters:

PARAMETER	TYPE	DESCRIPTION
string	string	String to hash

HTML encoding

local encoded = mympd.htmlencode(string)

Parameters:

PARAMETER	TYPE	DESCRIPTION
string	string	String to encode

URL encoding and decoding

local encoded = mympd.urlencode(string)
local decoded = mympd.urldecode(string, form_url_decode)

Parameters:

PARAMETER	TYPE	DESCRIPTION
string	string	String to encode/decode
form_url_decode	boolean	Decode as form url

Logging

Logs messages to the myMPD log. You can use the number or the loglevel name.

mympd.log(loglevel, message)

-- This is the same
mympd.log(5, message)
mympd.log("LOG_NOTICE", message)

Parameters:

PARAMETER	TYPE	DESCRIPTION
message	string	Message to log
loglevel	number or string	Syslog log level

LOGLEVEL	NUMBER	DESCRIPTION
LOG_EMERG	0	Emergency
LOG_ALERT	1	Alert
LOG_CRIT	2	Critical
LOG_ERR	3	Error
LOG_WARNING	4	Warning
LOG_NOTICE	5	Notice
LOG_INFO	6	Informational
LOG_DEBUG	7	Debug

Notifications

-- Send a notification to the client that has started the script
mympd.notify_client(severity, message)

-- Send a notification to all clients in the partition from which the client started the script
mympd.notify_partition(severity, message)

Parameters:

PARAMETER	TYPE	DESCRIPTION
severity	number or string	Severity
message	string	Message to send.

SEVERITY	NUMBER	DESCRIPTION
SEVERITY_INFO	0	Informational
SEVERITY_WARNING	1	Warning
SEVERITY_ERR	2	Error

Read an ascii file

local content = mympd.read_file(path)

Parameters:

PARAMETER	TYPE	DESCRIPTION
path	string	Filepath to open and read.

Sleep

mympd.sleep(ms)

Parameters:

PARAMETER	TYPE	DESCRIPTION
ms	positive number	Milliseconds