URL Scheme
Press has a custom URL scheme allowing for advanced automotion and workflows from other apps. Using special URLs, you can launch Press with all the information for a new coffee entry, share or add new brew recipes, opening a brew recipe, and more. Below are details for all of the supported URL schemes.
Note this feature is intended for the more advanced users, and not for the faint of heart.
A Word About Special Characters
All special characters in the URL parameter values should be URL encoded, sometimes known as percent encoding. For example, "name=Ethiopian Yirgacheffe&process=Sun Dried" becomes "name=Ethiopian%20Yirgacheffe&process=Sun%20Dried" (note the =&? characters separating parameters are not encoded). You can use this tool to quickly encode your parameter values.
Line breaks in notes fields should be represented with \n.
Ex: Strawberry\nTart
Add New Coffee
Base URL:
presscoffee://addcoffee
Parameters:
- name <string>
- process <string> (Adding "Process" is not needed, as Press automatically adds it for you.)
- variety <string>
- producer <string>
- region <string>
- country <string>
- elevation <number/double> (Note ths is a number value only. Please do not add other characters such as º.)
- roaster <string>
- roastdate <string> (format: "11/23/37")
- brewmethod <string>
- brewdate <string> (format: "11/23/37")
- rating <number/double>
- notes <string>
View Map
Base URL:
presscoffee://map
Parameters:
None
Example:
presscoffee://map
Open Brew Recipe
Base URL:
presscoffee://brew
Parameters:
- name <string> (the recipe's exact name)
Example:
presscoffee://brew?name=Chemex
Open "Quick Brew" Recipe
Base URL:
presscoffee://quickbrew
Parameters:
None
Example:
presscoffee://quickbrew
Add Brew Recipe
Base URL:
presscoffee://addrecipe
Parameters:
- name <string>
- ratio <number/double>
- dose <number/double>
- grindname <string>
- grindnumber <number/double>
- temperature <number/double>
- notes <string>
- stages <string> (URL encoded JSON array of objects:)
- name <string>
- time <number/double> (seconds)
- notes <string>