MealieShopper
Installeren

Voor wie kookt met Mealie

Van recept naar geregeld.

MealieShopper leest je weekmenu uit Mealie, zoekt elk ingrediënt op bij Albert Heijn, Picnic, Jumbo of Crisp en zet de boodschappen na jouw controle in je mandje. Bestellen doe je zelf.

Installeren Bekijk op GitHub
  • Gratis en open source
  • Draait op je eigen server
  • Geen account, geen tracking
  • Nederlands en Engels
MealieShopper op een computer en een telefoon: het weekmenu met plaatjes uit Mealie, de porties per maaltijd en Toevoegen bij elke dag Vergroot de afbeelding Het weekmenu in het donkere thema, op een computer en een telefoon Vergroot de afbeelding
  • Albert Heijn
  • Picnic
  • Jumbo
  • Crisp
  • Mealie
  • HelloFresh
  • Marley Spoon

MealieShopper is onofficieel en heeft geen band met Mealie of deze winkels.

Zo werkt het

Plannen, controleren, klaar

Een weekmenu plannen in Mealie is fijn, maar daarna begint het overtypen: elk ingrediënt opzoeken bij je supermarkt, uitrekenen hoeveel verpakkingen je nodig hebt en nagaan of de aanbieding echt goedkoper is. Dat doet MealieShopper voor je.

  1. Plan je week

    Zet een recept of een notitie op een dag, in Mealie of in MealieShopper. Weet je het niet? Dan kiest Verras me een recept. Elke wijziging staat meteen in Mealie.

  2. Eén knop voor je boodschappen

    MealieShopper zoekt per ingrediënt de beste producten bij je winkel, rekent porties om naar verpakkingen en telt hetzelfde ingrediënt uit verschillende recepten bij elkaar op.

  3. Jij controleert, jij bestelt

    Je ziet eerst een lijst met de prijs per kilo, en waar de app twijfelt staat een markering. Pas na je bevestiging gaat alles in je mandje. Er wordt nooit een bestelling geplaatst.

Functies

Alles tussen recept en kassabon

Je weekmenu, je supermarkten en je recepten op één plek, voor je hele huishouden.

Weekmenu naar mandje

Je hele week in één keer in je mandje

Eén knop zoekt voor elk ingrediënt uit je weekmenu de beste producten. Je controleert alles in een lijst voordat het in je mandje gaat.

  • Porties en verpakkingen uitgerekend
  • Hetzelfde ingrediënt uit meerdere recepten opgeteld
  • Is een andere verpakking per kilo goedkoper, dan zie je dat meteen
  • Met Liever biologisch eerst het biologische product, als de winkel het heeft
Controleer je mandje: per ingrediënt een foto van het product, het product met de prijs per kilo en het aantal verpakkingen; bij spaghetti staat dat 1 kg per kilo goedkoper is, met de knop Kies, en een regel is gemarkeerd Vergroot de afbeelding

Weekmenu plannen

Plan je maaltijden zoals jij dat wilt

Zet een recept of een notitie op een dag, of verplaats en verwijder een maaltijd. Alles gaat meteen naar Mealie.

  • Je recepten uit Mealie, met plaatjes en porties
  • Verras me laat Mealie een recept kiezen
  • Plan je volgende week, dan zie je ook de aanbiedingen van volgende week
Maaltijd plannen: de dag, de maaltijd, de keuze tussen Recept en Notitie, je recepten uit Mealie en de knop Verras me Vergroot de afbeelding

Aanbiedingen

Is het echt een aanbieding?

De aanbiedingen van Albert Heijn (ook je persoonlijke Bonus Box), Picnic, Jumbo en Crisp, elke dag bijgewerkt en met een eerlijk oordeel.

  • De prijs per kilo, liter of stuk bij elke aanbieding
  • Een oordeel tegen de gewone prijs van de laatste 30 dagen
  • De Prijsgeschiedenis toont ook wat je zelf betaalde
  • Vergelijk verpakkingen wijst de goedkoopste aan
Het tabblad Aanbiedingen: de categorieën en de producten met hun actie, de prijs per kilo of liter, een kortingsbadge in kleur, een prijslabel als Laagste prijs ooit en de links Vergelijk verpakkingen en Prijsgeschiedenis Vergroot de afbeelding

Recepten

Zoek overal tegelijk, plan met één klik

Zoek in je eigen recepten in Mealie en tegelijk bij Albert Heijn, Jumbo, Picnic en Crisp en in de menu's van HelloFresh en Marley Spoon.

  • Bekijk een recept en plan het meteen in
  • Importeer een recept via een link
  • Zet je bewaarde AH-recepten en Jumbo-receptenlijsten in één keer in Mealie
Recepten zoeken naar kip: bovenaan je eigen recepten in Mealie, als kaarten met tijd, porties en tags Vergroot de afbeelding

Je winkels

Je winkels op één plek

Je mandje, lijstjes, bewaarde recepten, favorieten, bestellingen en AH-kassabonnen, in een eigen kopie die je doorzoekt. Ook als de winkel even niet meewerkt.

  • Wanneer kocht je voor het laatst koffie? Zoek het op
  • Een bonregel die de app niet kent, koppel je zelf aan een product
  • Je aankopen per categorie, met wat je bespaarde
De aankopen als kaarten: per bestelling of kassabon een collage van vier productfoto's, de datum, de soort met een gekleurde streep, het aantal producten, het bedrag en het bespaarde bonusbedrag Vergroot de afbeelding

AI-assistenten

Vraag het je AI-assistent

Met de ingebouwde MCP-server bekijken Claude, ChatGPT of Copilot je weekmenu, recepten en lijstjes, plannen ze een maaltijd of importeren ze een recept in Mealie.

  • Inloggen met OAuth, met je eigen account
  • De assistent werkt alleen met jouw rechten
  • De beheerder zet de MCP-server aan of uit
Profiel, AI-apps: het adres van de MCP-server en uitleg per assistent Vergroot de afbeelding

En verder

Gemaakt voor elke dag

  • Voor het hele huishouden

    Nodig huisgenoten uit met een link. Alleen de beheerder koppelt Mealie en de winkels.

  • Veilig inloggen

    Met een passkey, of met een wachtwoord en tweestapsverificatie.

  • Een app op je telefoon

    Installeer MealieShopper als app, met een menubalk zoals bij je andere apps op een iPhone of Android-toestel.

  • Jouw kleuren

    Een licht of donker thema en je eigen accentkleur, voor iedere gebruiker apart.

  • Nederlands en Engels

    Iedereen kiest zijn eigen taal, en elk scherm heeft een eigen adres.

  • Back-up in één bestand

    Maak met één klik een back-up en zet die terug op een nieuwe server. Je koppelingen versleutel je met een eigen wachtwoord.

Schermen

Zo ziet het eruit

Elke afbeelding toont hetzelfde scherm op een computer en op een telefoon, met demogegevens.

  • De Prijsgeschiedenis van rundergehakt: kerngetallen, een grafiek met de aanbiedingen als balken, de gewone prijs als trap en je aankopen als stippen, en de tabel met aanbiedingen
    Prijsgeschiedenis: de aanbiedingen, de gewone prijs en wat je zelf betaalde
  • Vergelijk verpakkingen bij rundergehakt: de filters, bovenaan dat 1000 g per kilo € 1,00 goedkoper is, en de verpakkingen met hun kiloprijs van goedkoop naar duur
    Vergelijk verpakkingen: de goedkoopste per kilo bovenaan
  • Het Picnic-mandje met plus- en minknoppen, het te betalen bedrag en de bezorgmomenten
    Het Picnic-mandje, met de bezorgmomenten
  • Zoekresultaten bij HelloFresh en Marley Spoon voor het woord kip, met kaarten en de knoppen Bekijken en Inplannen
    Recepten van HelloFresh en Marley Spoon, met één klik ingepland
  • Mijn bewaarde recepten met de groep Doordeweeks gekozen: twee kaarten aangevinkt, de knoppen Selecteren en Hele groep importeren (4), en onderaan de balk met Alles selecteren, Klaar en Importeer 2 recepten in Mealie
    Je bewaarde AH-recepten in één keer naar Mealie
  • Een kassabon als kaarten: per regel een kaart in de kleur van de categorie, met de naam en de foto van het webwinkelproduct, de korting, hoe vaak je het eerder kocht en de bonus
    Een kassabon als kaarten, in de kleur van elke categorie
  • Instellingen, Weergave in het donkere thema: de achtergrond Donkergrijs is gekozen, en onder Accentkleur tien rondjes en Eigen kleur, met Blauw gekozen
    Weergave: een donker thema en je eigen accentkleur
  • Instellingen, Weergave, Navigatiebalk: Automatisch, iOS-achtig en Android-achtig, met Android-achtig gekozen; op de telefoon de balk onderaan over de volle breedte met een pil achter Meer
    De menubalk zoals op een iPhone of een Android-toestel
  • Installatiehulp, stap 1: beveiliging kiezen
    De installatiehulp bij de eerste start
  • Profiel, Beveiliging: wachtwoord, tweestapsverificatie en passkeys
    Passkeys, een wachtwoord en tweestapsverificatie
  • Instellingen, Gebruikers: de beheerder met twee gebruikers, en een formulier om iemand uit te nodigen
    Huisgenoten uitnodigen met een link

Privacy

Jij houdt de regie

MealieShopper draait in je eigen container. Er is geen account bij ons, en er gaat niets naar ons toe.

  • Geen analytics, geen tracking

    De updatecheck vraagt GitHub alleen naar de nieuwste versie, zonder iets over jou of je installatie mee te sturen.

  • Alles in één map

    Je gegevens staan in een database op je eigen server. Neem die map mee in je back-ups en je hebt alles.

  • Versleutelde koppelingen

    Je koppelingen met Mealie en de winkels staan versleuteld opgeslagen. Winkelwachtwoorden en je afleveradres bewaart de app niet.

  • AI alleen als jij dat wilt

    Naar een AI-dienst gaat alleen iets als de beheerder een eigen sleutel invult en zelf op de knop drukt.

Installeren

In een paar minuten aan de slag

Je hebt een Unraid-server nodig, een computer of NAS met Docker, of Home Assistant. Vooraf instellen hoeft niet: bij de eerste start loopt een installatiehulp met je door de beveiliging en de koppelingen.

Unraid, uit de app-store

  1. Open in Unraid het tabblad Apps (Community Applications) en zoek op MealieShopper.

  2. Kies Install en daarna Apply. De poort (5959) en de map voor je gegevens (/mnt/user/appdata/mealieshopper) staan al ingevuld; de rest is optioneel.

  3. Open de webinterface via het icoon van MealieShopper op het tabblad Docker en volg de installatiehulp.

MealieShopper staat in Helmer's Repository. Wil je nieuwe functies eerder, installeer dan ook MealieShopper (beta): die draait naast de stabiele versie, met een eigen map en poort 5960.

Docker Compose

  1. Maak een map voor je gegevens en haal het compose-bestand op.

    Terminal
    mkdir -p /mnt/user/appdata/mealieshopper
curl -fsSLO https://raw.githubusercontent.com/helmerzNL/MealieShopper/main/docker-compose.yml

  2. Start de container.

    Terminal
    docker compose up -d

  3. Open http://<adres-van-je-server>:5959 en volg de installatiehulp.

Het compose-bestand bewaart je gegevens in /mnt/user/appdata/mealieshopper. Gebruik je een andere map, pas dan het pad onder volumes aan.

Docker

  1. Start de container, met een map voor je gegevens.

    Terminal
    docker run -d --name mealieshopper -p 8000:8000 \
  -v /mnt/user/appdata/mealieshopper:/data \
  ghcr.io/helmerznl/mealieshopper:latest

  2. Open http://localhost:8000 en volg de installatiehulp.

De image is er voor linux/amd64 en linux/arm64. Met de tag beta krijg je nieuwe functies eerder; gebruik daarvoor een eigen map.

Home Assistant-add-on

  1. Ga naar Instellingen, Add-ons, Add-on store, open het menu rechtsboven en kies Repositories.

  2. Voeg deze repository toe en installeer MealieShopper.

    Repository
    https://github.com/helmerznl/mealieshopper

  3. Klik op Starten en open http://<adres-van-home-assistant>:5959. De installatiehulp doet de rest.

Voor Home Assistant OS en Supervised. Home Assistant neemt je gegevens mee in zijn eigen back-ups.

Wat je nodig hebt

  • Je eigen Mealie, met een API-token
  • Een account bij Albert Heijn, Picnic, Jumbo of Crisp
  • Docker op amd64 of arm64: ook een Raspberry Pi of een ARM-NAS
  • Voor passkeys en installeren als app: een domeinnaam met HTTPS
Lees de handleiding Alle instellingen

Doe de eerste start op een netwerk dat je vertrouwt. Zolang er geen inlogmethode is ingesteld, kan wie het adres als eerste opent de installatie claimen.

Vragen

Veelgestelde vragen

Wat kost MealieShopper?

Niets. MealieShopper is open source onder de MIT-licentie en draait op je eigen server. Wil je de ontwikkeling steunen, dan kan dat met een koffie.

Heb ik Mealie nodig?

Ja. MealieShopper is gemaakt voor wie zijn recepten in Mealie bijhoudt. Je weekmenu en de recepten die je importeert staan in je eigen Mealie; MealieShopper koppelt daaraan met een API-token. Mealie is zelf ook gratis en zelf te hosten.

Bestelt MealieShopper zelf mijn boodschappen?

Nee. MealieShopper zet producten in je mandje nadat jij de lijst hebt gecontroleerd. De bestelling rond je zelf af, bij Albert Heijn, in de Picnic-app, bij Jumbo of in de Crisp-app. Er wordt nooit een bestelling geplaatst.

Welke supermarkten werken ermee?

Albert Heijn, Picnic, Jumbo en Crisp. Picnic werkt ook met een account uit Duitsland of Frankrijk. Recepten zoek je daarnaast bij HelloFresh en Marley Spoon.

Bij Picnic en Crisp pas je het mandje ook in MealieShopper aan; het Jumbo-mandje kun je er alleen bekijken.

Is dit een officiële app van de supermarkten?

Nee. MealieShopper is een onofficieel hulpmiddel en heeft geen band met Mealie, Albert Heijn, Picnic, Jumbo of Crisp. Het gebruikt de niet-officiële app-API's van de winkels, die zonder bericht kunnen veranderen. Het is bedoeld voor persoonlijk gebruik.

Waar staan mijn gegevens?

In één map op je eigen server: /data in de container, met een SQLite-database en een sleutelbestand. Neem die map mee in je back-ups. In de app maak je daarnaast met één klik een back-upbestand dat je op een andere server terugzet.

Draait het op een Raspberry Pi of een NAS?

Ja. De image is gebouwd voor linux/amd64 en linux/arm64, dus hij draait ook op een Raspberry Pi en op een ARM-NAS, zoals sommige Synology-modellen. Op Unraid installeer je hem uit de app-store (Community Applications), in Home Assistant als add-on.

Kan ik het op mijn telefoon gebruiken?

Ja. Open het adres van je installatie en installeer MealieShopper als app: op een iPhone via Delen, Zet op beginscherm, op Android in Chrome via App installeren. Installeren werkt via HTTPS.

Wat is het verschil tussen stabiel en beta?

De tag latest is de stabiele versie. De tag beta krijgt nieuwe functies eerder en toont een beta-badge naast het logo. Draai je beta, gebruik dan een eigen map voor je gegevens.

Gratis, en dat blijft zo

Heb je er iets aan? Met een koffie houd je de ontwikkeling gaande. Een ster op GitHub of een gemelde fout helpt ook.

Trakteer op een koffie Steun via Ko-fi Geef een ster op GitHub