Skip to content

paulgasbarra/recipeasy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🍲 Recipeasy — A Minimalist Chrome Extension for Clean Recipe Extraction

Recipeasy is a lightweight Chrome extension that extracts publicly available JSON-LD recipe metadata (title, image, ingredients, and instructions) from any webpage and displays it in a clean, scrollable, and printable format.

Many recipe sites bury structured data behind extended text, layers of pop-ups, ads, and scripts.
This extension simply surfaces the recipe metadata already published for SEO, giving users a clear view of what they’re cooking — no scraping, no paywall bypassing, no content redistribution.

Screen.Recording.2025-12-05.at.10.07.33.AM.mov

✨ Features

  • 🔍 Automatic JSON-LD detection
    Works on any site that publishes a <script type="application/ld+json"> recipe block.

  • 🍽 Extracts:

    • Recipe title
    • Main photo (if available)
    • Ingredient list
    • Step-by-step instructions
  • 🇺🇸/🇬🇧 Converts from US to Metric
    One click turns cups to grams for precision cooking.

  • 🖨 One-click Print Mode
    Opens a clean, typography-friendly print layout with the recipe nicely formatted.

  • 📜 Sticky header + scrollbar
    The recipe title, conversion button, and print button stay visible while scrolling.

  • 💻 All processing happens locally
    No servers, no analytics, no data collection.


🚀 Installation (Developer Mode)

  1. Clone or download this repository.
  2. Open Chrome and visit: chrome://extensions
  3. Enable Developer mode (toggle in the top right).
  4. Click Load unpacked.
  5. Select this project folder.

The extension icon will appear in your toolbar.
Navigate to a recipe site, click the icon, and voilà — clean recipe view.


🧠 How It Works

Recipeasy looks for:

<script type="application/ld+json">
  ...
</script>

If it contains a "@type": "Recipe" block, the extension:

Parses the JSON-LD

Extracts standard schema.org fields

Displays them in the popup UI

Allows printing via a custom print template

It does not scrape HTML or bypass paywalls. It only reads structured metadata explicitly exposed by the website.

Sites it works on:


🔒 Disclaimer

This project is not affiliated with or endorsed by any recipe website including any of the ones listed above.

Recipeasy:

Does not store or redistribute copyrighted recipe content

Does not circumvent paywalls

Only displays structured metadata that websites voluntarily publish for SEO

Users are responsible for complying with the content policies of each site.

All recipe copyrights belong to their respective owners.


🧑‍🍳 Motivation

I built this extension because I love cooking — and I love clean data.

So many recipe sites publish beautifully structured JSON-LD behind the scenes that never makes it to the user’s eyes. This extension is a simple way to reveal that data and make cooking easier.


🌟 Future Ideas (PRs welcome!)

Ingredient normalization & scaling (2x, ½x)

Grocery list generation

Dark mode

AI-assisted recipe summaries or substitutions

About

A browser extension that cuts through the crud and gives you the recipe you seek.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors