Mahlzeit [ˈmaːlˌt͡saɪ̯t] helps you manage your favourite recipes.

To use Mahlzeit, you have to set the RECIPE_HOME variable in the environment where you run it.

$ export RECIPE_HOME=path/to/your/recipe/folder

Mahlzeit allows you to search through your recipes by tags, ingredients and titles. The following, for example, looks for all vegan Asian meals that mention peanut butter in their ingredients.

$ mahlzeit list --ingredient "peanut butter" --tag asian --tag vegan
[satay-noodles] Vegan Satay Noodles *vegan, Asian*
[fried-rice] Easy Vegan Fried Rice *vegan, Asian*

Once you have found the perfect recipe for you, just provide Mahlzeit with number of servings you want. It will take care of the calculations.

$ mahlzeit show fried-rice 4
... RECIPE ...

Note: The output is valid Pandoc markdown, so you can easily pipe it into pandoc -o recipe.pdf to generate a good-looking PDF of your recipe.

In case you want to edit a recipe, just run:

$ mahlzeit edit fried-rice

This should open your favourite editor (the EDITOR environment variable) with the recipe file you specified.

Many recipes online still use a format that was first used by a DOS program called Meal-Master, or MM.EXE. Mahlzeit supports importing from this format. To import, run

$ mahlzeit import <path/to/your/recipe.mm>

If you find the parser having problems with a valid Meal-Master file, open an issue.

For examples, see the examples directory.