LiftTrace

Track every rep, set, and PR — your complete weightlifting companion.

A self-hosted weightlifting tracker that runs entirely in a single Docker container on your own hardware. No accounts on external services, no data leaving your network, no subscriptions.

Principles

• Self-hosting is free. No paid tiers, no feature flags gating things behind a subscription, no nag screens.
• No telemetry. LiftTrace never phones home. There is no central server that receives your data, no analytics, no crash reporting, no fingerprinting.
• Your data, your hardware. Everything lives in a single SQLite file and an uploads folder on your machine. Back up either with cp, restore with cp, migrate to a new server by moving the volume.
• AGPL-3.0. The source is open and the network-use clause keeps it that way.

Features

Diary

• Daily workout logging with date navigation and calendar picker
• Per-exercise set tracking: weight, reps, RPE (optional), completion checkboxes
• Warm-up sets flagged separately — excluded from volume, PRs, rest-timer firing, and workout summaries
• Smart Add — type or speak your workout ("bench 3x5 @ 225, A1: curls 3x12 @ 30, A2: pushdowns 3x12 @ 40") and Trace parses prose into structured sets and matches exercises against your library. Handles AMRAP, RPE, ranges, bodyweight, and supersets. Also available as a hold-to-record gesture on the Trace FAB — press and hold, speak, release to commit.
• Progressive overload auto-fill — pre-fills weight/reps from your last session
• Program template prefill — target weight/reps from active program templates flow into the diary when you load a workout
• Coach prescriptions — if a trainer has prescribed today's workout, it shows in Diary on the right day
• Last workout quick-load — recent workouts as one-tap cards on empty diary
• Workout completion summary with a Share button — generate a 1080×1350 PNG card and share via native share sheet on mobile or download on desktop
• Exercise reordering, add/remove sets on the fly, confirm before removing
• Superset grouping with visual cards, circuit management, and superset-aware rest timer — only fires between rounds, not between exercises in a round
• Progress-aware card accents — left-edge strip colors reflect set completion at a glance
• Auto-collapse completed exercises and supersets when every set is done
• Floating workout mode bar — centisecond timer + wake-lock toggle visible on every page
• Rest timer with countdown, auto-start on set completion, separate vibrate and tone toggles, persistent across navigation
• Gym Tools — plate calculator + lbs↔kg converter in the diary toolbar
• Body stats logging (weight, body fat, measurements) from the date bar
• Screen wake lock to keep your phone on during workouts
• Right-click = long-press on desktop for quick actions on exercise cards

Programs & Templates

• Create structured programs with multiple workout templates
• Goal-based programs: strength, hypertrophy, cutting, bulking, endurance, general
• Starter templates seeded for new users (Push/Pull/Legs, Upper/Lower, Full Body 3x)
• Template reordering, duplication, and assignment to users
• Active program indicator — load today's workout with one tap

Exercise Library

• Multi-source exercise catalog:
  • wger — ~600 exercises, free and open (CC-BY-SA)
  • Free Exercise DB — ~870 exercises with start/end position images (public domain)
  • ExerciseDB — ~1,300 exercises with animated GIFs (RapidAPI, free tier available, bring your own key)
• Custom exercises — create your own with uploaded images, GIFs, videos, or YouTube embeds. They appear inline in the library with a "Custom" chip.
• Custom XLSX Import — bulk-import exercises from a spreadsheet with named catalogs, equipment tags, and descriptions
• Exercise detail view with animated media, search, category filtering, equipment sub-filters
• Similar exercises — every detail page suggests substitutes based on primary/secondary muscle overlap
• Favorite exercises — star icon per exercise, favorites sort to top
• Personal record tracking per exercise
• Enable/disable individual sources and imported catalogs independently

Statistics

• Metric-pill layout — pick what to analyze (Overview / Exercise Progress / Records / Volume / Frequency / Body Weight); same controls for every view
• Overview: streaks, workouts in range, avg per week, 90-day activity heatmap, weekly volume + frequency charts
• Exercise Progress: pick any exercise and see top-set weight over time, min/max/avg, and complete session history
• Records: recent PRs feed + PRs grouped by muscle category
• Volume: weekly totals + muscle-group breakdown showing imbalances
• Frequency: weekly counts + weekday distribution
• Body Weight: trend line + current/min/max/change summary
• Configurable date ranges (1W / 1M / 3M / 6M / 1Y / All) apply to every metric

Trace — AI Coach

• Floating draggable chat assistant with animated robot face shared across the TraceApps family
• Live data context — every message ships the active program + templates, last 14 workouts (warm-ups filtered, RPE annotated), 30-day body weight trend, top 10 PRs, weekly goal + 4-week frequency, streaks, and today's coach prescription if one exists
• Hold-to-voice-log — press and hold the FAB to record a voice workout; release on the FAB to commit (parses and opens the Smart Add review screen), slide off to cancel
• Frequency visualizer ring — 32 SVG bars radiate from the FAB while music is playing, driven by real-time Web Audio analysis
• Attach photos for form checks (camera or gallery)
• Quick-ask suggestion chips
• Supports Claude (Anthropic), OpenAI, Google Gemini, and any OpenAI-compatible endpoint (Ollama, LM Studio, DeepSeek, Groq, etc.)
• Bring your own API key — or use the server-side proxy and lock the provider for all users

Radio (Music Player)

• Stream music from your self-hosted media server during workouts: Subsonic (Navidrome, Airsonic, Funkwhale, Gonic), Jellyfin, Plex, Emby
• Streaming stations — internet radio URLs (Icecast, Shoutcast, HLS / .m3u8) with browse, add/edit/delete, station groups, and now-playing metadata from StreamTitle, text=, RDS Italia, and embedded ID3 frames
• Library browser: albums, artists, playlists, search
• Mini-player bar + full player with album art, seekable progress, shuffle, repeat, queue
• MSE pipeline on web for gapless, background-resilient playback — audio never pauses between tracks so locked-screen tab-freeze can't stall auto-advance
• Unified Android player — radio + library both flow through Media3 ExoPlayer + MediaSession with lockscreen + Bluetooth controls (Stop for radio, Prev / Next / Stop for library)
• Keep original format toggle for bit-perfect playback; falls back to 320 kbps MP3 transcoding when codecs are mixed
• 2-track pre-fetch so skip is instant for large files
• Crossfade between tracks (1-12 seconds)
• Full lock-screen controls via Media Session API

Coaching

• Trainer accounts build templates and prescribe workouts to athletes
• Prescriptions show in Diary on the right day
• Trainer / athlete pairing managed in Settings → User Management
• One athlete can have multiple trainers

Multi-User

• Mandatory account creation on first PWA visit (secure by default)
• Role-based access: admin, trainer, member
• Admin invites via email or shareable link
• All data scoped per user
• Configurable session timeout (up to 1 year, cap configurable in env)
• zxcvbn password strength validation across wizard, profile, reset, and accept-invite flows
• Email (SMTP) configuration in Settings or via environment variables
• Recovery token to disable user management from the login page if you get locked out

Single Sign-On (OIDC)

• Multi-provider OIDC SSO: sign in via Authentik, Keycloak, Pocket ID, Authelia, Auth0, Google, or any OIDC 1.0 provider supporting Authorization Code Flow + PKCE + Discovery
• Provider preset picker (pre-fills sensible defaults per IdP) plus a Custom option
• Auto-link verified emails to existing accounts and Auto-register blanket-signup toggles
• Admin group mapping — promote users to admin based on group claims
• Configurable from Settings → User Management → OIDC providers, or declared in env (OIDC_* / OIDC_PROVIDER_N_*). Env-defined providers show with a lock badge and are read-only in the UI.
• Encrypted client secrets at rest (AES-GCM with HKDF-derived key)

Workout History Import

• Bring your old log in from Strong, Hevy, FitNotes, or Jefit (CSV exports)
• Two-step preview → commit flow
• Fuzzy-matches exercise names against your library; unmatched names persist as free-text and can be relinked later
• Skip vs replace on duplicate-date workouts

Body Stats

• Log body measurements from the diary (scale icon in date bar)
• Track: weight, body fat %, neck, chest, waist, hips, biceps, thighs, calves
• Per-measurement visibility toggles in Settings
• Units adapt to your weight unit preference (lbs/kg → in/cm)

Settings & Customization

• Light / dark / system theme
• 12 accent color presets + custom hex color picker
• Configurable navigation (bottom bar, sidebar, or both)
• Animated page banners (toggle on/off)
• Collapsible settings sections with sticky search bar
• Date and time format options (US / EU / ISO, 12h / 24h)
• Weight units (lbs / kg)

Notifications & Reminders

• Device notifications (Web Notification API) + push services (Gotify, ntfy, Apprise)
• Workout day reminders, rest day reminders, streak alerts
• Workout completion and personal record celebrations
• Weekly summary (push + email) with workout count and volume

Backup & Restore

• Full backup: ZIP archive of all database tables + uploaded exercise media
• Backup list with download, restore, and delete per entry
• Upload and restore from a backup taken on another instance
• Progress indicator during upload and restore
• Reset to defaults (settings only, workout data preserved)

Apps

Web (PWA)

LiftTrace is a Progressive Web App. Open it in any modern browser and install via the address bar (Chrome) or share menu (Safari). It works offline once cached and gets a proper app icon, full-screen mode, and OS-level navigation.

Android

A native Android app is published on the Releases page. Sideload the signed APK from any release tag (e.g. lifttrace-1.0.0-rc.1.apk). The app is a Capacitor 8 shell around the same PWA, with these native upgrades:

• Offline-first — runs entirely locally with on-device SQLite, or connects to a self-hosted LiftTrace server for sync
• Native setup wizard on first launch: pick Local mode or Server mode
• Biometric sign-in (fingerprint / face) for the app
• Native ExoPlayer for radio + library playback with lockscreen + Bluetooth controls
• WorkManager-based reminders (optional) for reliable rest-timer + workout-day notifications even when the app is killed
• Local image cache for exercise media so the library is browseable offline
• Local backup — JSON dump of every cached table via the share sheet
• Voice input on the Trace FAB

Release-signed APKs require HTTPS to your server (see DEPLOY.md for the four supported paths including self-signed certs). Debug-signed APKs (built locally) accept any URL including plain HTTP.

iOS

There is no iOS app yet. Install the PWA from Safari (Share → Add to Home Screen) for the closest equivalent. A native iOS build is not blocked by code (Capacitor supports iOS), but it requires a Mac and a paid Apple Developer account, which isn't on the roadmap.

Self-Hosting with Docker

Quick Start

services:
  lifttrace:
    image: ghcr.io/traceapps/lifttrace:latest
    container_name: lifttrace
    ports:
      - "3002:3003"
    volumes:
      - ./data/db:/data/db
      - ./data/uploads:/data/uploads
    environment:
      - DB_PATH=/data/db/lifttrace.db
      - UPLOADS_PATH=/data/uploads
      - JWT_SECRET=change-me-to-a-long-random-string
    restart: unless-stopped

docker compose up -d

Open http://localhost:3002 and you're lifting.

See DEPLOY.md for the full guide: reverse proxies, subpath mounting, Cloudflare Tunnel, Docker secrets, and the four Android HTTPS paths.

Environment Variables

The most common ones — full reference in DEPLOY.md and .env.example.

Data Persistence

All data lives in two bind-mounted directories:

• /data/db/lifttrace.db — SQLite database (workouts, exercises, programs, body stats, settings, AI chat history)
• /data/uploads/ — exercise images, GIFs, videos, full-backup ZIPs

Back up both with cp -r or any volume-aware tool. Restore by stopping the container, replacing both, and starting again.

Updating

docker compose pull
docker compose up -d

Data is in bind-mounted volumes and persists across updates.

Translations

LiftTrace is built for translation via svelte-i18n with one JSON file per locale in src/i18n/. Adding a new language is straightforward — copy src/i18n/en.json to src/i18n/<code>.json, translate values, register the locale in src/i18n/index.js, and run npm run i18n:check. See CONTRIBUTING.md for the full flow.

About a third of UI strings are extracted as of 1.0.0-rc.1 — the surface every user touches every session. The rest is being extracted incrementally; PRs that grow the extracted set are welcome.

Tech Stack

• Frontend: Svelte 5 (running in Svelte-4 compatibility mode), svelte-spa-router (hash routing), Vite 6, Chart.js
• Backend: Express 5, better-sqlite3, bcryptjs 3, JWT auth (cookie-based)
• PWA: vite-plugin-pwa, installable on any device
• Android: Capacitor 8, Media3 ExoPlayer, WorkManager, @capacitor-community/sqlite
• AI: Multi-provider (Claude, OpenAI, Gemini, OpenAI-compatible) with multimodal image support
• Deploy: Docker multi-stage build, GitHub Actions CI → GHCR

Development

# Frontend dev server (port 5173, proxies API to :3003)
npm install
npm run dev

# Backend (in a separate terminal)
cd server
npm install
npm run dev

Android build:

npm run android:debug     # vite build + cap sync + assembleDebug
# APK at android/app/build/outputs/apk/debug/app-debug.apk

See CONTRIBUTING.md for pull-request guidance and the translation workflow.

Troubleshooting

• Login appears to succeed but every page 401s → cookies are being dropped because the server thinks it's on HTTPS but your reverse proxy is plain HTTP. Set INSECURE_COOKIES=1 (LAN only) or put TLS in front (recommended).
• Android app says "Connection failed" with HTTPS hint → release APK rejects http://. See DEPLOY.md → Connecting from Android for the four supported paths.
• Exercise images not loading on Android → external image URLs are proxied through the server. Check that the server is reachable from the device and /api/proxy returns 200.
• Rest timer beeps don't fire when the app is backgrounded → on Android, enable the WorkManager-based scheduler in Settings → Notifications.

For anything else, open an issue at github.com/TraceApps/lifttrace/issues.

Sister App

LiftTrace is part of the TraceApps family alongside NutriTrace — a self-hosted nutrition tracker. Same philosophy: privacy-first, self-hosted, full data ownership. Shared AI persona (Trace) and visual design language.

Support

If LiftTrace has been useful and you'd like to support development, the Ko-fi link above is the easiest way. Sponsorship doesn't unlock any features (everything stays AGPL and free), but it helps keep the project sustainable. Just as helpful: open an issue with a bug report, share the project, or contribute a translation.

Disclaimer

LiftTrace is not medical, health, or fitness-professional software. It does not provide medical advice, diagnosis, treatment, or personalized training prescriptions. Exercise library content, Trace AI coaching, program templates, rest-timer guidance, and any analytical output (volume, PRs, frequency, body-weight trends) are for informational and self-tracking purposes only.

Resistance training carries inherent risk of injury. Exercise selection, load, technique, and progression can interact with medical conditions (heart and cardiovascular conditions, high blood pressure, prior surgery, hernias, joint or spinal issues, osteoporosis, pregnancy, connective-tissue disorders, recent injury or rehabilitation status) in ways this app cannot assess. Consult a qualified healthcare professional, certified strength coach, or licensed physical therapist before starting a new training program, returning from injury, or making significant changes to your routine.

Trace AI answers can be incorrect or incomplete; treat them as a starting point, not a substitute for human judgment or professional advice. Exercise library data is sourced from public databases (wger, Free Exercise DB, optionally ExerciseDB via RapidAPI) and may contain inaccuracies. Use at your own risk.

When you enable the optional ExerciseDB source in Settings, you bring your own RapidAPI key and consume your own quota. LiftTrace is not affiliated with RapidAPI or ExerciseDB and is not the API consumer; your use of that integration is governed by RapidAPI's and the API provider's terms.

License

AGPL-3.0 — see LICENSE for details. By contributing you agree your contributions are licensed under the same.