Recipe Box is a desktop recipe manager for organizing your collection using a simple markup language.
- Edit recipes in a custom markup language with syntax highlighting and validation on save.
- Import recipes from any website that supports JSON-LD metadata.
- Use an AI assistant for recipe modifications, with changes shown in a diff view. Bring your own API key. Supports OpenAI, Anthropic, Google, etc.
- Export single recipes or your entire library as beautifully typeset PDFs via Typst.
- Automatic light / dark theme.
- Personalize the application with customizable UI fonts, editor fonts, and color schemes.
- Cross-platform. Runs on macOS, Linux, and Windows.
- BSD-0 licensed.
Download the latest release from the releases page on GitHub.
![]() |
Light Theme |
![]() |
Dark Theme |
![]() |
Preferences |
![]() |
AI Assistant |
![]() |
PDF Export |
The Recipe Box format is a simple, structured way to write recipes in plain text files that's easy for both humans and computers to read and write. A recipe consists of a title, optional metadata, and a series of steps, which can be grouped into named components.
= Classic Brownies
# Melt butter and mix with sugar.
- 1 cup butter
- 2 cups sugar
# Beat in eggs, one at a time.
- 4 eggs
# Fold in cocoa powder and flour.
- 3/4 cup cocoa powder
- 1 cup flour
# Bake 25 minutes at 350°F.
Ingredients are prefixed with a dash (-
) and are listed immediately following the step they belong to.
Steps are marked with a hash symbol (#
).
For more complex recipes, you can use a plus (+
) prefix to create named components.
= Chicken Parmesan
+ Chicken
# Pound chicken breasts thin.
- 4 chicken breasts
# Dip in eggs, then breadcrumbs.
- 2 eggs
- 1 cup breadcrumbs
# Pan fry until golden.
+ Sauce
# Sauté garlic in olive oil until fragrant.
- 3 cloves garlic
- 1 tbsp olive oil
# Add crushed tomatoes and oregano, then simmer.
- 1 can crushed tomatoes
- 1 tsp oregano
Recipe metadata uses YAML frontmatter format with lower_snake_case
keys.
---
prep_time: 20 minutes
cook_time: 45 minutes
servings: 6
---
Metadata must appear at the very beginning of your recipe file.
Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.