Answers

Frequently asked
questions

Short answers. For a walkthrough, see the beginner guide.

AI & keys

Do I need an API key?
For real AI logging, yes — OpenRouter sign-in, or a key for Gemini / OpenAI / Ollama Cloud. Local Ollama needs a reachable URL. Without a provider, the offline simulator still demos the UI. Step-by-step with videos: Onboarding guide.
Which provider should I pick?
OpenRouter is easiest for free vision models. Gemini if you have a Google AI Studio key. Ollama for local / LAN or Ollama Cloud. OpenAI-compatible for official OpenAI or hosts like LM Studio, vLLM, LocalAI, Together, or Groq. Full setup: pick a provider.
What does Auto failover do?
On failure it tries other keys/models on the same provider — it never jumps platforms for you.

Region

What does the region pack do?
It personalises AI prompts, staple references, portion language, and food-log examples. Only the active pack is used — packs aren’t merged. Change it anytime under Settings → Preferences.
Can I request a region that isn’t listed?
Yes, from the region picker (with crash reporting enabled). One anonymous request per install; no meals, photos, or API keys are included.

Logging & accuracy

How accurate are calorie estimates?
They’re model estimates, not lab measurements — especially for mixed plates. Always review weights. Weigh ingredients when precision matters.
Can I edit a meal or workout later?
Yes. Open it from the day log. Meals support live macro rescale; workouts support sets/reps/weight, demo GIFs when editing, and AI session names.
Barcode not found?
Lookups use Open Food Facts after on-device decode. FitBuddy can help you contribute a missing product; otherwise describe the food with photo or text.
What does “Monthly” mean on Progress?
A rolling 30-day window ending on the day you select — not a calendar month. The six-month burn view is a compact heatmap of exercise calories.

Workouts

Where do exercises and GIFs come from?
FitBuddy ships a searchable catalog of roughly 1,500 exercises (ExerciseDB via CDN). Demo GIFs load when you pick or edit a move; the JSON catalog is cached on disk for offline picking.
How is workout calorie burn calculated?
Structured sessions use an on-device MET formula (intensity × duration × body weight). You don’t need AI online just to estimate burn for those workouts.
Can I favourite exercises or pin filters?
Yes — star exercises you reuse, and long-press a filter chip to pin it so the picker stays ordered the way you train.

Targets

How are calorie and macro targets calculated?
FitBuddy calculates adult target candidates deterministically on-device from your profile, activity, and goal. Consistent body and food history may support one bounded adjustment; optional AI can only select an exact local candidate. Read the full health target methodology.
Can I set targets myself?
Yes — save calorie and macro targets manually anytime. Calculated plans remain available when you want a fresh proposal.
Why didn’t my old days’ targets change when I updated my goal?
By design. Past log days keep the targets that applied then so Progress history stays accurate.

Reminders

How do daily reminders work?
Settings → Daily log reminder. Allow notifications; for timely delivery also allow Alarms & reminders.

Support

Where can I ask questions or follow announcements?
Join the public Telegram group for release notes, app questions, and chat with the developer. Bug reports also welcome on GitHub Issues.
How do donations work?
Optional. India installs are offered Razorpay (UPI/cards); other regions use GitHub Sponsors. Payment apps open only when you choose them.
What are supporter thank-you cards?
Named public supporters appear on flip thank-you cards in the app and on the Supporters page. Optional support reminders stop once your Support ID is on that public list. Amounts are never shown publicly.

Backups

Is cloud backup encrypted?
Yes — AES-256-GCM on-device before upload. See Encryption.
I forgot my backup password
There is no recovery. That’s the point of zero-knowledge encryption. Keep a copy of the password somewhere safe.

Updates

F-Droid vs GitHub APK?
Same codebase, different signing keys. Don’t install one over the other expecting a seamless update — pick a channel and stay on it.
How do F-Droid updates work?
F-Droid delivers updates through the F-Droid client. FitBuddy’s F-Droid build can also check for a newer package and point you at F-Droid when one is available.
How do GitHub updates work?
Update checks open the APK download in your browser. FitBuddy does not sideload installers itself. The GitHub checker is disabled on the F-Droid flavor.

Download APK · Privacy