User guide

This guide shows you everything you need in ABfit – from adding it to your Home Screen to the automatic sync with Apple Health. All pictures come from a sample account “Anna” with made-up data. The pictures show the app in German, its default language; the buttons and menus in the text are named as they appear when the app is set to English (see section 15).

Contents

1. Add ABfit to your Home Screen
2. Sign in
3. The Cockpit, the Day overview and swiping
4. Logging food: search, amount, custom foods
5. Speak, photo and barcode
6. Photograph the nutrition label
7. Edit entries and delete several at once
8. Day wrap-up, water and AI rating
9. Recipes: paste text
10. Recipe from a photo
11. History: weight and body fat
12. Activity: steps and workouts by hand
13. Medications
14. Settings: profile and goals
15. Choose a language (6 languages)
16. Change password and account
17. Connect Apple Health (shortcut + automation)
18. Appearance: Light and Dark
19. iPad and computer
20. Frequently asked questions

1. Add ABfit to your Home Screen

You do not need to download ABfit from the App Store. You add the web app to your Home Screen once – after that it opens like a normal app, without an address bar.

1. Open the ABfit link you received in Safari (not in Chrome or in a chat app).
2. Tap the Share icon (square with an arrow pointing up ⬆︎) in the middle at the bottom.
3. Scroll down in the list and tap “Add to Home Screen”.
4. The name “ABfit” is already filled in – tap Add at the top right.
5. The yellow ABfit icon now appears on your Home Screen. From now on, always open ABfit from there.

2. Sign in

1. Open ABfit from your Home Screen.
2. Enter your Username (lowercase, e.g. “anna”).
3. Enter your Password and tap Sign in.
4. You stay signed in – even after closing the app. You can sign out under More → Sign out.

Everyone has their own account: Everyone has their own account. What you log is visible to nobody else. You get your password from whoever runs your ABfit installation – you can change it yourself later (section 16).

3. The Cockpit, the Day overview and swiping

After signing in you see the Cockpit – your home page for today. At the bottom there are four tabs: Cockpit, Food, History, More.

1. Header: date, a greeting with your name and, at the top right, the round yellow profile icon – it opens Settings.
2. Large calorie ring: shows how many calories are still free today (“1,851 kcal left”), with “eaten / budget” below. Tap the ring to open the Day overview.
3. Four small rings: protein, carbs, fat and water – each with value, goal and percentage. Tapping shows where the value comes from.
4. Card with three fields: Weight (tap to open History), Steps (opens Activity) and Progress (days in a row with entries; opens the week overview).
5. Medication hint: appears only when a dose is due (“Next injection tomorrow”). Tapping it opens Medications.
6. Add food: the large yellow button leads straight to food entry.

Tap the rings

The Day overview

Tap the calorie ring in the Cockpit (or open More → Day overview). Here you see the day in detail – and you can switch to other days.

1. Ring and tiles: left, Eaten, Goal, Activity (bonus from sport/steps), Steps.
2. Macros: protein, carbs and fat with bars; below them sugar, fiber, salt.
3. Meals: Breakfast, Lunch, Dinner, Snacks. Yellow + = add something, tapping the row = expand it.
4. Quick buttons: Speak, Photo, Barcode.
5. With ‹ Today › at the top you switch to other days. With ← Back you return to the Cockpit.

4. Logging food

Tap the yellow button “Add food” in the Cockpit – or the yellow + next to a meal in the Day overview. You land in the Food tab; with the second option the meal is already selected.

1. At the top, choose the Meal (Breakfast, Lunch, Dinner, Snacks).
2. Tap a food under “Recently eaten” – or search in the search field at the top. Entries tagged “Basic” come from the checked ABfit database; below them are products from Open Food Facts.
3. Set the amount: with − / +, by typing, or with the yellow quick amounts (e.g. “Fillet (125 g)”).
4. Tap Add. The button briefly shows “Saving …” – one tap is enough.

Create a custom food

If you cannot find a product, create it yourself: in the Food tab via “+ Create custom food”.

1. Enter a name and, if you like, a brand.
2. Type in the nutrition values per 100 g from the package (at least calories) – or conveniently by photographing the nutrition label (section 6).
3. Optionally a serving (e.g. “piece, 120 g”) and a barcode.
4. Save – it appears in the search with the tag “custom”.

5. Speak, photo and barcode

🎙️ Speak

1. In the Food tab tap Speak (there is also a button in the Day overview).
2. Choose the meal and tap the yellow microphone.
3. Simply say what you ate: “A glass of milk, two slices of whole-grain bread with cream cheese”.
4. Tap again to finish. ABfit shows a list for you to check – adjust the amounts, then add.

Alternatively you can type the text.

📷 Photo of the meal

1. Tap Photo and photograph your plate (ideally from diagonally above, with everything visible).
2. The AI recognizes the components and estimates the amounts – even filled dishes are broken down into their parts.
3. Check the list: tap grams to change them, remove with ✕. A red-marked row is not matched yet – tap it and choose the right food.
4. At the bottom tap “Add … items” – done.

Note: It is an estimate. The photo is sent only for recognition; in addition ABfit keeps a small copy as the “Before” photo with the meal (for “Photograph leftovers”, see below).

🍽️ Photograph leftovers: did not finish?

Did you log a meal by photo and not eat everything? Then you do not have to recalculate amounts by hand: photograph the plate after eating, the AI estimates what is left, and ABfit deducts it for you.

1. Right after saving, ABfit asks “Did not finish?” – tap Photograph leftovers. With “Later” you close the window; the question stays for 4 hours as a card at the top of the Day overview (can be hidden with ✕).
2. Tap Photo of plate and photograph the plate after eating. The AI compares the picture with the Before photo and estimates, for each component, how much is left.
3. Check the sliders (0 to 100 %, in steps of 5 %): they show what is left of each component. At the top, “−… kcal saved” updates live. Set them the way it really was.
4. Tap Deduct leftovers. Amount, calories and nutrients of the entries go down accordingly; a small dot on the entry marks the deduction. “Undo” in the message restores everything immediately.

Good to know: Inside the entry you see both photos and the saving. With “Undo deduction” you restore the original amount. If you later change the entry’s amount by hand, the deduction is reset automatically.

▦ Barcode

1. Tap Barcode and hold the camera on the barcode of the package (allow the camera the first time).
2. The product opens with its nutrition values – choose the amount and add it.
3. Scanning does not work? Take a “Photo of barcode” or enter the number.
4. If the product is unknown, you create it – fastest by photographing the nutrition label (next section).

6. Photograph the nutrition label

If the barcode does not work or the product is in no database, you do not have to type in the values: simply photograph the nutrition label on the package. An image AI (vision) reads the numbers and fills in the new food for you.

1. Scan the barcode or type it in. If it is unknown, “Create product” opens – or choose “+ Create custom food” in the Food tab.
2. Tap 📷 Photograph nutrition label and photograph the label on the package. Hold the phone straight, use good light, and get the whole table in the picture.
3. Wait a moment (“Reading the nutrition label …”): name, brand and the nutrition values (calories, protein, carbs, sugar, fat, fiber, salt) are filled in per 100 g; also serving and package size if they are given there.
4. Check the values against the package, correct anything that is wrong, and tap Save. The food is now in your search (tag “custom”) and linked to the barcode.

7. Edit entries and delete several at once

1. Open the Day overview (tap the calorie ring in the Cockpit) and tap a meal to expand it.
2. Change: tap an entry → change the amount or meal → Save. Or Delete.
3. Quick delete: the small ✕ to the right of an entry.
4. Delete several: at the bottom of the meal tap Select → tick entries (or All) → “Delete 2” → confirm.
5. Deleted by accident? Tap Undo in the message at the bottom within 6 seconds.

8. Day wrap-up, water and AI rating

1. In the Day overview, scroll down to the Day wrap-up (or open it under More → Day wrap-up).
2. Water: tap the matching number of liters (1 – 3 l) or “…” for your own value.
3. Rate the day: the AI gives a traffic light, a grade, what went well, what you can watch out for and one concrete tip.
4. You can also have each meal rated individually: expand it → Rate meal.
5. Below that: your current weight and the week as a bar with calories and water per day.

9. Recipes: paste text

You find recipes in the Food tab via the 📖 Recipes button at the top right.

1. Tap + Paste new recipe.
2. Paste the recipe text (e.g. from a website, a blog or an AI chat) – or tap “From clipboard”.
3. Tap Recognize. ABfit matches each ingredient to a food and calculates the nutrition values.
4. Check ingredients and servings (adjustable with − / +). Rows with ⚠︎ are not matched yet – tap them and choose the right food.
5. Tap Save recipe. With Add to diary you log one serving directly. Saved recipes also appear in the food search (tag “Recipe”).

10. Recipe from a photo

Is the recipe only available as a picture – in a cookbook, in a magazine or as a screenshot? Then you do not need to type anything: an image AI (vision) reads title, ingredients, amounts and servings and creates the recipe for you.

1. Open Food → 📖 Recipes → + Paste new recipe.
2. Tap 📷 Photo or screenshot of recipe at the top and photograph the page – or choose a screenshot from your photos.
3. Wait a moment (“Reading recipe from image …”). ABfit recognizes the title, the number of servings and each ingredient with its amount, and matches them to foods.
4. Check the result: adjust servings with − / +, change amounts, tap unmatched rows (⚠︎) and choose the right food, remove rows with ✕.
5. Save recipe – the nutrition values per serving appear immediately. With Add to diary you log one serving.

11. History: weight and body fat

1. In the History tab (or by tapping the Weight card in the Cockpit) you see your current weight, the change and – if available – your body fat percentage.
2. Choose the period: 30 T, 90 T, 1 J (that is 30 days, 90 days, 1 year) or All.
3. New weight: enter it further down and tap Save – or let it come automatically via Apple Health.
4. All measurements are listed under History; delete one with ✕.

12. Activity: steps and workouts by hand

Steps and active calories normally arrive automatically from Apple Health. But you can also enter them yourself – for example if your iPhone was not with you or you have not (yet) set up the sync.

1. Open History (or tap Steps in the Cockpit) and scroll to the Activity section.
2. Enter steps manually: enter the date and the number of steps → Save. The active calories are estimated from the steps and raise your daily budget.
3. + Log workout: What? (e.g. Running), Minutes, optionally kcal (empty = ABfit estimates) → Add. Only needed if your watch did not record the workout.
4. The most recently entered value counts: steps and active kcal that you enter by hand apply to the day until a real transfer from Apple Health arrives. Then the Health values replace your entry; if a transfer has no values for that day, your entry stays.
5. With the ✕ next to a logged workout you delete it again.

13. Medications

The Medications page is your medication diary – for example for a GLP-1 therapy. ABfit shows only what you have entered yourself. You reach it in two ways: via the medication hint in the Cockpit (it appears when a dose is due) and at any time via More → Log & dose curve or More → Log medication.

1. Tap ＋ Log medication (or go directly via More → Log medication).
2. Check Date & time, choose the Product (or “Other” with your own name), tap or type the Dose, optionally Site (belly, thigh, arm), a note and side effects (strength 1–5).
3. Save. The chart “Dose + weight trend” shows your logged doses together with your weight (3M, 6M or All).
4. At the top is “Next dose”: it is calculated only from your past intervals. Under Past entries you tap an entry to change or delete it.
5. If the same site was used several times in a row, ABfit reminds you to rotate.

14. Settings: profile and goals

1. Open More → Settings – or tap the yellow profile icon at the top right of the Cockpit.
2. Enter sex, date of birth, height and weight.
3. Choose your Daily activity (no sport), your Goal (lose weight, maintain weight, gain weight) and the Pace.
4. ABfit calculates your daily goal from this. You can also set it yourself.
5. Optionally the Macro split in percent (together 100 %).
6. Save – the new goal applies immediately.

15. Choose a language (6 languages)

ABfit is available in six languages: Deutsch, English, ไทย (Thai), Français, Italiano and Español. The default language is German.

1. Open More → Settings and scroll to Language.
2. Tap the language you want. The app switches immediately.
3. The choice applies to this device and your account.

16. Change password and account

1. Open More → Settings and scroll to Account.
2. Enter your Current password.
3. Type the New password twice (at least 8 characters) and tap Change password.
4. With Delete account (at the very bottom, red) you permanently remove, after confirmation, all your entries, recipes, weights, Health data and medications – this cannot be undone.

Important: Do not share your password or Health key.

17. Connect Apple Health

With the shortcut “ABfit Sync”, your iPhone sends steps, active calories, weight, body fat and workouts to ABfit. Set it up once – after that it runs automatically. (Without Health you enter steps and workouts by hand, section 12.)

A) Install the shortcut

1. In ABfit open More → Settings → Apple Health & Sync and tap Copy next to “Key”. (Never share the key.)
2. Tap ⬇️ Install shortcut → Add Shortcut.
3. Paste the copied key into the field → Add.
4. Tap the shortcut once and allow access to Health (turn on all categories). When asked about the internet address, choose Always Allow.
5. A message with the result appears at the top; in ABfit you see “Last sync”.

B) Allow large amounts of data

1. Open iPhone Settings → Apps → Shortcuts → Advanced.
2. Turn on “Allow Sharing Large Amounts of Data”. Otherwise the sync aborts when there are many values.
3. It is best to also allow “Allow Running Scripts” or confirm scripting prompts, if your iPhone asks for it.

C) Automation: automatically several times a day

1. Open the Shortcuts app → Automation at the bottom → + (or “New Automation”).
2. Choose Time of Day → e.g. 9:00 → Daily.
3. Choose Run Immediately and turn “Notify When Run” off → Next.
4. Select ABfit Sync → Done.
5. Repeat for more times, e.g. 13:00, 18:00 and 21:30.
6. Also possible: + → App → Health → “Is Opened” → Run Immediately → ABfit Sync.

D) Import old data (years)

1. Health app → profile picture at the top right → Export All Health Data → Export.
2. Choose Save to Files.
3. In ABfit: More → Settings → Apple Health & Sync → Upload Export.zip → choose the file (optionally “From date”).
4. The bar shows the progress – keep the app open until the end.

18. Appearance: Light and Dark

1. Open More → Settings and scroll to Appearance.
2. Automatic follows your device’s setting (light by day, dark at night, if set that way).
3. Light or Dark forces that appearance.
4. The setting applies to this device.

19. iPad and computer

ABfit adapts to the screen size – you do not need to switch anything, and it is always the same data as on the iPhone.

1. iPhone / narrow screen: one column, the four tabs (Cockpit, Food, History, More) at the bottom.
2. iPad in portrait (from about 768 px width): the Cockpit uses two columns – the large calorie ring on the left, the four rings and the card with weight, steps and progress on the right; the tabs stay at the bottom.
3. iPad in landscape and computer (from about 1024 px): the tabs appear as a sidebar on the left, and the content has a calm, centered layout.
4. On a computer you simply open ABfit in the browser via the same link and sign in with the same account.

20. Frequently asked questions

I logged something twice by accident.

Expand the meal → Select → tick the duplicates → delete. The buttons lock after the first tap so that this does not happen again.

The photo recognition got something wrong.

In the check list, tap the row and choose the right food, adjust the grams or remove the row with ✕ – only then add it. This also applies to recipe and nutrition label photos.

I did not finish everything – how do I deduct that?

Right after the photo entry tap “Photograph leftovers” (or later via the “Did not finish?” card in the Day overview), photograph the plate after eating, check the sliders and tap “Deduct leftovers”. You can undo it at any time via the entry → “Leftovers deducted” → “Undo deduction”.

My steps are not arriving.

Start the shortcut “ABfit Sync” by hand once and read the message. Check that Health access is allowed and “Allow Sharing Large Amounts of Data” is on. If necessary, enter the steps by hand under History → Activity.

Why is my daily goal higher than yesterday?

Activity (steps, sport, active calories) raises your budget for the day.

Can anyone else see my data?

No. Every account is separate. Do not share your password or Health key.

The app looks odd after an update.

Close ABfit completely (swipe up from the bottom edge) and open it again – then the new version loads.

Can ABfit tell me how much I should take?

No. The Medications page only stores what you enter. Please always ask your doctor about dosing.

Where did the “Overview” and the “Medications” go?

Both are still there. The former Overview is now called Day overview: tap the large calorie ring in the Cockpit or open More → Day overview. You open Medications via the medication hint in the Cockpit or under More → Log medication or Log & dose curve.

Is the guide also available in the browser?

Yes: More → Help shows a short help in the app; via “Open the full guide with pictures” you reach the help page with the Feature Overview and the User Guide. Both are also available as PDFs to download.

Back to top ↑