Usage guide

Main tabs

• Dashboard — calorie ring, macros remaining, and the food / exercise log for the selected day. Empty state: Tap Log to add food or a workout.
• Progress — Weekly or Monthly charts (net calories, macros, body composition, burn) and the AI Progress Coach.
• Body — profile basics, body readings, daily targets, food library.

On Dashboard, the floating Log button opens the log hub. The gear opens Settings.

Browse & log past days

The Dashboard week strip shows the last seven days. Tap a day pill to jump there — the ring, macros, and log update for that date. Labels like Today / Yesterday make it easy to spot where you are.

• Week history — open the week view for stacked calorie bars and that day’s entries; swipe weeks to look further back.
• Log onto a past day — select the day first, then use Log. New meals and workouts are stamped on that calendar day (not always “now”).
• Clone to today — from an older entry you can copy a meal or workout onto real today when you want to repeat it.

Log food

From Log, under Food:

• Photo — take a picture of the plate
• Gallery — pick an existing image
• Describe — freeform text (Food or activity → Analyze)
• Build meal — assemble multiple foods
• Saved meal — pick a meal preset; it logs immediately with a confirmation pill (name + kcal)

From Build meal you can also pick a Saved food for one-tap add into the meal you’re assembling.

Build a meal

Opens Build a meal. Add items via Scan (barcode), Saved food, Create new food, or Add food manually, then Review & save meal.

Barcode

Point the camera at a barcode, or type an EAN/UPC. Scanning uses an open-source decoder on-device (no Google ML Kit); FitBuddy then looks up the product on Open Food Facts (needs network). From Body you can also Scan barcode to save into your food library.

Review & edit

After AI analysis you get Review food (or a meal review). Typical actions:

• Edit dish name and ingredient weights — macros rescale live
• Recalculate with AI if the estimate looks off
• Bookmark: Save to food library (single food) or Save as meal preset (meal)
• Confirm: Log food / Save meal / Update meal

From the selected day’s log you can open an entry again to edit or delete it.

Log a workout

Log → Workout opens Log Workout. Add exercises (sets, reps, weight, or duration/distance as needed), then Save & Estimate Calories. FitBuddy uses AI (when configured) plus your body factors for the burn estimate. Existing sessions can be opened as Edit Workout and saved with Save Changes.

Body tab

Under Body & goals:

• Body basics — age, height, weight, sex, activity, goal
• Body composition — Add a reading (weight and optional metrics)
• Daily targets — calories and macros; optional Recommend with AI → review the plan → Apply or Discard
• Food library — saved foods; manage or scan new ones
• Save body data when you edit fields manually
• Reading history — past measurements

Progress & coach

Toggle Weekly / Monthly. In Monthly mode, use the month arrows to step through history (e.g. This month · Jul 2026). Charts include net calories vs target, macronutrient trend, body composition, and calories burned.

AI Progress Coach: Generate insight / Refresh insight, then Ask follow-up questions to open Progress Coach chat. The coach now gets a compact multi-month snapshot (recent days plus older monthly averages) so insights stay useful as your history grows. Leaving may ask Leave conversation? with Keep chat or Clear & go back.

Coach features need a configured AI provider (same as logging).

Settings

AI Provider

• Auto failover — on failure, try other API keys, then other models on the same platform. Never switches platforms automatically. When off, only the selected model is used; keys still rotate on failure. Rate-limited models are skipped until the next UTC midnight, then your preferred dropdown model is tried first again. A green active pill shows the last model that worked without changing your dropdown choice.
• Provider segments: OpenRouter / Gemini / Ollama (Local or Cloud) / OpenAI
• OpenAI — paste an OpenAI API key; defaults to gpt-4o / gpt-4o-mini with a curated model catalog. No free tier, so paid models stay on and Auto failover stays off for this provider.
• Ollama Local — points at any OpenAI-compatible server (Ollama, LM Studio, vLLM, LocalAI, or https://api.openai.com) with an optional API key; keyless local servers still work.
• OpenRouter — Continue with OpenRouter for account sign-in, or expand API keys to paste keys. Manual keys are preferred when both exist; Disconnect OpenRouter clears the sign-in token.
• Multiple API keys as chips (Gemini / Ollama / OpenAI / optional OpenRouter keys)
• Show paid models — off by default (free vision / free text lists). Turn on to include paid models in the Photo and Text dropdowns.
• Photo model and Text model dropdowns
• Save AI Settings

Daily log reminder

Under Preferences:

• Daily log reminder — local notification once a day (default 8:00 PM). No Google Play Services required.
• Reminder time — tap to change the hour and minute.
• Android may ask for notification permission. If you deny it, the reminder turns off.
• For on-time delivery, allow Alarms & reminders (exact alarms). If they’re off, FitBuddy shows a warning and an Allow exact alarms button — reminders may otherwise be delayed.
• Material You — dynamic color on Android 12+

Backup & cloud

Under Backup:

• Support ID — copyable anonymous ID for crash support and as the cloud backup document key. Keep it somewhere safe.
• Export — write a JSON backup (logs, profile, settings, presets, and related data) to a file you choose. The export dialog lets you optionally set a password (8–128 chars) — the file is then encrypted with AES-256 and needs that password to restore.
• Enable cloud backup — opt in when the build includes the cloud vault. You’ll be prompted to copy your Support ID first, and can optionally set a backup password (leave it blank to use default Support ID protection). Either way the backup is encrypted on-device before upload — the cloud only ever stores encrypted data.
• Change cloud backup password — update the password later from Settings; leave it blank to reset to default (Support ID) protection.
• Auto-upload on startup — when enabled, uploads on app start if the last upload was more than 12 hours ago.
• Upload now — immediate upload while cloud backup is on.

Restoring an encrypted backup (cloud or local) prompts for the password, with up to five attempts and clear messages for wrong-password, corrupt, or unrecognized files. Your custom password is stored device-only via the Android Keystore and is never included in exports or uploads.

Restoring from cloud or a local file happens during onboarding (or via Developer tools if unlocked). Day-to-day Settings does not offer Import — use Export + onboarding restore.

Other

• Send crash reports and your Support ID under Backup (see Privacy)
• Check automatically for updates, or Check for Updates manually

Install & updates

1. Download the APK from GitHub Releases.
2. Allow install from your browser/file manager if Android asks.
3. Later, Settings (or automatic check) can show Update available → Download & install. Keep the app open until the system installer opens.

See also: Onboarding · FAQ · Privacy