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.