KitchenCalc — Tutorials
Written guides for every feature in KitchenCalc. Work through them in order for a complete introduction, or jump to any section using the contents list.
1 Converting Volumes & Weights
What you'll learn: converting between any two volume units, or between any two weight units, using the Convert tab.
Steps
- Open the Convert tab. It's the first tab in the segmented control at the top of the window.
- Enter your amount. Type a whole number in the first field. If your recipe uses a fraction (e.g., 2¼), type "2" in the whole number field and choose "1/4" from the fraction dropdown beside it.
- Choose your From unit. Click the "From" dropdown. Volume units cover US measures (tsp, tbsp, cup, fl oz, pint, quart, gallon), British measures (teaspoon, dessertspoon, tablespoon, fl oz, cup, pint, quart, gallon), and metric (mL, cL, dL, L); weight units are mg, g, kg, oz, lb, and stone. Select the unit your recipe uses.
- Choose your To unit. Click the "To" dropdown and select your target unit. The result appears instantly in the large display at the top.
- Copy the result using the Copy button at the bottom of the result summary line.
Swapping units
Use the ↑↓ Swap button between the From and To pickers to reverse the conversion in one click. Useful when you want to convert in the opposite direction without re-selecting both units.
2 Ingredient Density Conversions
What you'll learn: converting between volume and weight using ingredient-specific density — the key feature that makes KitchenCalc accurate for baking.
One cup of flour weighs very differently from one cup of honey. When you convert between a volume unit and a weight unit, KitchenCalc needs to know which ingredient you're converting, because the density determines the result.
Using the ingredient picker
- In the Convert tab, the Ingredient row is always visible. When From and To are both volume (or both weight), it shows in grey with a note that it applies to vol ↔ weight conversions. When you cross types, it turns blue to signal it's actively used.
- Click the ingredient dropdown and choose the ingredient you're converting. The list is grouped into Built-in (95+ common baking and cooking ingredients) and Custom (ingredients you've added yourself).
- The density appears in g/mL next to the picker — for example, all-purpose flour is 0.530 g/mL and softened butter is 0.960 g/mL.
- Set From to a volume (e.g., cup) and To to a weight (e.g., g). The result reflects the density of the selected ingredient.
Common conversions
| Ingredient | 1 cup = | 1 tbsp = |
|---|---|---|
| All-purpose flour | 125 g | 7.8 g |
| White (granulated) sugar | 201 g | 12.6 g |
| Butter | 227 g | 14.2 g |
| Honey | 336 g | 21.0 g |
| Whole milk | 244 g | 15.2 g |
| Cocoa powder (natural) | 90 g | 5.6 g |
3 Custom Ingredients
What you'll learn: adding ingredients to the database that aren't in the built-in list.
KitchenCalc ships with 95+ common cooking and baking ingredients. If you regularly work with something not in the list — a specialty flour, a particular nut butter, or an ingredient specific to your cuisine — you can add it with a density value.
Finding the density
Density is measured in grams per millilitre (g/mL). To find it:
- Measure it yourself: fill a 1-cup measure with your ingredient and weigh it in grams. Divide by 236.6 to get g/mL.
- Look it up: search "[ingredient name] density g/mL" — many culinary references publish these values.
- Use a close substitute: if you can't find the exact value, a similar ingredient from the built-in list will give a reasonable approximation.
Adding a custom ingredient
- In the Convert tab, click Manage… next to the ingredient picker. The Custom Ingredients sheet opens.
- Type the ingredient name in the Name field.
- Enter the density in g/mL in the Density field.
- Click Add. The ingredient appears immediately in the list and in the ingredient picker.
Deleting a custom ingredient
- Open the Manage sheet from the Convert tab.
- Click the trash icon at the right of the ingredient's row. If that ingredient was selected in the Convert tab, the picker switches back to All-purpose flour.
4 Temperature & Fan Ovens
What you'll learn: converting oven temperatures between all common units, including fan (convection) and Gas Mark.
- Open the Temperature tab. Click "Temperature" in the segmented control at the top.
- Enter the temperature from your recipe in the input field.
- Choose the From unit — the unit your recipe uses.
- Choose the To unit — your oven's unit.
- The converted temperature appears immediately.
Available temperature units
| Unit | Common in | Notes |
|---|---|---|
| °C (Celsius) | Most countries | Standard conventional oven |
| °F (Fahrenheit) | USA, some Caribbean | Standard conventional oven |
| Gas Mark | UK, Ireland, older AU recipes | GM 4 = 180°C = 350°F |
| Fan °C | UK, Europe, Australia | 20°C lower than conventional |
| Fan °F | North America (convection) | Equivalent to Fan °C in Fahrenheit |
Fan vs conventional ovens
A fan oven (also called a convection oven) circulates hot air and cooks food approximately 20°C (36°F) hotter than the same setting on a conventional oven. If your recipe specifies a conventional temperature but you have a fan oven, select °C → Fan °C (or °F → Fan °F) to get the correct setting for your oven.
Gas Mark reference
The formula KitchenCalc uses: Gas Mark × 14 + 121 = °C. So Gas Mark 6 = 205°C (about 400°F).
5 Pan Substitution
What you'll learn: finding the right adjustment when you don't own the pan a recipe calls for.
Pan substitution is based on baking area. A deeper batter cooks slower; a shallower batter cooks faster. KitchenCalc compares areas and tells you how to adjust time, quantity, and temperature.
Steps
- Open the Pan tab. Click "Pan" in the segmented control.
- Choose inches or centimetres using the toggle at the top.
- Set up "Recipe calls for." Choose the pan shape from the Shape dropdown. Choose the standard size if it appears in the list, or choose Custom and enter the dimensions manually. Choose the Material (Metal, Dark/Non-stick, or Glass/Ceramic) to match the recipe's intended pan.
- Set up "Pan I have." Repeat for your actual pan.
- Read the Substitution Guide that appears below. It shows: the relative size of your pan as a percentage, the scale factor for recipe quantities, batter depth advice, baking time advice, and — if the materials differ — a temperature adjustment note.
Understanding the results
| Result | What it means |
|---|---|
| Your pan is X% | The area of your pan relative to the recipe's pan. 80% = smaller; 120% = larger. |
| Scale recipe by N× | Multiply every ingredient quantity by this factor to fill your pan to the same depth as the recipe intended. |
| Batter note | How much larger or smaller your pan is, and how much of the recipe to make to keep the same batter depth. |
| Baking time note | If you use the recipe as written instead of scaling it: check early for larger pans, allow extra time for smaller ones. |
| Temperature note | Only appears when materials differ. Explains the exact adjustment and why. |
Material temperature adjustments
When recipe and pan materials differ, KitchenCalc recommends:
- Metal → Glass: reduce temperature 25°F (15°C). Glass heats slowly but retains heat.
- Glass → Metal: increase temperature 25°F (15°C). Metal heats faster.
- Metal → Dark/Non-stick: reduce temperature 25°F (15°C) or check 10 min early. Dark pans absorb more heat.
- Dark → Metal: increase temperature 25°F (15°C) to compensate.
6 Scaling a Recipe
What you'll learn: multiplying a recipe to serve more (or fewer) people, with results shown as proper cooking fractions in units you can actually measure.
- Open the Recipe tab. Click "Recipe" in the segmented control.
- Name the recipe in the Recipe field at the top — for example, "Grandma's Tuna Bake". You can leave it blank; it's used when you save or copy the recipe, and shows as "Unnamed Recipe" until you name it.
- Set Original servings — how many people the recipe is written for. Type the number in the Original field.
- Set Target servings — how many you actually want to serve. The Scale Factor updates immediately (e.g., 4 → 6 gives 1.5×).
- Add ingredients. Each ingredient gets its own card. For each one:
- Type the ingredient name in the name field at the top of the card.
- Enter the whole number in the left field (e.g., "2" for 2½ cups).
- Choose the fraction from the dropdown (e.g., "1/2").
- Choose the unit from the unit dropdown (tsp, dsp, tbsp, cup, fl oz, pint, mL, L, g, kg, oz, lb, count). "dsp" is the British dessertspoon (10 mL).
- Read the scaled result on the right side of each ingredient card. It appears as a proper fraction — "3 cup", "1 1/2 tbsp", "2 1/4 cup" — and metric amounts as decimals, like "1.25 kg".
- Add more ingredients using the + Add Ingredient button at the bottom left.
- Copy the full scaled recipe using Copy Scaled. The clipboard receives the recipe name, the serving count, and every ingredient line — ready to paste into FusionMD or any other app.
Big batches — Thanksgiving, church suppers, bake sales
When a recipe is scaled up a lot, KitchenCalc switches each result to a unit you can actually measure. Scale a recipe for 4 up to 400 and 2 tbsp of butter shows as 12 1/2 cup rather than 200 tbsp; 250 g of pasta becomes 25 kg; 1.6 oz of cheese becomes 10 lb.
- Teaspoons move up to tablespoons, tablespoons to cups, and cups to quarts and gallons once they pass a gallon.
- Grams become kilograms and millilitres become litres at 1,000; ounces become pounds from 16 oz.
- A unit only changes when the rounded amount stays within 3% of the exact one — 5 tbsp stays "5 tbsp" rather than rounding to "1/3 cup".
- Only the scaled result changes. The amounts you entered are never altered.
Scaling notes
A lightbulb panel appears under Servings when there's something arithmetic alone can't tell you:
- 3× or more — increase salt, spices and baking powder or soda by less than the scale factor, and cook in several dishes rather than one large one (the Pan tab helps match dish sizes).
- ½× or less — use a smaller dish and start checking for doneness early.
- Part of an egg — beat it and measure; a large egg is about 3 tbsp.
Removing ingredients
Click the − button (circle with minus) at the right of the ingredient name field to remove that row from the list.
Starting fresh — Clear All
Click Clear All (bottom left, next to Add Ingredient) to reset the Recipe tab to a blank slate. A confirmation dialog appears before anything is erased. Clearing also resets the servings to 4 → 6 and clears the Recipe name.
6b Saving & Recalling Recipes
What you'll learn: saving a scaled recipe by name so you can reload it in one tap without re-entering every ingredient — and renaming it later.
KitchenCalc saves as many named recipes as you like. Once saved, a recipe can be loaded instantly at any time, and its name appears in the Recipe field at the top of the tab so you always know which recipe is active.
Saving a recipe
- Enter the recipe name, servings, and ingredients in the Recipe tab — for example, "Yorkshire Pudding".
- Click Save… in the action bar at the bottom of the tab. A new recipe is saved straight away under the name in the Recipe field.
Updating a recipe you loaded
If the recipe on screen was loaded from your saved list, Save… asks what you'd like to do:
- Update — replaces the saved recipe with what's on screen, including any change to its name.
- Save as New — keeps the original and saves this version as a separate recipe. Handy for keeping both a family-size and a party-size version.
Recalling a saved recipe
- Click the Saved button in the action bar — it shows how many recipes you have, for example Saved (14). A popover opens listing all saved recipes, newest first.
- Once you have more than 8 recipes, a search field appears at the top of the list. Type part of a name to show only matching recipes.
- Click Load next to any recipe. The ingredient list, servings, and recipe name all update immediately. The popover closes automatically.
Renaming a saved recipe
- Click the Saved button to open the list.
- Click the pencil next to the recipe. Its name becomes editable.
- Type the new name and press Return or click the checkmark. Press Esc or click the × to cancel. If that recipe is loaded, the Recipe field updates too.
You can also rename a loaded recipe by editing the Recipe field and choosing Save… → Update.
Deleting a saved recipe
- Click the Saved button to open the list.
- Click the trash icon on the right of the recipe you want to remove. The recipe is deleted immediately — no confirmation required.
Copying a saved recipe
After loading or saving a recipe, click Copy Scaled. The clipboard contains the recipe name on the first line, the serving count on the second, then every scaled ingredient — formatted for direct pasting into FusionMD or any writing app.
Example output:
Yorkshire Pudding Serves 12: 2 cup plain flour 4 count eggs 300 mL whole milk 2 tbsp sunflower oil
7 AI Recipe Import
What you'll learn: pasting a recipe in plain text and letting AI fill in its name, servings, and every ingredient automatically.
Instead of typing each ingredient manually, you can paste the full text of a recipe and KitchenCalc will extract every ingredient line into the scaler. This works with recipes copied from websites, PDFs, or any text source.
- Recipe name — taken from the recipe's title, if it has one. A name you typed yourself is never replaced.
- Servings — "Serves 6", "Makes 24 cookies" or "Yield: 4–6" sets Original and Target servings, so the recipe starts at 1× and you change Target to scale it.
- Amounts as written — KitchenCalc reads each amount and unit directly from your recipe's own lines ("1 1/2 cups", "½ tsp", "2 (15 oz) cans", "2 dessertspoons"). AI identifies the ingredients; your recipe's numbers are used exactly as printed.
Option A — Apple Intelligence (macOS 26, Apple Silicon)
- Make sure Apple Intelligence is turned on in System Settings → Apple Intelligence & Siri. There's nothing to set up in KitchenCalc — it uses Apple Intelligence automatically, and Settings → AI shows whether it's available on your Mac. No key required.
- In the Recipe tab, click Import Recipe.
- Paste the recipe text into the sheet. Click Extract Ingredients.
- KitchenCalc fills in the name, servings, and ingredient list automatically. Give the results a quick look — amounts written in prose rather than at the start of a line (e.g., "salt to taste") are interpreted by the AI.
Option B — OpenRouter (any Mac)
- Create an account at openrouter.ai, generate an API key, and add a few dollars of credit. Each recipe import costs a fraction of a cent, so a small balance lasts a very long time.
- Open KitchenCalc. Go to Settings (⌘,) → AI.
- Paste your API key into the OpenRouter Key field and click Save Key.
- In the Recipe tab, click Import Recipe.
- Paste the recipe text and click Extract Ingredients. The recipe text is sent to OpenRouter for processing. Extraction usually completes in 2–5 seconds.
What to paste
Paste just the ingredients section of the recipe — or the whole recipe text. KitchenCalc ignores instructions and extracts only ingredient lines. The AI works best when amounts are written out clearly (e.g., "2 cups all-purpose flour" rather than "flour (as needed)").
8 Appearance & Settings
What you'll learn: personalising KitchenCalc's appearance and reviewing all settings.
Opening Settings
Press ⌘, or go to KitchenCalc → Settings in the menu bar.
Appearance tab
KitchenCalc ships with 23 built-in themes — a System theme that follows your macOS accent colour, eleven dark themes, and eleven light themes. Click any swatch to apply it instantly. Themes are remembered between launches.
- System — follows macOS appearance and accent colour automatically
- Dark themes — Slate, Forest, Graphite, Rosewood, Indigo, Midnight, Ember, Obsidian, Mocha, Aurora, Amethyst
- Light themes — Sandstone, Minimalist, Blossom, Sky, Sage, Lavender, Arctic, Parchment, Peach, Coral, Teal
AI tab
Configure the AI recipe import feature:
- Apple Intelligence (macOS 26 and later) — shows whether on-device AI is available on this Mac.
- OpenRouter API Key — paste your key and click Save Key. Click Show/Hide to reveal or mask the key. Saving an empty field removes the key.
- Use the Appearance tab's theme selector if you prefer a lighter or darker interface for kitchen use — high-contrast themes like Minimalist or Slate can be easier to read at a glance while cooking.