Skip to content

Recipe Buddy is a tool that enables the easy adding of recipes to Grocy through web scraping.

License

Notifications You must be signed in to change notification settings

georgegebbett/recipe-buddy

Repository files navigation

Recipe Buddy

Stand With Ukraine wakatime

Update - April 2024

V2 of Recipe Buddy is here! V2 brings a host of improvements, including:

  • An all-new architecture - SQLIte replaces Mongo and Next.js replaces the massively overkill Nest.js and plain React
  • Can be run in one (1) Docker container - no messing about with compose files
  • A whole new UI

The only thing that hasn't really changed is the recipe scraping logic itself - that is coming (no promises on when though)

The problem

I am getting sick of manually importing recipes into Grocy.

The solution

Overcomplication, naturally. Recipe Buddy is a web app which scrapes web pages for the delicious structured metadata embedded therein.

Once the recipe has been extracted from the page, Recipe Buddy gives you a nice easy means to match each of its ingredients up with a product from your Grocy stock, as well as a quantity unit. Once this is done, you simply hit the ' Add Recipe' button, and the TypeScript goblins painstakingly transcribe the recipe into your Grocy instance, ready for meal planning!

How you can have a go

"Well gee, George, that sounds mighty swell", I hear you say, "but how does little old me go about harnessing the TypeScript goblins for my own recipe-scraping requirements?"

Well, dear reader, as I am a benevolent goblin-wrangler, I have imprisoned them in a poorly written Dockerfile for you! All one needs to do to benefit from the gobliny goodness is as follows:

  1. Generate yourself an auth secret using openssl rand -base64 32
  2. Get the base url of your Grocy instance (everything up to the first /)
  3. Get an API key for your Grocy instance
  4. Run the following command:
    docker run \
     -p 3005:3000 \
     -v rb_data:/home/node/app/data \
     --env GROCY_API_KEY=YOUR_GROCY_API_KEY \
     --env GROCY_BASE_URL=YOUR_GROCY_BASE_URL \
     --env NEXTAUTH_SECRET=YOUR_AUTH_SECRET \
     --env NEXTAUTH_URL=https://localhost:3005 \
     ghcr.io/georgegebbett/recipe-buddy
    

A disclaimer

I am apparently a professional software engineer, however I certainly do not profess to be any good at this stuff. I hereby abdicate any responsibility for the misbehaviour of the TypeScript goblins. If you think you can do better, then open a PR and I will almost certainly merge it without question.

Lots of love, George xoxoxoxo