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>

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:

  • 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>

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