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:

Example:
presscoffee://addcoffee?name=Guatemala%20Bella%20Vista&process=Washed%20and%20Sun-Dried&variety=Bourbon&producer=Luis%20Pedro%20Zelaya%2C%20Bella%20Vista%20Mill&region=Antigua&country=Guatemala&elevation=1540&roaster=Stumptown%20Coffee%20Roasters&roastdate=5%2F24%2F14&brewmethod=Chemex&brewdate=6%2F2%2F14&rating=5&notes=A%20touch%20of%20citrus%20and%20plum%20accent%20a%20cup%20reminiscent%20of%20a%20creamy%2C%20cherry%20and%20vanilla%20cola.

View Map

Base URL:
presscoffee://map

Parameters:
None

Example:
presscoffee://map

Open Brew Recipe

Base URL:
presscoffee://brew

Parameters:

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:

Example:
presscoffee://addrecipe?name=Siphon%20Pot&ratio=17&dose=20&grindname=Medium-Coarse&temperature=205&notes=Produces%20a%20clean%2C%20crisp%20cup%20with%20a%20distinct%20taste.&stages=%5B%7B%22name%22%3A%22Bloom%22%2C%22time%22%3A%2230%22%2C%22notes%22%3A%22Dump%20in%20grounds%2C%20stir%22%7D%2C%7B%22name%22%3A%22Infusion%22%2C%22time%22%3A%2220%22%2C%22notes%22%3A%22Stir%20%26%20cap%22%7D%2C%7B%22name%22%3A%22Drop%22%2C%22time%22%3A%2255%22%2C%22notes%22%3A%22%22%7D%5D