User Tools

Site Tools



Keyboard Maestro includes permanently stored dictionaries that you can use or set.

A dictionary is a named set of mappings from a key name to a value. You can have multiple dictionaries, each with their own name (so really, it is a set of mappings from a dictionary name and a key name to a value).

Dictionary names start with a alphabetic character, followed by any number of alphanumeric, space or underscores. Dictionary names are case insensitive.

Key names can be anything, although leading and trailing white space is stripped off. Key names are case insensitive.

Dictionary values are plain text and can include leading or trailing white space.

For example, you might have a dictionary named “Shop Prices”, with keys being the item names and values being the cost of the item.

Shop Prices
Shop Prices
Shop Prices

Setting Dictionary Values

Use the Set Dictionary Value action to set a dictionary value.

Accessing Dictionary Values

You can use the %Dictionary% token to access Dictionary values.

You can list the dictionaries with the Dictionaries collection, and you can list all the keys within a dictionary with the Dictionary Keys collection.


You can read and write dictionary values from AppleScript.

tell application "Keyboard Maestro Engine"
	name of dictionaries
end tell
tell application "Keyboard Maestro Engine"
	dictionary keys of dictionary "First Names"
end tell
tell application "Keyboard Maestro Engine"
	set value of dictionary key "P" of dictionary "First Names" to "Fred"
end tell

See Also

See also the Set Dictionary Value action, the %Dictionary% token and the Dictionaries and Dictionary Keys collections.

manual/Dictionaries.txt · Last modified: 2017/10/05 23:02 by peternlewis