A food, weight and workout tracker for Linux and Android. It works offline, keeps everything in a folder you pick, and doesn't need an account or a server.
- Plan meals, tick off what you've eaten, and see your remaining calories and nutrients.
- Search bundled foods offline, including Greek search terms, or add your own.
- Save recipes and weigh each cooked batch to calculate nutrition per portion.
- Follow your weight trend and estimate maintenance calories from your logs.
- Save workouts and record sets, reps and weights.
| Plan your day | Follow your progress | Keep your favourites |
|---|---|---|
![]() |
![]() |
![]() |
There's a light and a dark theme, and you can pick the accent colour.
You'll need Android 11 or newer and a Regimen APK (the Android installation file). If you're building it yourself, use the build instructions below.
- Copy the APK to your phone, then open it in your file manager.
- If Android asks, open Settings and enable "Allow from this source" for that file manager. Return to the APK and tap Install.
- Open Regimen and follow the first-run setup.
This uses Android's "Install unknown apps" permission. You only need Developer options and USB debugging for the USB method below. See Google's APK installation instructions if you can't find the permission. If Android specifically blocks an unverified developer, follow Google's additional setup steps.
-
On your phone, open Settings, then About phone. Find "Build number" (on Samsung, it's under "Software information"). Tap it seven times and enter your phone's PIN if asked. Android will confirm that Developer options are enabled.
-
Return to Settings and search for "Developer options". Open it and enable "USB debugging". Menu names vary by phone; see Android's Developer options guide.
-
Connect the unlocked phone to your computer with a USB cable that supports data. Accept "Allow USB debugging?" on the phone to authorise your computer.
-
Install Android SDK Platform-Tools on your computer, or your Linux distribution's
adbpackage. Withadbon your PATH, check the connection:adb devices
Your phone should appear with
devicebeside it. If it saysunauthorized, unlock the phone and accept the debugging prompt. If the list is empty, try another data cable or USB port. For Linux permission errors or Windows USB drivers, follow Android's device setup guide. -
In the directory containing your APK, install it with the following command. Replace
regimen.apkwith your file's name:adb install -r regimen.apk
Wait for
Success, then open Regimen on the phone. If more than one device is connected, useadb -s SERIAL install -r regimen.apk, replacingSERIALwith the identifier shown byadb devices.
When updating, -r keeps the app's data, as long as the new APK is signed with
the same key as the installed one. If Android complains about a signature
mismatch, get a build signed with the original key instead of uninstalling, and
back up your data first if you do have to uninstall. See the ADB install reference.
- Choose a folder for your data. On Android, use the folder picker and grant access. On Linux, enter the folder's full path.
- Give each device a different name, such as
phoneandlaptop. Use letters, digits, hyphens or underscores, then select Start. - Set your maintenance calories and nutrient targets in Settings. On Today, choose Cut, Maintain or Bulk, add your food, and tick it when eaten. You can also enter your weight and steps there.
To use it on more than one device, set up Syncthing on each, share the data folder between them, and point Regimen at that folder everywhere. The path doesn't have to be the same on each device. Regimen only ever saves locally, and Syncthing moves the changes across whenever the devices can reach each other, so logging offline is fine.
With one device, a local folder is all you need. Back it up if you want a second copy of your history. You can change the folder and device name later in Settings.
On Linux you build it from source for now. Install the prerequisites and dependencies below, then run this from the project directory:
scripts/install-linux.shThe script puts the app in ~/.local/bin and adds it to your app launcher.
Run it again to update.
Built with Tauri 2, React, TypeScript and Tailwind. Start with Node.js 22.12 or newer, pnpm, Rust, and the Tauri prerequisites for your platform. Clone this repository, open its directory, then install the project dependencies:
pnpm installBuild an Android APK
Follow Tauri's Android setup to install Android Studio, its JDK, and the Android SDK tools. This project uses Android SDK Platform 37. In SDK Manager, also install Platform-Tools, Build-Tools, Command-line Tools and NDK (Side by side).
Set JAVA_HOME to your JDK directory, ANDROID_HOME to the SDK location shown in
SDK Manager, and NDK_HOME to the installed version's directory inside the SDK's
ndk folder. The linked Tauri guide has platform-specific examples.
For a modern ARM64 phone, add the Rust target and build a debug APK:
rustup target add aarch64-linux-android
pnpm tauri android build --debug --apk --target aarch64The APK is written under src-tauri/gen/android/app/build/outputs/apk/.
Use the path printed by the build with adb install -r, or copy the APK to your
phone. It's a full build and doesn't need the development server running.
Debug APKs are signed automatically for local use. Release builds
(pnpm tauri android build --apk --target aarch64) need a signing key: this
project reads storeFile, keyAlias and password from
~/.local/share/android/regimen-release.properties. Without it, the release APK
is unsigned and cannot be installed. See
Android signing for creating a key;
keep the key and its passwords outside the repository.
Run locally and check changes
Run the desktop app with live reload:
pnpm tauri devFor Android development, connect your phone with USB debugging enabled and run
pnpm tauri android dev after completing the Android toolchain setup above.
Run the app tests and check the frontend build:
pnpm test
pnpm buildThe offline food catalogue comes from USDA FoodData Central SR Legacy (public domain), ANSES-CIQUAL 2020 (CC BY 4.0), and Open Food Facts products sold in Greece (ODbL). Once a food is in your own list you can edit it.
If you're working on the catalogue itself, the source downloads are in
scripts/build_reference.py, reviewed corrections in
scripts/food_cleanup.json, and Greek search terms in
scripts/food_keywords.el.json.
The catalogue review includes name corrections, confirmed sugar additions, and a CSV of missing sugar values with tentative estimates.


