← Leptir

User Manual

How to log meals and workouts, connect Telegram, and fix common issues.

What Leptir is

Leptir is a meal and workout logger that runs in Telegram. You create a web account, link it to Telegram with a one-time token, then log by messaging the bot. Logs and summaries appear on the web.

Quick Start

Create an account at the website.
Go to Connect Telegram (Settings or the onboarding flow).
Generate a pairing link. Open it in Telegram and tap Start.
Log meals with Meal: what you ate and workouts with Workout: what you did.
View your logs and daily totals on the web app.

Telegram required. All logging happens in Telegram. The web app displays your data and settings.

Connect Telegram

Create your account on the website, then go to Connect Telegram (Profile or Settings). Generate a pairing link and open it in Telegram within 10 minutes.

Token expires in 10 minutes. If it expires, generate a new link. You can regenerate as often as needed.

If the bot says you're not linked, go to Connect Telegram on the website and complete the flow.

Logging basics

Meals

Send a message starting with Meal: followed by a description. The bot estimates calories and macros and replies with the breakdown. You can also send a photo of your meal (with an optional caption).

Example messages:

Meal: 2 eggs, avocado toast, black coffee Meal: Grilled chicken salad with olive oil Meal: McDonald's Double Quarter Pounder, 10 cheese raviolis

Workouts

Send a message starting with Workout: followed by what you did. Workouts are logged without macros.

Workout: 30 min run, 5K Workout: Upper body, bench press 5x5

Add context

You can include quantities in your description (e.g. "8 oz steak", "2 cups rice"). The system extracts them when possible. Be specific for better estimates; vague entries may get rougher macros.

The bot parses common food names, branded items, and simple quantities. It may misread very ambiguous input or unusual dishes.

Coming soon: log past days. Right now all logs use the current time. Date selection for backfilling is not yet available.

Viewing on the web

Go to the web app to view your recent logs, totals, and settings.

Use /summary in Telegram for a quick daily recap.

Troubleshooting

Bot says not linked: Go to Settings → Connect Telegram on the website. Generate a new pairing link, open it in Telegram, and tap Start.
Token expired: Generate a new link in Settings → Connect Telegram. No limit on how many you can create.
I connected the wrong Telegram: Generate a new pairing link from the account you want to use; the bot will rebind your Telegram.
My logs appear under a different user: Generate a new pairing link from the account you want to use; the bot will rebind your Telegram. Only one Telegram can be linked per web account at a time.

Privacy & data

Logs (meals, workouts, weight) are stored and associated with your account. They are used to compute macros, summaries, and streaks. We do not sell your data. Retention and backup policies may change.

Support

For help, contact @leptir_support on Telegram.