Kcalculator Handleiding

Alles wat je moet weten om het meeste uit je slimme voedingstracker te halen.


Welkom

Kcalculator is een slim voedingsdashboard waarmee je dagelijkse maaltijden bijhoudt, macro's volgt en AI-gestuurde inzichten krijgt over je voeding. De app werkt volledig in je browser en synchroniseert optioneel naar de cloud. Wanneer je gebruik maakt van inloggen, kun je op ieder device bij je gegevens.

Calorieën Koolhydraten Vet Eiwit Vezels Water

Aan de Slag

Je kunt Kcalculator op drie manieren gebruiken:

  1. E-mail & wachtwoord — Maak een account aan om je data veilig in de cloud op te slaan en op meerdere apparaten te gebruiken.
  2. Magic link — Ontvang een inloglink per e-mail, geen wachtwoord nodig.
  3. Zonder account — Gebruik de app volledig lokaal. Je data blijft op je apparaat opgeslagen.
Tip: Met een account worden je maaltijden, favorieten en instellingen automatisch gesynchroniseerd tussen al je apparaten.

AI Providers uitgelegd

Voor de meeste acties in Kcalculator heb je geen AI Provider nodig. Maar als je een gerecht wilt herkennen, een foto wilt uploaden of een diepere analyse wilt gebruiken, dan heb je wel een AI Provider met API-key nodig. In Instellingen → AI kies je per onderdeel welke provider Kcalculator standaard gebruikt.

  1. Invullen wordt gebruikt voor algemene AI-invulacties in de app.
  2. Analyse wordt gebruikt voor advies, avondeten-suggesties, daganalyse en AI Week.
  3. Gerechten wordt gebruikt voor Slimme Import, gerecht-herkenning, recepten en URL-import.
  4. De provider kies je centraal in Instellingen, maar het model selecteer je op de betreffende pagina zelf.
🟢 Gemini

Gratis instapoptie. In Kcalculator staat Gemini 2.5 Flash als gratis provider genoemd. Handig om te testen en voor lichtere taken.

API key aanmaken
Officiële pricing

OpenAI

Betaald. In Kcalculator gebruik je meestal GPT-4o mini of GPT-4o. Dit werkt vaak sterk voor Slimme Import en uitgebreidere analyses.

API key aanmaken
Officiële pricing

🟠 Claude

Betaald. In Kcalculator gebruik je meestal Claude Haiku 4.5 of Sonnet 4.5. Deze werken vaak erg goed voor avondeten en Slimme Import.

API key / quickstart
Officiële pricing

Kostenindicatie: onderstaande bedragen zijn grove schattingen voor een normale tekst-call in Kcalculator. Eenvoudige acties kosten meestal minder dan 1 cent, maar foto-analyse, URL-import en lange dag- of weekanalyses kunnen hoger uitvallen doordat er meer input en output wordt verwerkt.
💸 Gemini 2.5 Flash

Gratis tier beschikbaar via Google AI Studio. Op de betaalde tier is een eenvoudige call vaak nog steeds ruim onder de 1 cent.

💸 OpenAI

GPT-4o mini: vaak minder dan $0.001 per simpele call.
GPT-4o: vaak rond de $0.01 voor een vergelijkbare call.

💸 Claude

Haiku 4.5: vaak rond de $0.004 tot $0.005 per simpele call.
Sonnet 4.5: vaak rond de $0.01 tot $0.02 per simpele call.


Maaltijden Bijhouden

De kern van Kcalculator: log wat je eet en drink, verdeeld over 7 momenten op de dag.

🌅 Ontbijt

Start je dag met het loggen van je ontbijt.

🍎 Ochtendsnack

Tussendoortje in de ochtend.

☀️ Lunch

Je middagmaaltijd bijhouden.

🍪 Middagsnack

Snack in de middag.

🌙 Avondeten

De hoofdmaaltijd van de dag.

🌜 Avondsnack

Iets lekkers voor het slapen.

💧 Drinken

Water, koffie, thee en meer.

Let op: Avondsnack en drinken hebben eigen iconen, zodat je die momenten snel kunt herkennen in de app.

Hoe voeg je items toe?

  1. Klik op een maaltijdtype om het invoerveld te openen.
  2. Begin met typen — de autocomplete zoekt in de RIVM/NEVO- en Open Food Facts-database.
  3. Selecteer een product en pas de hoeveelheid aan (in grammen of porties).
  4. Het item verschijnt in je maaltijdlijst met automatisch berekende macro's.

Je kunt simpel invoeren, maar het werkt meestal het beste als je losse onderdelen met een komma scheidt. Denk bijvoorbeeld aan "kwark, een handje druiven, een halve banaan" of "boterham, kaas". De app kan vaak ook natuurlijke invoer aan zoals "kwark met een handje druiven en een halve banaan", maar met komma's is de kans op een goede match meestal het grootst.

✍️ Voorbeelden die goed werken

Kwark, een handje druiven, een halve banaan
Boterham, kaas
2 boterhammen, kipfilet
Havermout, melk, banaan
Yoghurt, muesli, blauwe bessen

🎤 Spraak werkt ook

Je kunt ook de spraakfunctie van je telefoon gebruiken en iets inspreken zoals "kwark met een handje druiven en een halve banaan". Kcalculator herkent vaak ook natuurlijke taal, dus je hoeft niet altijd strak losse woorden te typen.

📏 Handige eenheden

Onder andere: half, halve, kwart, gram / g, ml, eetlepel / el, theelepel / tl, handje, handvol, stuk, plak, beker, glas, sneetje, ei, teen en takje.

Tip: Hoe simpeler en concreter, hoe beter. Gebruik bij voorkeur losse ingrediënten of producten, zet er een hoeveelheid voor of bij, en gebruik komma's als je meerdere items tegelijk invoert.

Kopie dag

  1. Tik naast Vandaag op het kopieer-icoon met de twee overlappende vakken.
  2. Kies de datum waarvan je de maaltijden wilt overnemen.
  3. Tik op Kopieer naar deze dag om alles over te zetten.
  4. De huidige dag neemt dan alle maaltijden van die bron-dag over.
Let op: Als er al maaltijden op de huidige dag staan, vraagt de app eerst om bevestiging voordat die worden vervangen.
Tip: Tik op een item om het te bewerken — je kunt de hoeveelheid, macro's en het maaltijdtype aanpassen. Veeg of klik op het prullenbak-icoon om te verwijderen.

Favorieten & Recepten

Sla veelgebruikte producten en complete maaltijden op als favoriet voor snelle invoer.

  1. Enkel product opslaan — Tik op het hart-icoon bij een item om het als favoriet te bewaren.
  2. Recept aanmaken — Combineer meerdere items tot een maaltijdgroep (bijv. "Pasta Bolognese") en sla het geheel op.
  3. Snel toevoegen — Open het favorieten-paneel en tik op een favoriet om het direct aan je huidige maaltijd toe te voegen.

Items uit een maaltijd opslaan als gerecht

  1. Open een maaltijd waarin al meerdere items staan.
  2. Tik op 🍽️ Kies items voor gerecht.
  3. Vink minimaal twee items aan die samen je gerecht vormen.
  4. Tik op 🍽️ Opslaan als gerecht en geef het gerecht een naam.
  5. Daarna verschijnt het tussen je favoriete gerechten, zodat je het later snel opnieuw kunt toevoegen.
Tip: Favorieten worden automatisch gesynchroniseerd als je bent ingelogd. Ze zijn direct beschikbaar op al je apparaten.

Slimme Import (AI)

Gebruik AI om snel voedingswaarden te achterhalen — op vier verschillende manieren. Dit werkt het beste met de API's van betaalde AI providers, zoals OpenAI of Claude.

💬 Gerechtnaam

Typ een gerecht (bijv. "nasi goreng") en AI schat de voedingswaarden in op basis van standaard porties en ingrediënten.

✏️ Handmatig

Voer zelf voedingswaarden in als je de exacte macro's kent (bijv. van een verpakking).

🔗 URL Import

Plak een link naar een recept en AI extraheert automatisch de ingrediënten en voedingswaarden.

📸 Foto Upload

Maak een foto van je maaltijd of een recept en laat AI de voedingswaarden analyseren.

Tip: Na de AI-analyse kun je elk ingrediënt koppelen aan een product uit de NEVO-database voor nauwkeurigere waarden. Slimme Import werkt meestal het beste met betaalde AI API's, zoals OpenAI of Claude.

Apple Health Import

Je kunt verbruiksdata op twee manieren importeren: via een volledige export uit Apple Health, of via een CSV-bestand uit een app zoals Auto Export. Beide routes vullen je actieve energie en rustverbruik aan, zodat het data-overzicht je TDEE en energiebalans kan tonen.

📦 Volledige Apple Health export

Dit is de meest complete route. Je exporteert je hele Apple Health-database als ZIP/XML en importeert daarna het bestand in de app.

📄 CSV via Auto Export

Handig als je liever met compacte CSV-bestanden werkt of regelmatig een verse export wilt maken zonder de hele Health-dump.

Variant 1: volledige Apple Health export

  1. Open op je iPhone de Gezondheid-app en ga naar je profiel.
  2. Kies Exporteer alle gezondheidsgegevens. Apple maakt dan een ZIP-bestand met daarin onder andere een XML-export.
  3. Stuur dit bestand naar jezelf of sla het op in Bestanden/Mac.
  4. Open in Kcalculator Instellingen > Data > Apple Health of gebruik de 🍎 Import-knop onder de grafiek in het data-overzicht.
  5. Selecteer het XML-bestand of het uitgepakte exportbestand en kies eventueel een startdatum.
  6. Na import worden actieve energie en rustverbruik per dag opgeslagen.

Variant 2: CSV via Auto Export

  1. Gebruik een export-app zoals Auto Export om Apple Health-data naar CSV te schrijven.
  2. Zorg dat in elk geval Active Energy en Resting Energy of de Nederlandse varianten daarvan in de export zitten.
  3. Exporteer het CSV-bestand en bewaar het lokaal op je telefoon of computer.
  4. Open weer Instellingen > Data > Apple Health of de 🍎 Import-knop in het data-overzicht.
  5. Selecteer nu het CSV-bestand. De app leest zelf zowel Nederlandse als Engelse kolomnamen voor energie.
  6. Na afloop zie je in het data-overzicht de TDEE-lijn en de balans terug, zodra er voor die dagen ook voedingsinname is.
Belangrijk: een nieuwe Apple Health-import is leidend voor de geïmporteerde periode. Heb je eerder handmatig TDEE ingevuld voor die dagen, dan wordt die overschreven door de Apple Health-data.
Tip: zie je geen TDEE-lijn? Controleer dan of je export echt actieve energie en rustenergie bevat, en of je voor die dagen ook maaltijden hebt gelogd.

Barcode Scanner

Scan de barcode van een product met je camera om het direct op te zoeken.

  1. Tik op het barcode-icoon in de invoerbalk.
  2. Richt je camera op de barcode van het product.
  3. Het product wordt automatisch herkend en de voedingswaarden worden ingeladen.
Tip: De scanner werkt het best bij goed licht. Zorg dat de barcode scherp in beeld is.

Data & Inzichten

Bekijk trends, analyseer je voeding en krijg persoonlijke adviezen.

📊 Dagoverzicht

Zie je dagelijkse totalen voor calorieën, koolhydraten, vet, eiwit en vezels in één oogopslag.

📈 Grafieken

Bekijk trends over 7, 30 of 90 dagen met interactieve grafieken en sparklines.

🤖 AI Adviezen

Ontvang persoonlijke voedingsadviezen op basis van je dag- of weekpatronen, inclusief de Schijf van Vijf analyse.

🔬 Micronutriënten

Schatting van je vitamine- en mineralenintake (o.a. vitamine D, ijzer, calcium, B12).


Gewicht Bijhouden

Houd je gewichtsverloop bij en bekijk je voortgang over tijd.

  1. Ga naar het gewicht-tabblad in de app.
  2. Voer je huidige gewicht in en selecteer de datum.
  3. Bekijk je gewichtshistorie en trends in de grafiek.
Tip: Weeg jezelf elke dag op hetzelfde moment (bijv. 's ochtends voor het ontbijt) voor de meest consistente resultaten.

Synchronisatie & Data

Je data is veilig — lokaal opgeslagen en optioneel gesynchroniseerd naar de cloud.

☁️ Cloud Sync

Met een account worden maaltijden, favorieten en instellingen automatisch gesynchroniseerd.

📴 Offline-first

Geen internet? Geen probleem. De app werkt volledig offline en synchroniseert zodra je weer online bent.

💾 Exporteren

Download al je data als JSON- of CSV-bestand voor eigen gebruik of backup.

🟢 Groene sync-knop bovenin

De groene statusknop bovenin voert een volledige handmatige sync uit. De app controleert eerst of je sessie nog geldig is, uploadt daarna openstaande lokale wijzigingen, en haalt vervolgens je serverdata opnieuw op.

Concreet worden je lokale dagdata, handmatige energiedata en prefs eerst naar de server geschreven. Daarna worden je instellingen, dagen en energiedata opnieuw vanaf de server ingeladen zodat je cache weer gelijk loopt met de cloud.

Tip: Gebruik deze knop als je handmatig zeker wilt weten dat lokale wijzigingen zijn doorgestuurd en de laatste serverdata opnieuw is binnengehaald op dit apparaat.

Als App Opslaan (PWA)

Je kunt Kcalculator ook als app op je beginscherm zetten. Dat werkt fijn op iPhone en Android, omdat de app dan sneller opent en meer als een gewone app aanvoelt.

🍎 iPhone (Safari)
  1. Open Kcalculator in Safari.
  2. Tik onderin op de deelknop (vierkant met pijl omhoog).
  3. Kies Zet op beginscherm.
  4. Bevestig met Voeg toe.
🤖 Android (Chrome)
  1. Open Kcalculator in Chrome.
  2. Tik rechtsboven op het menu met drie puntjes.
  3. Kies Toevoegen aan startscherm of App installeren.
  4. Bevestig de installatie.
Tip: Werkt de optie niet meteen? Open de app dan direct via de gewone browser-URL, ververs de pagina een keer en probeer het opnieuw in Safari of Chrome.

Instellingen

Pas de app aan naar jouw wensen.

🎯 Doelen

Stel persoonlijke doelen in voor calorieën, koolhydraten, vet, eiwit, vezels en water. Handig hulpmiddel: macro-calculator van Lot Beukers.

Let op: doelen instellen en goed begrijpen hoe je lichaams-samenstelling is, kan alleen echt vakkundig worden vastgesteld door een diëtist of andere gekwalificeerde professional.

📥 Apple Health

Importeer actieve energie en rustverbruik uit een Apple Health XML-export of CSV-bestand.

🔥 Handmatige TDEE

Heb je geen Apple Health of activiteitsdata? Voeg dan per dag handmatig een TDEE toe als fallback voor je energiebalans in het data-overzicht. Meer uitleg: Wikipedia over energy expenditure.

📤 Exporteer data

Download je gegevens als JSON- of CSV-bestand voor backup of eigen analyse.

🗑️ Data verwijderen

Verwijder voedings- of energiedata per dag of in bulk als je iets opnieuw wilt opbouwen.

🤖 AI Provider

Kies je AI-engine: Claude, Gemini of OpenAI. Voer je eigen API-key in voor directe toegang.

🛒 Supermarktfilter

Filter producten op supermarkt voor relevantere zoekresultaten.

Tip: Onder Instellingen → Data vind je dezelfde acties als in de app: 📥 Apple Health, 🔥 Handmatige TDEE, 📤 Exporteer data en 🗑️ Data verwijderen.