Open-source gym & body-weight tracker, now in the App Store (iPhone + Apple Watch) and as an Android APK. Plan routines, log workouts, see which muscles are trained, import from Strong/Hevy/FitNotes. Self-host it or use it on the phone alone.
Changelog
Newest first. Each release is a ## vX.Y.Z (YYYY-MM-DD) section, and the release notes on
GitHub and GitLab are that section, word for word. New work goes under ## Unreleased until the
tag. Write it for the people using the app: what changed for them, short, no em dashes.
v1.4.3 (2026-10-26)
The community release. Most of what's below was asked for on GitHub and Discord or sent in as a pull request, the Apple Watch learned a whole bag of tricks, and openGym starts again on iPhones that 1.4.2 left staring at the logo. Sorry about that one.
openGym starts again on iOS 15.5 to 16.3 (P1). 1.4.2 and the web demo sat on the splash forever there, because one tiny link check used regex syntax Safari only learned in 16.4. Rewritten, the build now targets Safari 15 like the app does, and a test reads every built file for syntax older iPhones can't handle. Should a browser still choke, openGym says so on screen with the error and a Reload button instead of lifting the logo forever. Thanks h097327 for the excellent report. Once it starts, iOS 15.5 to 16.1 also gets its missing tints back (the Coach's header and error bubbles, the admin pills, the focus card's badges, the tinted buttons, the body map's shades): plain stand-ins close enough that you'd need a colour picker to tell, and a test makes sure every new tint brings one.
Gym reminder (#614, phone app). Walk into your gym and openGym nudges you to hit Start. Add your gyms in Settings → Reminders → Gym reminder: "I'm at the gym right now" or a pin on an OpenStreetMap map, each with its own radius and text. Once a day at most, never after you trained, never mid-workout, optionally only between certain hours. Off by default, and your gyms stay on the phone (not on your server, not in backups). Android uses the system's own proximity alerts, so no Google services are needed. Android can be slow to notice you arrived (up to half an hour), so near a gym the phone can take a short GPS look and nudge you at the door; that needs openGym's battery use on Unrestricted (Settings shows it as "Quick arrival check"). And if you logged a workout on your laptop that your phone hasn't synced yet, the phone asks your server first (3 seconds at most) instead of nagging you anyway.
See what a session hits before you start it. Every routine on the Plan page (the week, the rotation and the routine list) and today's session on Home carry a tiny body, front and back, with the muscles it works lit up. No more opening Leg Day to remember it is, in fact, legs. It keeps going once you start: the exercise chips at the top of a workout end in the same tiny body, faint where the session is headed and lit where you've already ticked sets, in every layout and without moving a single set row (#670). Tap it for the big map and done/planned sets per muscle. Settings → Workout → Fine-tuning turns it off.
Export as a spreadsheet (#647). Settings → Data & backup → Export as spreadsheet (CSV): your workouts with one row per set (date, workout, exercise, set, weight, reps, RPE or RIR, warm-ups, drops, supersets, cardio distance and time) and, as a second file, body weight and measurements. Pick everything or a stretch of days. Opens in Excel or Sheets, makes your coach happy, and openGym reads it straight back in without losing a set. The importer also learned GymMane's CSV.
Keep what you added (#592). Threw an extra exercise into a routine's workout? The finish summary lists it under "New in this workout" with one button to add it to the routine, sets, reps and weight as you did them. Ignore it and the routine stays exactly as it was.
Halloween. Until the end of October a small spider drops in whenever you open openGym (tap it and it runs), bats cross the header now and then, cobwebs gather in a few corners and a shy pumpkin hides somewhere on Home. Find it for a little surprise, once a day. Stats gets a skeleton hanging off the activity card, spiders on threads, a moon with a tiny witch and two pumpkins peeking out. Rarely, a bigger witch. Workouts get a quiet version that never sits on a set, a button or a timer: a cobweb and a spider in the header's corner, two bats along the rest bar and pumpkins on the finish screen (Also during workouts turns that off). Gone on 1 November by itself, and Settings → Look & Home → Seasonal themes has Auto, On (all year, we won't judge) and Off, plus Spooky colors for a pumpkin orange accent. Reduce motion gets a still version, and with the theme off nothing of it is even loaded.
Pick your own app icon (iPhone). Settings → Look & Home → App icon swaps the icon on your home screen: the original, Light, Mono, one in green, blue, orange, pink or purple, or Halloween, a pumpkin orange dumbbell with jack-o'-lantern faces under a moon, with a spider in the corner. The Halloween one stays all year, and while the theme is on, Seasonal themes has a shortcut to it. It's per phone and iOS asks you to confirm. Android gets the picker in the next version.
In the workout
- Machine taken? One tap to your backup (#649). A routine exercise with planned backups lists each one in its ⋯ menu during a workout. Tap it and the backup takes over with the slot's own sets, reps, rest and warm-ups, and the exercise it replaced becomes its backup, so going back when the bench frees up is one tap too. Your routine stays exactly as it was.
- Machines with odd weight steps (#688). A machine or cable exercise has a Weight stack under Plate loading: type in the weights its pin really picks (5, 11.3, 18.1, the LifeFitness special) or fill an even stack and fix the odd ones. Progression, deloads, warm-ups, drops and the + and − buttons then land only on those, and at the top of the stack it holds and says so.
- Volume while you lift. The progress bar at the top of a workout ends in the session's volume, adding up every set you tick, in all four layouts. Handy for deciding whether today was enough or you've got one more in you (#774).
- "No timer" for a single exercise. Rest for this exercise has the same three choices as the warm-ups: your default, No timer, or a time of its own. Stretches and carries can finally skip the countdown while your squats keep theirs. Saved in routines, shared plans and backups.
- Rest after this set: tap a set's number and give just that set its own rest for today, a long one before the top set or none after a light one (#609, thanks @Space-Hermes).
- The rest wheel starts where your rest is. Pick a time opens on the rest that applies right now (the exercise's, the warm-ups', or your default) instead of sitting at 0:00 (#735, thanks @lodepav).
- A timed per-side hold can drop its 10 second switch-sides pause without losing the set's rest (Rest between sides → No timer), and changing an exercise's settings mid-set no longer forgets a side you already ticked (#636, thanks @Space-Hermes).
- Rate your cardio (Discord). A cardio set's menu (tap the set number) has How hard it felt, in RPE whatever your sets use, worded for a run instead of reps left. An easy walk then loads your fatigue map less than a hard run; unrated cardio counts as it always did.
- Exercises start the way you do them. A plank, a wall sit or a dead hang starts as a timed hold (#694, thanks @lodepav), a one-arm row or a single-leg press per side (#736, thanks @lodepav). Jumping jacks, burpees, star jumps and tuck jumps start as sets × reps instead of minutes and speed (#717, thanks @zykll18), and so does jump rope, double unders included (#796, thanks @sc962). Only fresh picks: what's already in your routines and history stays as it is. Those cardio moves can also be switched between Cardio, Reps and Time in their settings (#678).
- "No automatic progression" remembers what you did (#217, thanks @iggaM23). With Settings → Workout → Fine-tuning → Planned sessions start from → Your last session, an exercise with progression off opens at last time's weight and reps, the way Strong does it, and the card says so. "Your plan" (the default) still opens at the routine's own numbers, and deload routines keep theirs.
- "Last time" can mean any workout (#770). Bench on Monday and Thursday? Settings → Workout → Fine-tuning → Last time means → Any workout lets Thursday start from Monday, for the rows, the "last time" line and progression alike. The default stays per routine, so a heavy day and a light day keep their own numbers.
- Count warm-ups in volume, if you like (#719). A switch in Settings → Units & language adds your done warm-ups to every volume the app shows: the workout, the summary, history, Stats, the report and the Coach. Off by default, and records ignore warm-ups either way.
- Discard workout is harder to hit by accident. It lived at the bottom of the workout's ⋯ menu as a red trash, exactly where an exercise's ⋯ keeps Remove exercise. Now it's only in the Finish sheet, next to Finish and save, still with its "are you sure" (#751).
- Rest days in the rotation, and the same routine more than once (A → B → C → B → D): Add offers a rest day and every routine, including the ones already in the loop (#536).
- A treadmill's incline can be set in the routine, not only mid-workout. The session opens at it unless last time had a grade of its own, and it travels in shared plans.
- Focus mode: the exercise's ⋯ menu has Add set and Add warm-up set, and Focus stays on the screen with lots of sets or a long exercise name (#655).
- In the Compact and List layouts the exercise chips at the top follow along: the one you tap lights up, and so does the one you scroll to (#323, thanks @Space-Hermes).
- Collapse completed exercises: a finished exercise folds up and the ones after it move up with it, no more black gap, the last one in the list included (#642, thanks @dpatrongomez).
- Add exercise → By muscle has the Favourites chip too, for the muscle you picked (#669).
Apple Watch and the Lock Screen
- Next exercise and Skip rest on the Lock Screen (iPhone, Discord). The Live Activity and the Dynamic Island get a small button next to the big one: Skip rest while you rest, Next exercise the rest of the time, so a machine somebody grabbed no longer means unlocking the phone. Works with openGym asleep. The big button now says Log set, because "Done" sounded a lot like "I'm going home".
- RPE and RIR on the watch. If you rate your sets, the set page has a little effort disc next to Done. Tap it, turn the crown, and it goes in with the weight and reps. Leave it alone and nothing is logged.
- A 3-2-1 before a watch workout (#789, thanks @cubetes) while the heart-rate sensor warms up, so set 1 has a heart rate too. Tap to skip the wait.
- Forgot to hit Finish? (#790, thanks @cubetes). After 20 minutes without a set the watch taps you and asks "All done?". No answer by 45 minutes and the workout ends on its own, at your last set, so Apple Health doesn't count your drive home as a workout.
- Discard, properly (#776, #783, thanks @cubetes). Finish workout? on the wrist offers Discard workout, and discarding on the phone while the watch follows no longer saves it to Apple Health anyway. Gone on both, nothing in Apple Health.
- No more ghost sets in supersets (#791, thanks @cubetes). When the watch flips to the partner exercise by itself, taps are ignored for a second, so a slow double tap on Done no longer logs a set you never did.
- Lock the watch mid-workout (Water Lock, like Apple's Workout), so a sleeve or a bent wrist can't press the crown out of your workout. Turn the crown to unlock.
- Bigger numbers and a calmer crown. Weight and reps are larger, Done is easier to spot, the page dims properly with the wrist down, and the weigh-in crown turns whole kilos (or pounds): tap the digit after the point for the tenth.
- The watch keeps up. It could miss the phone right after launch, a fresh install could wait for your next change before it got your routines, and one odd routine could hide all of them. All fixed. Until the phone has sent anything the watch says "Not synced yet" and what to do, and Settings → Apple Watch on the phone tells you when it last heard from the watch.
- A set ticked on the phone while the watch runs the session gets its heart rate from the watch too.
- Exercise names on the Lock Screen, in the Dynamic Island, on the watch and in the widgets are title-cased like in the app, instead of whispering "barbell bench press".
- After a long run of Lock Screen taps with the app asleep, the Live Activity said "All sets done" with sets still to go. It now says "Open openGym for the next set".
- One "Rest's over" on iOS: the end of a rest could leave two identical banners stacked (#728, thanks @2baek2).
Apple Health and Health Connect
- Your watch's heart rate and other apps' weigh-ins come in (#544, #127). Two new switches next to Write to Apple Health / Health Connect: Heart rate from your watch fills in the heart rate of every set from workouts of the last day, whatever watch recorded it, and Weigh-ins from other apps brings in your scale's weigh-ins from the last 30 days. Both off until you turn them on, read only while openGym is open, and they never overwrite a heart rate the Apple Watch already logged or a weigh-in you typed.
- A year of weigh-ins from Health Connect (Android, idea from #801, thanks @antoni-heredia). Turning on Weigh-ins from other apps also asks for Health Connect's history permission where your phone has it, so the last year comes in. Say no and it reads the 30 days as before.
- A run is a run (#799, thanks @svillar). A workout that was only running used to land as strength training. Now runs, walks, rows, rides, jump rope, HIIT, yoga and stretching each get their own type, on the iPhone, the Apple Watch and in Health Connect. Lift anything at all and it's strength training, as before.
- Imported weigh-ins stay put. Weigh-ins you import (an Apple Health export, a Google Health or Health Connect CSV, Strong, Hevy) are no longer written back to Apple Health or Health Connect, where they landed a second time. Only weigh-ins you enter in openGym go out.
Your body and your stats
- Lifts against your body weight (#729, thanks @radu781). Exercise progress in Stats and an exercise's History have a Bodyweight view: your estimated 1RM or heaviest set as a % of what you weighed then, so the line only climbs when you got stronger for your size. Pull-ups and dips count you plus the belt, assisted machines you minus the help.
- Your weekly rate, with a corridor (#759). Under the body-weight chart on Home and in Stats: the trend through the last three weeks of weigh-ins, in kg or lb and in % of body weight a week, so one salty dinner can't fool it. Tap it to set what you aim for and the card tells you whether you're on pace, too fast or too slow.
- Fatigue, in numbers. Tap a muscle on Stats → Fatigue for its fatigue in percent on a little Ready / Recovering / Fatigued bar, plus when it drops back to Recovering and to Ready if you leave it alone (thanks @sg41).
- Custom measurements get their own unit (#699, #718, thanks @zykll18): %, kg or lb, cm or in, or none at all for a visceral fat score. The body CSV export names each field's unit, and importing that file brings the measurements back too, not just the weigh-ins.
- Lifted in total. A new Stats tile with everything you've ever lifted, imports included. Spoiler: it's a lot.
- Deleted a weigh-in by mistake? Undo, on the log sheet and in All weigh-ins (#756).
- Muscle balance: tap a muscle you haven't trained right on the map and its row offers the exercises for it (#553). Stats' Week rows lose a stray line over each done/planned figure.
- Chart dates say each day once over a short span, and months get their year once a chart covers more than twelve of them (thanks @lodepav). A weight change too small to show reads 0, not "-0".
The Coach
- It answers questions. "How many sets of dips is that?" in the chat gets an answer in words instead of a whole revised plan (#660, thanks @TheBlackSide243).
- It remembers both devices (#779, thanks @Klein225). With the Coach open on two devices the one that synced last could wipe the other's chat, log and Undo. Now they merge message by message, and a plan applied on your phone no longer gets "nothing I would change" on your laptop.
- A Coach plan goes into your rotation (#778, thanks @Klein225) instead of the weekly schedule a rotation ignores. The rotation starts over with the Coach's routines, and Undo puts yours back.
- Automatic reviews on a phone with its own key finally happen, while the app is open: right after the workout that completes the count, or the first time you open it after your weekly slot. And a phone connected to your server now hears about a suggestion the server's review left.
- One tap away for admins (#683, thanks TheBlackSide243): an AI Coach row in Settings opens the admin dashboard straight at the Coach card.
- Gemini works with a fresh AI Studio key again: the default is Gemini 3.8 Flash, and a model your key can't use any more is swapped once for one it lists. If nothing fits, the error names the model (#758).
- OpenRouter and other hosts that insist on strict JSON schemas stop failing with "additionalProperties must be explicitly set to false" (#701, thanks @choksi2212; #577, thanks @funkypenguin).
- A phone with your own key gets Advanced: the daily runs (0 for no limit, handy with a model on your own network), the output-token ceiling a reasoning model needs raised, and the message length (#527, thanks @xueyang-dev).
- Cardio the Coach prescribes on a non-cardio exercise (kettlebell swings for 15 minutes) stays 15 minutes (#640), and a review that adds a routine with an empty slot gets a second try instead of failing (thanks @rudycelekli for both).
- The questionnaire's weekdays follow the number of training days, and days you picked yourself stay put (#620, thanks @Jul11us).
Exercises and equipment
- Call an exercise what you call it (#624, thanks Space-Hermes). "Add another name" gives it other names, like OHP for the overhead press, and the search finds it by those too. They sync and travel with your own exercises in shared plans.
- "I own no dumbbells" (Discord). Settings → Equipment → Dumbbells has a switch for it, since an empty list only ever meant "any weight". On, dumbbell lifts leave the library, the picker and the Coach's plans, even if the Coach was once told you have some. Your list waits for the day you buy a pair.
- Equipment profiles know more: an inverted row needs a bar (unless it's the under-the-table kind), a dumbbell fly or a pullover needs a bench, and the massage ball is no longer a foam roller. Profiles you already had keep showing what they did.
- Your lats show up as "Lats & upper back" in Stats, on the body map and in the muscle picker (#607, thanks @Parth-Vasave). The kettlebell suitcase deadlift and the plate deadlift lunge press remember your lower back (#693, #700, thanks @JeromeTDev and @choksi2212), and the knee-to-chest push-up moved from cardio to chest.
- German step-by-step instructions for 1,213 more exercises, so everything from before v1.4 explains itself in German (#645, thanks @junkerderprovinz), and the lever leg curls say Beinbeugen, not Beinstrecken (#631, thanks @AkashBhat14 and @choksi2212).
Getting around
- Back means back. A page's own back button returns you where you were scrolled, like the edge swipe, Body measurements goes back to Stats, and the titles all sit the same distance from their back buttons (#704, #763, #764, thanks @kurktchiev and @lajawi).
- Android back stops touring your tabs. On a tab, Back goes straight to "press again to exit" (#705, thanks @chang0022).
- Settings slides like Settings: in from the right, back from the left. The tabs keep their fade.
- iPhone first start: the permission screens have one Continue that leads straight to the iPhone's own question, so the yes or no is yours to give there, once.
- Faster on long histories. Home and Stats do far less work per open (Stats about a third less on 800 workouts), the main script is a quarter smaller, the installed web app stops asking the server about every file on each launch, and other languages load their words in one go.
- Increase Contrast and Reduce Transparency are honoured (#707, #708, thanks @olestrr): firmer colours and hairlines (every button label at 4.5:1 or better), and solid bars instead of frosted.
- "Where's my code?" (#551, thanks @Maximrabd). Signing a computer in with a code from your phone needs the phone connected to your server. A phone app that keeps everything to itself now says so under Settings → Account and on the sign-in screen.
- Support openGym. Settings → About & updates has the coffee jar: Buy Me a Coffee, Ko-fi and GitHub Sponsors, and on the iPhone a straight line to writing an App Store review. No pop-ups asking for anything, promise.
- The install tip in About on a Windows or Linux browser points at Chrome's install icon, not at an iPhone's Share menu you don't have. Admin → AI Coach: the Remove button for the stored key is red, like every other button that deletes something for good.
Languages
- Hej, Sverige! openGym speaks Swedish, from Settings → Units & language or straight from a Swedish phone (#721, thanks @Grizzly163). Exercise names and instructions stay English for now.
- Spanish that sounds like Spain (#786, thanks @cubetes): over 60 strings reworded, Objetivo instead of Meta, Entrenador instead of Coach, and holds that no longer say "sostén".
- Arabic exercise names keep their English brackets the right way round when they wrap (#780, thanks @kurktchiev).
- The plate hint says plates, not reps, in Chinese and Korean (#689, #698, thanks @xueyang-dev), and the Korean exercise names got a native speaker's review (#500, thanks @ianlyoo).
Import and the MCP server
- Log a workout by telling your AI about it (#739, thanks @matthewjablack). The MCP server gets
log_workout: "curls, 12 kg, 12/12/10" lands in your history on every device, saved through your own server like a paired phone. It asks back when a name could mean two exercises, never logs the same thing twice, and takes 20 workouts an hour at most. - MCP:
sets_plannedcounts per-side sets likesets_done(102/102, not 102/54; #691, thanks @davidjorgensen), and a profile whose data was deleted stops showing, also where the system can't watch files (thanks @rudycelekli). - Hevy import: 55 built-in exercises (Seated Leg Curl, Plank, Air Bike, Triceps Dip and friends) land on the right openGym exercise, 12 more titles find theirs (from Lu Raises to the Bayesian curl), and Side Plank, Squat (Machine) and the cable rear delt fly stay themselves with your Hevy API key too. The summary counts an exercise once (thanks @lodepav, and #784, #785, #793, thanks @cubetes and @theatosam).
- Imports keep converted weights to the hundredth (45 lb comes in as 20.41 kg and reads back as 45), Hevy notes keep their line breaks (thanks @lodepav), and Strong's measurements export comes in as body weight (#591, thanks @ConalMullan).
Android
- The update actually installs. Switch apps while the new APK comes down and Android quietly refused to open the installer. Now the installer waits until you're back in openGym, a second tap after a hiccup reuses the APK it already has instead of fetching 300 MB twice, and the leftover is cleaned up once you're on the new version. (The fix lives in the updater itself, so it helps from the update after 1.4.3 on: for this one, keep openGym open while it downloads.)
- Which APK is this? Settings → About tells you whether you have Standard (180 px), Plus (240 px) or HD (360 px), no guessing from the file size.
From the community (thanks!)
- A superset in List and Compact scrolls to its next member, one-sided exercises included (#574, @sgoendoer).
- The workout summary uses the width of the phone and has a close button at the top (#597, @dpatrongomez).
- Pairing the app with a server under a sub-path such as
/gymkeeps the sub-path (#601, @phaninderg). - One builder for an exercise added to or swapped into a running session (#608, @bbolinger).
- Tailscale Serve as an HTTPS option in the self-hosting docs (#615, @tanishvbuk).
- German exercise names and steps (#619, #623, @junkerderprovinz).
- Tests that pass east of UTC+6 (#732, @NaufalDzz).
Self-hosting
- Wrong address, clear answer. When your api service's ORIGIN isn't the address in your browser,
the app says which address the server expects and what to change, instead of a bare "cross-origin
request refused". The server log names the exact
ORIGIN=andRP_ID=to set (thanks tcmac, who lost a morning to this one). - Set your own
CONTENT_SECURITY_POLICY? The inline start script changed (it now shows an error instead of an endless splash), so its hash did too. If you copied the old hash, take the new one fromweb/Dockerfile; with the old one the app still runs, but loses that message and the first-paint right-to-left layout. - New docs for what Discord asked: from zero to a working AI Coach (it starts with making yourself
admin), nginx under
/gymin both flavours with the three mistakes that break it, passkeys without a fingerprint reader or on plain http, the iPhone web app, and moving your phone's data onto your own server. A NAS section (Synology, QNAP, Unraid, TrueNAS, with a two-service compose to paste), password sign-in (PASSWORD_LOGIN) and guest mode (ALLOW_GUEST) explained, including why a stack without its api quietly turns you into a guest, and a Mac at home with Colima and Tailscale Serve (#787, thanks @cubetes).
Security. Follow-ups to v1.4.2's audit. Self-hosters: please update.
- Pairing the phone app asks you to confirm it's you (passkey, or your password where that counts), like adding another device does. A copied browser session can no longer mint a phone sign-in that renews itself.
- On iPhone the paired server's sign-in is no longer part of iCloud or computer backups. A restored iPhone pairs again.
- The Android updater (direct APK only) installs nothing without its checksum and only its own download, and the backup folder is only written to while the app still has your permission.
- Self-hosted images run on this month's patched Node (22.23.4) and nginx (1.30.6), and the server
and the MCP bridge pick up a fixed
ip-address. Thanks to MohamedAfrash and lodepav (#766, #769).
v1.4.2 (2026-10-23)
openGym comes to the App Store, with an Apple Watch app in tow. Plus everything you asked for since v1.4.1, five reported security holes closed and a fresh look at the animations.
openGym on the iPhone. The App Store app is the same openGym: use it on the phone alone, or connect it to your own server. Your data stays where it is (no account with us, nothing collected). Get it on the App Store: https://apps.apple.com/app/id6822275400
- Apple Watch. Start a workout on the wrist, or on the phone and the watch app opens with it, then tick off sets with a big Done button and the Digital Crown for reps and weight. Rest is a full-screen countdown with +15 s and Skip, holds count down, sides say Left or Right, supersets go in turns. Heart rate per set, a summary at the end, a Smart Stack widget and complications for your watch face. It speaks the app's language, asks for a weigh-in at the start if you like, makes weights quick to change, and you pick what the set screen shows. No phone in reach? Your ticks wait on the watch and catch up later.
- Widgets and a Live Activity. Today's workout on the Home Screen and the Lock Screen, your streak too. A running workout sits on the Lock Screen and in the Dynamic Island, with a Done button that logs the set and starts the rest without opening the app.
- Apple Health. Finished workouts and weigh-ins go to Apple Health, the same switch Android has for Health Connect, offered once at the start. Delete a workout in openGym (on any of your devices) and it leaves Apple Health too.
- Sharper animations, your choice. Settings → Workout → Animation quality: Still only, built in (180 px), or 240, 360, 480, 720 and 1080 px, downloaded from the App Store when you pick them. Auto takes 360 on a phone and 720 on an iPad, over Wi-Fi. Female and male figures download separately, so you only get the one you use.
- No more boxes. The animations in the app showed faint rectangles around the moving parts. They are re-made from the original files, frame by frame, and look like the originals now. The APKs get the same fix (180, 240 or 360 px built in, see Android below).
- Swipe from the left edge to go back, with the page you came from sliding in underneath.
- Notifications are asked for at the start, not in the middle of your first rest.
- The Vibrate switch works on the iPhone, and a server or Coach on your home network works over plain http, like on Android (#428).
- A logo instead of a black screen while the app starts, loading its plates.
Android. The app now targets Android 16 and needs Android 7.0 or newer (6.0 is out). The APK
you know stays and updates itself, now in three sizes: Standard (openGym-1.4.2.apk,
animations built in at 180 px, the small one), Plus (openGym-Plus-1.4.2.apk, 240 px) and
HD (openGym-HD-1.4.2.apk, 360 px, sharp and hungry). Each one updates to its own kind, so
nobody gets a surprise download twice the size. Phones on v1.4.1 update to Standard; want Plus or
HD? Install it on top, your data stays (same goes for going back). A Google Play version is ready for the store too: it updates through Play and gets
the sharper animations as Play downloads, like the iPhone, and an APK phone can move to it later
without losing anything.
Your account, your call.
- Delete your account from Settings → Account. It offers your backup first, asks you to type your name, and then a passkey or password (on the phone: Face ID, Touch ID or the passcode). The server's last admin hears straight away why they can't, instead of after all that.
- The Coach asks before anything leaves. The first time the Coach would send your training to an AI service, it says which one and what goes there. You can take it back in the Coach menu. A model on your home network doesn't ask; it's yours.
- Sign in on a computer from the phone app (#551): Settings → Account → Add another device makes the same one-time code a browser does.
Reminders that know you trained. Logged a workout on another device? Before the missed-day nudge goes out, the phone checks with your server and keeps quiet. (On the iPhone, iOS decides when the app may check in the background; opening the app always catches up.)
Your data, safer
- A running workout is saved the moment it changes and again when the app goes to the background, so a crash or a dead battery costs you nothing.
- Taps from the watch or the Lock Screen wait until your saved data is loaded, and offline changes count as sent only once they're safely on disk. Saving swaps the file in one go, never half.
- Importing a backup without an account now offers "Merge them in" instead of wiping what's there.
In the workout
- Backups for an exercise (Discord): in the routine editor, up to five exercises to do instead when the machine is taken. A swap lists them first.
- Rest between warm-ups (Discord): Settings → Workout sets it for every exercise (no timer, or a time of its own). One exercise can still do its own thing, and get a rest between sides.
- Your bars (Discord): Settings → Equipment sets your bar weight once per bar type, say the 15 kg women's Olympic bar, and every exercise on it loads plates from that. The plate editor gets quick picks (20/15/10/7.5 kg, 45/35/25/15 lb).
- Skip finished exercises in Cards and Focus, a new switch next to Collapse completed (#523).
- Timed exercises move on by themselves: when the last rest after a plank runs out, the next exercise comes up (#532).
- Per-side sets can be warm-ups and back again (#575).
- Bodyweight exercises stop asking for a weight step (#583).
- Change plates of 2, 1.5 and 1 kg, and 1 and 0.5 lb, for gyms that stock them (#510).
Small things
- Progress photos for any day, several at once, each on the day it was taken (#557), and a photo can be removed from the gallery, with Undo (#558).
- Muscle balance: tap an untrained muscle to see its exercises (#553), and the Week view lines up. The status bar no longer covers the page on more Android phones (#573).
- The Coach's questionnaire has a clearer days screen and the same time wheels for session length.
- The Coach's message box grows with your text and opens into a tall editor for long ones. A reload on the intake no longer sends you home, and dates follow your day, not UTC's.
- The Undo after a delete has an × to send it away, on the far side from Undo.
- Day notes (sick, travelling...) show icon and word on one line.
- The swipe hint no longer swallows a quick tap on the first set (found by the new iPhone tests).
- The pairing code field no longer hides behind the keyboard on iPhone.
From the community (thanks!)
- Body weight for an earlier day, like measurements (#570, @smist37).
- Warm-ups on assisted machines ramp down from more help (#581, @lntvan166).
- Effort stats average the whole training, and your logged RIR tunes the anchor (#539, @sg41).
- 15 rowing exercises stop counting as chest and triceps (#503, @sg41).
- German exercise texts (#578, @ThatsMeGIT).
- A shared plan keeps a superset's name and rest (#564, @pawell67).
- Push reminders show the routine's emoji (#548, @mzspicoli).
- The swap icon shows on picker rows (#579, @Totopo27).
.env.example: CF_CONNECTING_IP quoted so Compose keeps it (#565, @APN-Carmine).- Skip finished exercises, the change plates and the untrained-muscle shortcut were first sent as pull requests by @anshuman83-40 (#526, #530) and @tfdmendes (#543). The CLA wasn't signed yet, so we built our own take for this release, but the ideas are theirs. Thank you!
Security. Five private reports, all fixed, plus our own audit. Thanks to Boris Kurktchiev for the reports, each with a patch and a test. Self-hosters: please update.
- A crafted link could send your sign-in to another server (GHSA-375x-wfvj-jf7q). A link to your own instance with an odd path made the app talk to a host named in that path. It can't leave your instance any more.
- Another site could sign you into its account (GHSA-48ff-v63h-99xr). The passkey sign-in routes now check where a request comes from like every other route, and the API only takes JSON.
- Push notifications could be taken over by someone who knew your device's push address (GHSA-568g-hg5j-h53q). The address now only moves to another account with its own keys.
- The Coach's sandbox check was skipped on the admin's test button, the status card and jobs queued before a provider switch (GHSA-w724-p4hx-jfv9).
- One profile could slow the server down for everyone with a huge queue (GHSA-69j8-85pp-mf8j), or with many accounts and large saved states. The reminder check now reads a state only when a reminder could actually go out.
- Rest timers and test pushes are limited per account, disabled accounts get no reminders and no Coach reviews, and signing up with someone's e-mail as the name counts against your address like the e-mail field does.
- A browser's sign-in cookie can no longer be turned into a phone token that renews forever.
- Deleting your account from a paired phone only skips the passkey for a real phone sign-in, not for a browser session sent along as one.
- Push addresses that hide a private IPv4 address inside an IPv6 one are refused like the plain ones.
- The Coach forgets a stored API key when its server address moves to another host. Enter it again.
- Request paths the server would have to tidy up (
.., backslashes) are refused, nginx stops naming its version, and Android backups no longer include the paired server's sign-in. - One owner, many admins. Any admin could delete every other admin and then clear the activity log. Now one admin is the owner: only they make or remove admins, delete an admin, clear the log or hand the role on (Admin, tap a user). Existing instances: the oldest admin is the owner.
- The web container sends a real Content-Security-Policy. Scripts only run from your own
instance, so an injected one does nothing. If your proxy adds analytics, see
CONTENT_SECURITY_POLICYin docs/SELF_HOSTING.md.
v1.4.1 (2026-10-10)
Bug fixes for v1.4.0, mostly the things you told us about on Discord and GitHub.
- Smooth animations in the app. They lagged and stuttered on real phones (the phone's video player stalled at every loop). The app now shows them as animated images, the way the old GIFs worked, with the original timing. The web and self-hosted servers keep their clips.
- The update check finds new versions again. It asked the GitLab mirror, which never got v1.4.0. It asks GitHub now, and the 300 MB download goes straight to storage instead of into memory, checked against its checksum before the installer opens.
- The rest bell rings over music. With the app open, the end tone now plays like the screen-off alarm does: your music turns down for a moment instead of drowning it.
- The Coach has its own button on the Plan page, no more hunting in the share menu.
- Search: the exercises you have done come right after your favourites, and "leg press" finds the plain 45° leg press first.
- Add exercise gets the Type row the library has (#521).
- Exercise progress gets 1M / 3M / 1Y / All, like the body weight chart (#511).
- Imports: two workouts on the same day stay two (#505).
- Coach: an OpenAI-compatible server without /v1 in its address works, e.g. Open WebUI (#508).
v1.4.0 (2026-10-09)
The biggest update openGym has had: a new exercise database with 5,632 exercises and new animations, everything that was planned for v1.3.11 and v1.3.12, and the features you asked for most. Forty-seven community pull requests from twenty contributors. Web bundle, APK and API image.
Nothing you logged changes. Every exercise that ever shipped keeps its id, name and muscles, so workouts, routines, records and backups stay exactly as they are. A phone still on v1.3.x keeps working with a v1.4.0 server, and shows the new exercises it doesn't know yet without losing them.
The new exercise database
- 5,632 exercises instead of 1,324: bands and kettlebells, suspension trainers and landmines, machines of every kind, plus stretching, mobility, yoga and pilates. Each one with a short description, steps, body part, equipment and muscles, and its name in every app language (German names for the new exercises are machine-made and waiting for a review).
- New animations, licensed from Gym visual: sharp 360 px loops inside the app, 180 px on the web and on your own server, and a still for every exercise.
- Male or female drawings: about 940 exercises are drawn on both figures. Settings, Look, "Exercise drawings" picks which one you see. Only the picture changes, never your data.
- A type filter in the library: strength, calisthenics, olympic, stretching, mobility, yoga and more.
- Search rebuilt (#192): best matches first, typos forgiven ("sqat", "dumbel curl"), gym shorthand understood ("db", "rdl", "ohp"), plurals too ("pull ups"), and "Similar exercises" under the results, so a search almost never ends on nothing.
- Swap suggests the same muscle first (#473), same equipment at the top.
- The catalogue lives in the repository, one file per exercise, open to fixes and translations
by pull request (
catalogue/README.md). "Suggest a fix for this exercise" in the app opens an issue for that one exercise.
Training
- Sets to failure: mark any set as taken to failure from its set menu and it gets a little purple "F". It counts as RIR 0 in your effort stats and the fatigue map (unless you rated it yourself) and stays a normal work set for volume and records. "Last set to failure" in an exercise's settings plans the final set as an all-out one.
- Triple progression (#179): reps climb to the top of the range, then a set is added, up to the most sets you allow; when every set sits at the top, the weight goes up and you start over.
- Back-off sets (dennismstfc, #475): every set one step lighter than the one before.
- Per dumbbell or both together (#474): say what a dumbbell weight means, and volume and records count it right. Your old entries stay as you typed them.
- Your dumbbell rack (#376): list the dumbbells you own, and progression, deloads, warm-ups and the + and − buttons only land on those.
- Treadmill incline: an incline in % next to speed on walking, running and stair machines.
- A fairer fatigue map (sg41, #436): counted in hard sets with its own recovery time per muscle, so a split no longer looks fatigued forever.
- Pyramid sets with a weight per set (akram1089, #446, #445), 1RM from seven formulas with your pick of one (giulioleuci, #195, #155), per-set progress lines (iamtechnoana, #450, #145).
During a workout
- Exercise chips (#323): a numbered dot per exercise at the top, filled as you go. Tap one to jump there.
- Collapse completed exercises (helgehelge123, #241; Discord): in the list view a finished exercise folds into one line the moment you tick its last set, and a tap opens it again. Turn it on for good in Settings, Workout.
- Focus view (giulioleuci, #222): one exercise at a time, nothing else on screen.
- Pick your rest-end sound (#306): chime, classic, bell, beep-beep, whistle or soft, with a preview, on Android with the screen off too.
- Superset names and their own rest after each round.
After a workout and around it
- Last time and next time on the finish screen (#324): up, same or down, and what's next.
- Share a workout as an image (anihothur, #455, #453).
- Export to Garmin (#447): any finished workout as a .fit file, sets included.
- Body measurements (robertgeica, #82): waist, arms, body fat and anything else, each with its own curve.
- A note for a missed day (#261): sick, travelling, injured or your own words. The missed-day reminder leaves that day alone.
- Health Connect on Android (DrDamnation, #371, #200): finished workouts and weigh-ins go to Health Connect.
Equipment and languages
- Bench and pull-up bar as equipment (pawell67, #464), starter plans fitted to your equipment (#469), clubbell and macebell (akram1089, #425).
- 🇧🇩 Bengali (mrjohndoel, #465), Polish exercise names and a full Polish review (pawell67, #467), French says tu and Russian says вы throughout (kurktchiev, #413, #414), plainer Turkish (iamtechnoana, #451).
Coach
- The Coach sticks to your equipment and never sneaks in a machine you don't have.
- A follow-up question in the chat no longer comes back as "something the app couldn't use" (#471).
- Extra headers and an adjustable output limit for OpenAI-compatible endpoints (janviernine, #386; danifuuu, #390), bases that carry their own version (iamtechnoana, #449, #437), consent and intake in your language (kurktchiev, #415).
The app and your server
- Cloudflare Access (EthanetXYZ, #439): pair with a server behind Zero Trust using a service token, which only ever goes to that one server.
- Plain
http://servers at home can be paired (#428); the "not connected" line is gone on a phone kept local and can be closed by a guest (anshuman83-40, #462, #454). - The web image runs without root (mvanhorn, #466). Kubernetes and Helm now use port 8080.
- Self-hosting got simpler: the exercise media ship inside the web image, nothing is downloaded
on first start. An old
mediaservice or folder is no longer used and can go. - Helm chart (aphisitworachorch, #418), Nix flake and NixOS module (gerrydoro, #452), push
to private addresses with
ALLOWED_PRIVATE_IPS(ViktorShapoval, #448).
Fixes
- In the Android app the exercise animations play by themselves (they sat on their first frame), and the rest-end tone plays with the screen off on phones that refused it before.
- Warm-ups: unilateral ones count (sgoendoer, #388), a barbell warm-up is never lighter than the bar (#409), editing one leaves the rest of the ramp alone (#442).
- Superset Move up/down stays inside the superset (#443), swipes land where they should (#457), zero added weight stays editable (ac1982, #461), Apple Health imports read each record's unit (ac1982, #432), plate targets stay loadable (ac1982, #433), big media exports stay importable (agammann, #430), the rest bar keeps its scale (aitordiaz, #423), a failed Sign out says what failed (#456), and a re-import from Strong or Hevy no longer splits one exercise into two.
- Many small fixes from kurktchiev (#401 to #410, #412).
Licence
The exercise stills and animations are © Aliaksandr Makatserchyk, Gym visual, licensed for use in openGym only and not covered by the AGPL. Details in NOTICE.md.
v1.3.10 (2026-10-07)
This one grew. The plan was a queue and a rotation; along the way the whole app got a calmer look, swipe actions arrived, you can pick any accent colour you like, and sync was taken apart and put back together so that no device can quietly lose your training again. Thirty-five community pull requests from twelve contributors, fifteen issues closed, and a long night of testing behind it. Web bundle, APK and API image.
Please update the app on every device that syncs (phone, browser tabs, the Android app). An older phone keeps working, but only a fully updated set of devices gets all of the new safety nets. Before you update, open each device once with internet so everything it owes the server has arrived.
A new design
- Settings on one screen, with search at the top, your account on a card, and everything else on sub-pages: Workout, Reminders, Units & language, Data & backup and friends. Nothing was taken away, it just has a home now. Type "rest", "swipe" or "vibrate" and you are there.
- Plan is two tabs, Schedule and Routines. One switch between a fixed week and a rotation, a menu for export, print, import and starter plans, and the weekly muscle volume moved to Stats.
- A workout screen that gets out of your way. The tab bar steps aside while you train, a labelled Finish, grouped ⋯ menus, a small thumbnail of the exercise, and the rest timer docked as one row at the bottom. Tap its clock to set the time left.
- A rest-time wheel, iPhone style, for anything from 0:00 to 15:00, in Settings, in the new in-workout settings sheet and per exercise. Done without scrolling leaves your rest alone.
- The in-workout settings sheet: rest timer, sound, vibrate, flash, screen awake, layout and effort without leaving the session.
- Finish opens a small sheet: finish and save, or discard. And any set's menu can turn it into a warm-up set on the spot (or back).
- One icon per idea. The shuffle icon used to mean twelve different things. Not any more.
- New profiles start with smaller exercise animations and "weigh in before workouts" off. Your existing profile keeps whatever you had.
Rotation and the session queue
- A rotation beside the fixed week (#158, #69; kurktchiev's #167 and giulioleuci's kurktchiev/openGym#1). A, B, C, A, ...: the next session is the next one you haven't done, whatever the weekday, so a missed Tuesday no longer shoves the plan around. Build the loop in Plan, reorder it, start a new pass whenever you like. Switching back to a fixed week asks first and leaves your weekdays as they were.
- Home shows what is next, how much of the pass is done, and when the next one starts. A coach app that writes your week through the API is marked "Externally managed".
- Planned vs completed weekly volume per muscle (EmilZapata, #333, #327), now on Stats, with each queue or rotation session counted once.
Swipe actions
- Swipe a set left to delete it, with Undo, or right to copy it. In cards, list and compact, mirrored in Arabic. The last set stays put ("Keep at least one set, champ"). A timed per-side hold slides its left and right rows together.
- Swipe in Plan: a routine left to delete (with Undo), right to duplicate; an exercise out of the routine editor or a routine out of the loop, with Undo too.
- One switch for all of it, "Swipe actions" (Settings → Workout → Fine-tuning, or the in-workout settings sheet), on by default.
Your own colour
- Any accent colour you like, from the rainbow swatch after the presets. openGym checks it against light and dark and nudges it until text on it stays readable. It syncs like the presets.
Safer sync, and no more lost data
This is the part we are proudest of, and the part you will hopefully never notice. Most of these could already happen in v1.3.9:
- Every change carries its own stamp, down to a single setting, plan day or routine field. Two devices editing the same routine now merge field by field instead of one copy winning whole.
- A phone whose clock runs late no longer loses its edits and deletions.
- A deletion stays deleted, even when another device changes something unrelated afterwards, and the order of your routines survives a conflict.
- Two tabs in one browser no longer overwrite each other or the running workout, and signing out or switching accounts with a second tab open leaves nothing behind.
- Signing out during a workout no longer deletes it, and signing in with a guest plan asks first. Anything that does not fit lands under Settings as kept changes, with "Save as a backup file", instead of disappearing.
- A server that falls back to an older copy (say, from a backup) is merged with, not trusted blindly. A full disk or a slow answer can no longer hand a device an old state.
- Importing a backup keeps the workout you are in the middle of, whether it replaces or merges.
- On the server: every write is flushed to disk before openGym says "saved", a copy of the last
good
db.jsonis kept asdb.json.bak, and the server starts from that copy if the main file is damaged. We killed it eighty times mid-write; every confirmed save was on disk.
Reminders and alerts
- The missed-workout nudge (opt-in): one push on the evening of a planned day you skipped, in the tone you pick: Friendly, Guilt trip or Drill sergeant. It backs off after three missed days in a row and never bothers you on a rest day.
- Vibrate on silent too (noname-nan, #375), Android: the end of a rest or a hold buzzes like an alarm even when the phone is on silent. Off by default.
- The rest alarm on Android rings even when the notification permission dialog is still open, and a killed app brings its rest bar and countdown back.
- "Rest over" rings only the device that rested (kurktchiev, #348).
- Classic beeps (tomlongfield, #372): the quieter three-beep sound from before 1.3.9 is back as a choice.
More in the workout and history
- Repeat today (Space-Hermes, #58): open a past workout in History and start it again today.
- Pyramid sets (NtsCiccio, #367, #362): one rep target per set (12 · 8 · 6 · Max), a rest per set, and a "Max reps" chart in Stats.
- Per side on timed holds (horusglez, #322): left and right each run the full hold, with a 10-second "switch sides" pause in between.
- Progress photos (horusglez, #361): every photo kept with a workout on one timeline, with a before/after slider.
- Update routine from the session (FranciscoFavela, #336): copy an exercise's warm-ups, rest and note back into its routine.
- "Last time" in days, weeks or months (xwr3, #363) instead of a date. Hover for the full one.
- Pick your own backup folder on Android (#161), for example a sync app's folder.
Community pull requests
Thank you, all of you. This release is half yours.
- @kurktchiev: the session queue (#167), × to clear search (#338), the Coach card in the admin (#341), the workout menu's screen-reader label (#343),
check-in edits on a removed card (#344), the API under
BASE_PATH(#346), rating a superset set scrolls to the partner (#347), "rest over" on one device (#348), imported sessions graded on all sets (#349), hardened importers (#350), Coach messages in your language (#351), Coach consent that names notes (#352), the muscle chip keeps the equipment filter (#353), the plate load kind is kept (#354), MCP tools that answer the question asked (#355) and explain a broken data folder (#356), plus tests and tidying (#337, #339, #340, #342). - @giulioleuci: rotation mode, on top of the queue (kurktchiev/openGym#1).
- @EmilZapata: planned vs completed weekly volume (#333) and zero-credit muscle mappings (#359).
- @horusglez: per side on timed holds (#322) and progress photos (#361).
- @NtsCiccio: pyramid sets (#367).
- @FranciscoFavela: update routine from the session (#336).
- @dima-po: three-form plurals for Russian (#365), and a steadier media test (#366).
- @nauish: Traditional Chinese, a whole new language (#368).
- @tomlongfield: the classic timer sound (#372).
- @alessandromoretti90: a workout finished hours later ends at its last set (#317).
- @olivierbbommel: Safari no longer turns 62.5 into 6265.5 (#320), and Finish stops a running plank timer (#321).
- @tfdmendes: neatly aligned routine cards on desktop (#374).
Bug fixes
- Custom exercises can be edited and deleted again, including older ones and ones from a shared or Coach plan (Teo230, #358; svillar, #378).
- The up and down arrows move an exercise within a superset, and out of it at the edge (svillar, #377).
- Strong's current export, the one with semicolons, imports again (davidjorgensen, #394).
- Pairing the phone app says why it failed: a proxy or CORS rule in the way, a login page answering in openGym's place, or a server that can't be reached (#329).
- A cardio block or a long hold at the end no longer shortens the workout's duration.
- 8.5 in a reps field no longer becomes 85, a running plank survives a reload, and the rest timer stops when you sign out.
- Loading the same starter plan twice no longer doubles your routines; a custom exercise can share a name with a catalogue one; an equipment profile no longer hides imported custom exercises.
- Plates: a single stack counts each pair properly.
- Imports refuse impossible dates and numbers (year 9999, negative, 1e308 kg), a Hevy session over midnight keeps its length, a zip's photos upload straight away, and the summary says how many rows it skipped.
- Workouts dated later today are no longer in the future, durations and body weight have sane limits, and the weight axis never says "-0".
- Passkey, pairing and import errors speak your language instead of developer English.
- Polish and Ukrainian plurals are right everywhere (#365), "Drop {0}" means a drop set in every language, and long labels no longer get cut off in Russian, Portuguese, Hungarian or German.
- Android: status bar icons readable in the light theme, Back works after "All settings" and from the Start menu, and no tab bar on the very first screen.
- Without an account, nobody can flood the admin log with junk sign-ins or fill the server with pairing codes.
For self-hosters
FIRST_USER_ADMIN=1(seals187, #328), opt-in: the first profile on an empty instance becomes its admin. Off by default; if you turn it on, register yourself before you share the address.BASE_PATH(#346): serve openGym under a sub-path such as/gym. The web container checks the value at start-up.- Phone app and CORS (#329): a new section in SELF_HOSTING.md on proxies
that answer or change the CORS preflight (Traefik
headersmiddleware, a secondAccess-Control-Allow-Origin, SSO in front of/api/), with a one-linecurlcheck. openGym handles CORS itself, so leave it alone on the openGym route. - Show connection status (seals187, #330; xwr3, #369): Settings → Look & Home can hide the sync line at the top. A dot on Home still warns when sync is stuck.
- Durable writes: every file the API keeps is flushed before it is renamed into place, and
./data/db.json.bakholds a copy of the last gooddb.json. Back up./dataas before. - If you build your own API image from a copy of the Dockerfile: it now also needs
queue.js,nudge.js,nudge-copy.js,durable.jsandsync-stamps.js. PASSWORD_LOGINis unchanged and still off by default.build-api-docs --checkruns in CI (#342).
Known limit while old phones are around
The server stamps what a v1.3.9 phone sends, so most things just work. Until every device is updated, though, an old phone can't always say what it has seen: if it sets something back to exactly what it was before, after another device changed it, the other device's change loses. Workouts that v1.3.9 deleted offline and never uploaded may come back once; delete them again and they stay gone. Anything the update had to set aside is under Settings as "This device, before the update". Once everything is on 1.3.10, none of this applies.
Languages
- 🇹🇼 Traditional Chinese (nauish, #368): eighteen languages now. Browsers set to zh-Hant, zh-HK or zh-MO open in it.
- Every string reworded to sound more human, with fewer long dashes and a bit more fun.
v1.3.9 (2026-09-28)
The milestone was "edit your history", and it is in: fix a saved workout after the fact, move it to another day, change how long it took, attach photos and videos to it. Around it, the two reports from Discord that mattered most — a paired phone that quietly stopped syncing and lost a week, and a routine planned at 2 × 10 that opened at 2 × 15 — are fixed at the root. Password sign-in for instances that want it, more than one passkey per profile, your own picture on your own exercises, Structural Balance, plate loading per set, the rest countdown in an Android notification, Ukrainian and Arabic. Thirty-nine community pull requests from eighteen contributors, plus five more taken in part. Web bundle, APK and API image.
The two reports from Discord
- A paired phone can no longer lose your workouts without telling you (andi242). After the
server refused a phone's sign-in once — "Sign out everywhere" does that, so does an expired
token — the next start of the app unpaired it silently but kept you on screen, every sync after
that went nowhere and was counted as done, and Disconnect then wiped the phone. Every paired
phone since v1.2.10 could get there. Now:
- The app says when it is not connected, always: a line at the top for offline, a server that cannot be reached, a server that refuses this phone, an answer that is not the server's, and phone-only or guest use.
- A refused phone keeps its pairing and its data and offers Pair again. Phones already stuck in that state from an earlier version are healed when they start, and their unsynced workouts reach the server once they are paired again.
- Settings → Server & sync shows the host, the account, the status, the last sync, what is still waiting, and a Sync now button.
- Disconnect and Sign out ask first when something has not reached the server yet — try again, export it, or go ahead anyway. Going ahead keeps a copy on the device, and it is merged back the next time you connect to the same account.
- Pairing again or signing in to the same account merges, instead of replacing the phone's copy with the server's. A phone in use renews its sign-in on its own.
- Signing in or pairing waits for your answer to "add this device's workouts?" before it touches anything, and a kg ↔ lb conversion, a reset or a backup import now reaches every device.
- Tip if you were hit by this: the phone's daily backup files (
Documents/openGym/, orDocuments/opengym-backup-….jsonfrom before this version) may still hold the lost days — Settings → Import.
- The plan owns the reps (seals187, Supportlik, #275, #216). A session copied its reps from the last time you did that exercise in any routine, so a 2 × 10 day opened at the 2 × 15 you had done somewhere else. Now a planned session starts from the plan (Settings → "Planned sessions start from": your plan, or your last session), progression runs per routine slot and falls back to the exercise's history only when the slot has none, an edited plan restarts progression with its new weight, and the card says "Plan: 2 × 10" (or "2 × 10–15" for a range).
- Double progression waits for the top of the range (Diego-Sanchez2000, #278, bluzername's #297) before it adds weight.
- A stale second tab can no longer overwrite the server (danielkleinert, #283). Each tab tracks the revision it last saw, and a conflict keeps the latest edit of every routine and workout instead of whole copies.
- The iPhone home-screen app opens offline again (tpodolak, #274, bluzername's #298) — and a slow connection no longer cuts a download off halfway.
Editing your history
- Edit a saved workout (Space-Hermes, #203, #143, #229) — weights, reps, sets and exercises, in the same screen you logged it on; progression and records re-read the corrected session. A workout emptied in the editor offers to delete it instead of saving nothing.
- Date, start time and duration (Parth-Vasave, #263, expressiveminute, #218), without touching what you lifted.
- Photos and videos on a workout — attach them on the finish screen or in the workout's detail. They live on your server and the device, never in the synced data.
- Log a missed day (svillar, #284) — mark a planned routine from a past day as done; its rows only look at the history from before that day.
- Drop sets and supersets show in History, an exercise's history opens from a past workout, a workout copies as text, a finished session saves as a routine of its own (Space-Hermes, #211), and every weigh-in has a history with weekly averages.
- "Don't count for progression" for one exercise or a whole workout (the ⋯ and ⋮ menus) — an injury day stays out of the next session's numbers.
Accounts and sign-in
- Password sign-in, if you want it (#118). Off by default; an instance switches it on with
PASSWORD_LOGIN=1, and each profile opts in by setting a password in Settings. Sign in with the profile's name or an e-mail address you add (no mail is ever sent). Passwords are stored with scrypt, repeated wrong guesses pause sign-in for that name, and an admin can hand out a one-time reset code. Removing a passkey or the password asks for proof first. - More than one passkey, and a new device by code (AlexanderVott, #95). Settings lists a profile's passkeys to add, rename or remove, and Add another device shows a one-time code and QR; the code creates a passkey on the new device, never a session by itself.
During a workout
- Pause the rest timer — paused time does not count, and the alert moves with it.
- The rest countdown in an Android notification (vitox013, #296, #122), with Pause, ±15 s and Skip, on time with the screen off. A louder chime, and a Vibrate switch of its own.
- Plate loading per set (kurktchiev, #194) — each row shows the plates for its weight, from the plates you own; "No bar" Smith machines count from zero, and drop sets land on a weight you can actually load.
- ⌨️ Keyboard shortcuts (#133) — Space or Enter ticks the next set, the arrow keys switch exercise, for a keyboard or a Bluetooth button.
- Rest timers stay on Ready when they run out, and a timed hold may run into overtime (Space-Hermes, #204). The rest timer and a hold can no longer run at once (kurktchiev, #251).
- The line under each exercise can show your best set instead of last time (Flxp49, #173); the next workout card peeks in while you swipe (Space-Hermes, #202, sgoendoer, #113); "Set current" goes straight to card view (bluzername, #262, xwr3, #260); typing an exact RIR/RPE no longer ticks the set on the first keystroke (kurktchiev, #288).
Plan, library and stats
- Structural Balance (Josevi, !140) — Stats compares your lifts with each other against the Poliquin, Thibaudeau and ATG ratios and names the weakest one.
- Your own picture on your own exercises (#126, #170; based on horusglez's #295 and Vaibhav159's #246) — one photo, GIF or short video (up to 40 MB and 60 s) and one link per custom exercise. The file is stripped of its location data, kept on your server and on the device, never in the synced data, and works offline once seen; a YouTube link makes no request until you tap it. Shared plans carry the link, never the file.
- Replace an exercise in the routine editor (codedmind, #110) and keep its sets, reps, weight and rule; print a single routine or save it as PDF (Teo230, #282); swipe left to delete a routine in Plan (Agripa22, #286); a drag handle on computers (seals187, #277, sgoendoer, #114).
- A compact "+" on a day that already has a routine (seals187, #276), a live result count in exercise search (GitLab !31), "benchpress" finds "bench press", cardio speed in mph for imperial users, the activity heatmap by time or by volume (Space-Hermes, #205), repeated exercises add up the same way in History and Stats (Space-Hermes, #212), a changed load cascades down the sets without overwriting the ones you set by hand (Space-Hermes, #209), and the Home body-weight card can be hidden (sacgsxr, #279).
Languages
- 🇺🇦 Ukrainian (illinoiseeee, #285) and 🇸🇦 Arabic, laid out right to left (smsmy, GitLab !36) — seventeen languages in all.
- Exercise names in seven languages: German (mkoester, #290), Spanish (AlexRomero12, #245), Russian (dima-po, #266), Italian and French (giulioleuci, #254), next to Brazilian Portuguese and Hungarian — each with a switch to show the English name beside it, or only the English name.
- DEFAULT_LANG (edgardjnr, #303) — an instance can pick the language of its sign-in screen and of profiles that never chose one; otherwise a new visitor starts in their browser's language.
- Russian demo strings (dima-po, #265), untranslated Coach equipment chips (dima-po, #264), and CSV imports that read localized month names (sTOrM2202, #273).
- "1 workout and 1 weigh-in" instead of "1 workouts and 1 weigh-ins" when signing in finds entries from while you were signed out.
The AI Coach
- A review that swaps in an exercise the routine already has is told the rule and keeps the rest of its proposal, instead of failing as "unusable" (fama-lama, #313).
- Routine icons from the Coach work, and its plans pick more varied exercises (ameer-khan-ashraf, #311).
- The maximum message length is an admin setting (bluzername, #280, SSamDav, #267, #268).
- A bonus set no longer reads as a stall you never had (kurktchiev, #287); Save in the Coach setup, the demo Coach's failure state and the intake line are fixed (kurktchiev, #289); a weekly review is due until it has run, not for one minute a week (kurktchiev, #249).
- On an iPhone the Coach waits out a slow local model instead of giving up after 30 seconds
(thedandano, part of #187), and the phone refuses a plain
http://endpoint with a reason. - A run that fails before its first status check still answers in the chat.
Imports
- Strong: a workout's Duration is its length and its Workout Notes the session note, and timed holds come in as seconds. Hevy: supersets come in as supersets. The import summary shows the year when the range is not this year.
Android and iPhone
- Android 15: sheets sit on top of the keyboard with the field you are typing in above it, and with three-button navigation the tab bar sits above the navigation bar, so a tap on a tab no longer lands on Home or Recents.
- iPhone: large photos and videos are kept in a form Safari can read back, so they play and upload. The iOS build targets iOS 15.5 (clown-doing-code, #270).
- The release APK carries only the ARM builds and is about 12 MB smaller (#136). Automatic
backups go to
Documents/openGym/and only the newest 14 are kept (#161). - Exercise pictures stay available offline in the installed web app (xwr3, #281).
Self-hosting
- Kubernetes (chriscowley, #304) — manifests in
kubernetes/and a guide,docs/SELF_HOSTING_KUBERNETES.md, with both images pinned to the same release. - Settings shows your account id, for an admin who needs to find your data (ItzEarthy, #219); the admin's "last sync" counts pulls as well as pushes.
Security and robustness
- Coach hardening: everything that goes into a Coach prompt — what you typed, the plan, the log, every id, and the "compare with others" figures — is bounded field by field before it is sent, so no text from another account can reach your prompt and an oversized request is never made.
- A sign-in throttle in front of the password routes, counted before the check.
- The API answers a client's mistake as a client error and keeps its state cache bounded (kurktchiev, #249); a push that carries nothing of the profile can no longer empty it on the server; the admin's activity log names what each pause was for.
Community pull requests
- Space-Hermes: edit saved workouts (#203), Ready rest timers and hold overtime (#204), the heatmap by time or volume (#205), load cascades that keep manual edits (#209), save a session as a routine (#211), consistent totals for repeated exercises (#212), the swipe preview (#202).
- kurktchiev: plate loading per set (#194), a build that names itself (#244), API hardening (#249), the part of #250 this release took, the timer and hold fixes (#251), the API reference with the Coach routes (#255), check-locales that reads the translations (#256), sheet pinning (#257), a lighter tab bar (#258), and three Coach and effort fixes (#287, #288, #289).
- bluzername: Set current to card view (#262), the Coach message length (#280), double progression (#297), the service-worker timeout (#298).
- dima-po: Coach equipment chips (#264), Russian demo strings (#265), Russian exercise names (#266).
- Parth-Vasave (#263), vitox013 (#296), chriscowley (#304), ameer-khan-ashraf (#311), AlexRomero12 (#245), giulioleuci (#254), mkoester (#290), illinoiseeee (#285), clown-doing-code (#270), sTOrM2202 (#273), sacgsxr (#279), Agripa22 (#286); on GitLab smsmy (!36) and Josevi (!140).
- Taken in part, with thanks: AlexanderVott (#95), thedandano (#187), horusglez (#295), Vaibhav159 (#246).
Thank you to everyone who reported, tested and wrote code for this one: andi242, seals187, Supportlik, Diego-Sanchez2000, danielkleinert, tpodolak, svillar, expressiveminute, ncbachh, codedmind, Teo230, Flxp49, xwr3, sgoendoer, fama-lama, SSamDav, edgardjnr, ItzEarthy, asierlama, Space-Hermes, kurktchiev, bluzername, dima-po, Parth-Vasave, vitox013, chriscowley, ameer-khan-ashraf, AlexRomero12, giulioleuci, mkoester, illinoiseeee, clown-doing-code, sTOrM2202, sacgsxr, Agripa22, smsmy, Josevi, AlexanderVott, thedandano, horusglez and Vaibhav159.
Upgrading
- Nothing to migrate: v1.3.8 data opens as it is.
- Update paired phones. The fixes for silently unpaired phones are in the app, not the server; a phone still on v1.3.8 can still get stuck.
- "Sign out everywhere" unpairs phones too — each one then shows Pair again, and keeps its data.
- New, all optional, in
.env(see.env.exampleanddocs/SELF_HOSTING.md):PASSWORD_LOGIN=1switches password sign-in on. It is off by default. Give the api container at least 256 MB of memory when it is on.TRUST_PROXYlets the sign-in throttle read the client's address fromX-Forwarded-For. The bundleddocker-compose.ymlnow sets it, because there the api is reachable only through the web container. Running the api any other way, turn it on only when whatever sits in front overwrites that header.MEDIA_*for exercise and workout photos and videos:MEDIA_UPLOADS=0turns uploads off,MEDIA_QUOTA_MB(200 per profile by default),MEDIA_MIN_FREE_MB(uploads stop below that much free disk), and the per-type size limits. Media needs disk space — on a small disk or with open signup, lowerMEDIA_QUOTA_MB. Keep the web container'sMEDIA_UPLOAD_MAXaboveMEDIA_VIDEO_MAX_MB.DEFAULT_LANGfor the instance's default language.
- The api image carries new files (
password.js,rate-limit.js,passkeys-store.js,device-link.js,media.js). If you build your own image with an explicit file list, add them. - A reverse proxy with a short read timeout can cut off a slow video upload; photos are unaffected.
Known and not fixed: counts in Russian, Ukrainian and Polish still use the English two-form plural rule ("2 дней" where it should read "2 дня"). The Ukrainian, Arabic, Hindi, Korean, Thai and Chinese packs have not been read by a native speaker yet — corrections are very welcome.
v1.3.8 (2026-09-20)
Twenty-four reports closed: the keyboard that would not stay open on iPhone and iPad, notifications that arrived with notifications switched off, reps you could not read on a narrow phone, and assisted pull-ups that recorded your progress backwards. Plus the four things this milestone promised — reorder your routines, a Smith machine with no bar, two-decimal weights, and deleting an account for real. Eleven community pull requests from six contributors. Web bundle, APK and API image.
The fixes people actually hit
- ⌨️ The keyboard stays open (FabianReitz, hectorroaz, #242). On iPhone and iPad, tapping a field
threw the keyboard straight back out about four times in five — worst on "Create new profile",
where a new user could not type a name. The page-alignment guard blurred the field you had just
tapped, because its "is the keyboard open?" check compares two numbers that both move while the
keyboard animates in. Measured on iOS 26.6:
innerHeightfell 684 → 374 while the visual viewport sat at 158, so the keyboard read as closed ~100 ms after every tap. Nothing acts on that check while a text field has focus now. - Notifications respect the switch (shibbrich1, #239). The rest-timer alert asked for the browser permission itself and then fired whether or not Push was on — and a permission cannot be handed back. Off is off.
- Reps are readable again on a narrow phone (seals187, #235). A row with weight, reps, an effort column and the +/− buttons left the number nothing: at 320 px the reps field was empty and 102.5 kg showed as "102". Every number field now reserves the widest value it shows and the buttons give way first — checked across 108 combinations of width, layout, effort mode and per-side rows.
- Assisted pull-ups and dips count the right way (dpatrongomez, kvalev, #232, #176). The
stack carries part of your weight, so less assistance is the harder set — but 30 kg stayed the
record over 20 kg, and progression answered a clean session by offering more help. Eight
catalogue exercises are affected, and
assistedon a custom exercise marks any other. - List view keeps your place (xwr3, #224) — it opens at the exercise you are on, not at the top of the session.
- Extra sets stay out of the plan (kvalev, #233). A heavier bonus set used to raise next session's weight, and a hard one taken short reported the whole session as missed.
- Subpath deployments work (leon332157, #238). Behind a proxy that strips its prefix there is
nothing to configure; one that passes the prefix through takes
BASE_PATH=/gym.
The four this milestone promised
- ↕️ Reorder your routines (hjeroen-git, #142) — arrows in Plan, and the Start screen, the day sheets and every picker follow the same order.
- "No bar" (Aoto Ideguchi, #138) — a Smith machine that carries its own carriage now counts plates from zero instead of snapping back to a 9 kg bar.
- Two-decimal weights (Aoto Ideguchi, #139) — Settings → Weight decimals, for quarter plates and microplates. 62.75 stays 62.75 instead of rounding to 62.8.
- Delete an account (shibbrich1, #107) — the admin dashboard can remove a profile and everything attached to it, not just disable it. It asks twice and offers their data as a download first; it refuses to delete you or the last admin.
Community pull requests
- kurktchiev: the iOS Home Screen icon behind an auth proxy (#184), an unknown path no longer serves a shell that cannot load (#185), and a way back to the Start screen on a day that already has a plan (#237).
- Space-Hermes: typo-tolerant exercise search (#206), Olympic-lift muscle groups (#207), shared plans keep their kg/lb unit (#210), and a Coach test that no longer fails around midnight (#208).
- aaron-rai: the activity heatmap follows your week-start setting (#220).
- ncbachh: rename a workout while it is running (#228).
- Strazdonis: the big weight read-out can be typed into (#234).
- mkoester: standard ß in the German pack (#190).
Found by a QA sweep of every screen, and fixed
- Search: "wrist" returned 200 abdominal exercises, because the typo tolerance matched body parts and equipment as well as names. Fuzzy matching is now name-only, and only for words with no exact hit anywhere.
- Switching kg ↔ lb left each workout's stored total and session body weight in the old unit, so History, the calendar and the heatmap showed kilo totals under a pound label. Body weight also converts at 0.1 now, not in plate steps, so a round trip comes home.
- Sharing a plan stripped a custom exercise down to its name and body part: it arrived with no equipment, no muscles, and no way to edit or delete it.
- Importing a second export re-created the custom exercises the first one had made, splitting the history in two; imported volume counted warm-up sets; hyphenated names ("Stiff-Legged Deadlift") were filed under the wrong body part.
- Tapping an exercise in Stats → Strength threw instead of opening its history.
- Admin: a profile whose stored file held a malformed entry blanked the whole dashboard, and that account could then not be disabled. The API answers 400 (or 413) for a request the client got wrong instead of 500 with a stack trace, and refuses an array as the state document — which used to wipe the profile and silently reset its revision.
- Phone-width layout: the double-progression row wraps into pairs, list-row titles keep their width, page headers give way before their button, drop-set rows and cardio speeds are readable, and the column header lines up over per-side rows.
- 🇷🇺 Muscle names no longer leak internal ids ("gluteal", "hip-flexors") into the picker, the config sheet or the Muscles list, and a day with one routine says "1 routine".
Known and not fixed: counts in Russian and the other Slavic packs use the English two-form plural rule, so "2 дней" where it should read "2 дня". It affects every counter in the app and is being done properly rather than patched here.
v1.3.7 (2026-09-12)
The v1.3.6 tag's Android build failed on a double dash inside an XML comment, so the APK for everything in v1.3.6 is this one — plus the iPhone timer-sound fix that landed an hour later. Web bundle, APK and API image; v1.3.6 and v1.3.7 are the same code apart from the two items below.
- The Android build builds again: a comment in
styles.xml(from the safe-area work in v1.3.6) contained--, which XML forbids inside comments. - Timer sounds on iOS (kurktchiev, #183, #152): every tone resumes the audio context first (a lock or app switch leaves it suspended and silent), the context is unlocked from the taps that lead to a timer, and Settings → Sounds gains Play sounds when the phone is on silent (off by default, iOS 17+), which switches the page's audio session to playback so the ring/silent switch no longer mutes the beep — at the cost of pausing whatever else the phone was playing.
v1.3.6 (2026-09-12)
Sync you can trust and a phone that behaves: signed in, the server's profile is always the truth, two devices merge instead of overwriting each other, the app polls for changes and works offline with a banner; reminders and push subscriptions heal themselves; chip rows, sheets under the notch and the tab bar are fixed on iOS; the twelve Astra findings, eleven community merges and a headless QA sweep of every screen. Web bundle, APK and API image.
The Coach reports after v1.3.5 had one thing in common: it failed and nobody could see why.
Bug round (2026-09-12) — the reports from the owner's own phone: push late or missing, desktop and phone out of step, the Exercises chip rows scrolling the page, sheets under the Dynamic Island, the tab bar mid-screen during a workout. Web bundle, APK and API image.
Two devices no longer overwrite each other. Sync was "whichever copy was saved last wins, whole document": a desktop tab left open for a day and then touched — one setting — pushed its stale copy over the workouts the phone had logged meanwhile, and the phone adopted the loss at its next start (issues #128, #124; GitLab #33, #25). The server now keeps a revision on every profile (
_rev,GET /api/datahands it out) and refuses a write that is not based on the current one (409, with the current document attached). The app merges the two copies — every workout, routine, weigh-in, custom exercise and favourite from both sides is kept; settings follow the newer copy — and pushes once more. It also asks the server what changed whenever the tab, window, app or network comes back (throttled to once per 15 s), one push and one pull at a time, and nothing pushes before the first pull of a session has landed. Older clients that send no revision keep overwriting as before, so a paired phone on an old build still syncs. Import and "Reset everything" are deliberate replacements and skip the merge.Signed in, the server's profile is the truth — always. Signing in used to keep whatever copy had the newer timestamp, and anything tracked while signed out is always newer: the owner signed out, logged a session as a guest, signed back in and kept seeing the guest copy while the desktop showed the real profile. Sign-in (and pairing a phone) now adopts the server's profile — settings, plan, history, everything — and asks one question when the device holds workouts or weigh-ins the profile does not have: Add them (only those entries join the profile) or Keep profile as is. A profile that has no state yet still takes the device's data, as creating one always did.
The newest copy is fetched every chance it gets. While the app is open and signed in it asks the server for its revision every 30 seconds (one tiny request,
GET /api/data/rev) and on every return to the tab, window, app or network, and fetches the document only when the number moved. A desktop tab left open all day now shows the phone's session within half a minute.Offline mode says so. A signed-in user who cannot reach the server sees one line under the header — "Offline — your changes are saved on this device and sync when you are back online" — or "Not synced yet — tap to retry" when the server refused a push. The changes stay on the device, are retried by the poll and the moment the network is back, and a toast confirms "Back online — synced with the server". The app also flushes a pending change on
pagehide, since Safari can kill the home-screen app without a visibility event. Guests and the standalone Android build have no server and see none of this.The home-screen app comes back without a network. The service worker cloned each response for its cache a moment too late — after the page had started reading it — so the clone failed silently and nothing but exercise media was ever cached: a reload of the installed app without a connection gave the browser's "you're offline" page. The worker now caches the shell and every script, style and icon the built index.html references at install, keeps them fresh network-first, and serves them when the network is gone. Its cache is named after the build, so a deploy is a new worker with its own cache and the previous build's files are dropped. Starting the app offline also raises the offline line at once, and the in-progress workout, stored on the device, is exactly where it was.
Reminders that were due still arrive. The workout-day reminder wanted its exact minute: an API restart, a redeploy or a stalled tick across those 60 seconds lost the whole day's reminder. A reminder is now sent for up to 15 minutes after its time, once per day, never later. The tick also stops re-reading every account's state every 10 seconds (it re-reads only files that changed).
A push subscription the server lost comes back on its own. The browser keeps its subscription through anything that happens on the server — a row pruned after a dead send, a rebuilt
db.json, a regenerated VAPID key — and Settings said "on" while nothing would ever arrive. On every signed-in start the app hands the server its subscription again (POST /api/push/subscribeis an upsert,GET /api/push/statusis what the switch shows), a subscription made for a key the instance no longer has is replaced, the service worker answers the push service's own key rotation (pushsubscriptionchange), a payload that fails to parse still shows a notification instead of counting as a silent push, and a send refused with 403 is pruned like a dead endpoint. Off https the row says push is not supported instead of hanging.A rest-timer alert belongs to the device that started the rest. The server held one timer per account, so a desktop tab finishing its rest on screen cancelled the alert the phone in the gym was waiting for. Each browser now carries its own token; older clients keep the old behaviour. (The Android APK has no Web Push: its reminders are local notifications scheduled on the phone.)
The Exercises chip rows scroll sideways only. Revealing the active chip used
scrollIntoView, which also scrolls every ancestor: with the row above the fold a tap made the whole page jump. The row now moves only its own scroll position, it contains overscroll on both axes, and the chips' enlarged tap area no longer gives the row a 4 px vertical scroll range of its own (a diagonal swipe or a wheel tick used to shift the whole row up and leave it there). On a desktop browser a chip row can be dragged with the mouse (HenryByte, !119, #147).Sheets stop short of the notch / Dynamic Island. Every bottom sheet's height now subtracts the top safe-area inset (and so does the exercise picker when the keyboard is up); centred dialogs scroll inside themselves instead of growing past the screen. On Android the app declares the cutout mode and
adjustResize, so the same insets are real there.The tab bar stays at the bottom after the keyboard. On iOS a weight field kept its focus when you tapped the tick (WebKit does not blur on button taps), the keyboard went away, and the viewport stayed displaced — tab bar and rest timer mid-screen. Ticking a set and opening a sheet now blur the field, and the correction also works while a sheet has the page pinned. The mobile workout screen keeps less blank space under the last set (mflova, !121).
Weigh in before workouts is a switch (kurktchiev, #174, #137): off, Start goes straight into the session; body weight can still be logged from Home and Stats.
🇨🇭 Swiss German (mkoester, #171):
de-CHderived from the German pack (ss for ß, Swiss number formatting), no second pack to maintain.iOS shell builds with Xcode 26 / iOS 26 (shailantani, #117; thedandano, !125): UIScene lifecycle, deployment target 15.5.
Rest between warm-up ramp sets (kurktchiev, #164): a per-exercise
warmupRestSecfor plan files; the break into the first work set stays the working rest.Custom exercises (LuckaPow, #162): equipment is chosen (and required), muscle names read like the built-in ones, cardio gets its target, a chip's focus outline is no longer clipped in a sheet.
nginx resolver is configurable (T13o, !110, #148):
RESOLVERenv (default Docker's 127.0.0.11) so /api resolves under Podman and Kubernetes.Plan as PDF on the phone (HenryByte, !118, #149): "Print as PDF" opens the OS print dialog, which saves to Files / Drive.
The equipment filter survives a body-part change in the exercise picker (ErrorUsernameAlreadyTaken, !120, #150), and per-side (L/R) data is preserved through progression and session flows (!133).
Coach job directory (T13o, !135): permissions set with chmod instead of chown, so the built-in Coach runs on a container without CAP_DAC_OVERRIDE.
The twelve Astra findings (kurktchiev, #166, #160): a request target that does not parse answers 400 instead of an unhandled rejection; a stored state the reminder tick cannot read is skipped instead of taking the API down, and
PUT /api/datarefuses non-arrayworkouts/routines; the push-endpoint address rule judges every IPv6 spelling; "sign out everywhere" voids unredeemed pairing codes; the built-in Coach's daily and instance limits cannot be reset by "forget", queued jobs hold budget and are dropped on forget, scheduled reviews do not bill the same workout twice; the local copy remembers its owner and is wiped when another profile signs in; a copy adopted from the server keeps the server's timestamp; "Reset everything" says what it deletes and where; a 413 on sync is shown instead of swallowed; nginx allows 5 MiB on/api/.Seven strings that arrived with combine routines, the layout switch and the 1RM deload were in no locale pack and showed in English in every language.
From a headless sweep of every screen after the above (phone and desktop, all 14 languages): the set number in front of a per-side (L/R) set was an unstyled 11-px button; a unilateral set's volume was max-weight × total reps (14×10 left and 12.5×6 right read 224 kg, not 215); timed and cardio sets saved by older builds read "0" in history and on the workout card; the finish summary's tiles cramped into four columns inside the dialog on desktop; exercise names in menu titles and "added to" toasts were lower-case and the 1RM line said "Kg"; in German, Russian, Spanish, French, Italian, Portuguese, Polish and Hungarian the segmented controls in Settings painted over their row titles (the control now wraps under the title when both do not fit); the Home "today" title can take two lines before the ellipsis ("Leg Day — in progress" in Hungarian); the Language row shows the full pack name; the routine editor's rows showed a red sliver of the swipe-to-delete button at their corners; FitNotes' stock "Flat Barbell Bench Press" now matches on import.
A weight off the increment grid keeps its offset when progression raises it (#175): a sled logged as its own 167 lb plus plates — 397 — with a 10 lb step now goes to 407, the way a stepper tap does, instead of snapping to the grid's 410. Linear, Greyskull and double progression.
Rest-timer pushes no longer pile up in the tray on iOS (#172): the service worker closes the previous notification of the same kind before showing the next one.
A failed Coach run on the phone says what the provider said. With your own API key there is no admin card and no instance owner, so "the instance owner needs to check its setup" was the wrong sentence and hid the one thing that mattered — OpenAI's "you exceeded your current quota", Gemini's "model not found", the validator's "unknown exercise id". The chat line and the toast now carry that reason, and the phone wording no longer points at an owner who does not exist. (issue #58; Discord reports of "the OpenAI API is bugging")
You can no longer get stuck after a plan fails. A message typed with no plan on the board used to become a review, which answered "there is no workout to look at" forever. It now asks for a fresh plan with your message as the brief, and the Coach menu has Start a new plan — a new plan from your intake answers; workouts, history and body weight stay. (Discord "Coach reset" thread; install-help reports)
The Coach remembers the last few lines of the chat. "Shorter, like you said" and "the same thing as before" had nothing to point at: every message was a fresh request. The last six lines — what you wrote and what the Coach concluded, never proposals or errors — now travel with the request as context (
conversation, documented in the prompt as data, not instruction).CI: every push to
mainnow builds the signed APK as well, not only tags (the project runner pays for it, not shared minutes), so a broken Android build shows up before the release tag and the newest build is always downloadable from thebuild:apkjob. Abuild:iosjob (unsigned.ipafor AltStore/Sideloadly) is in the pipeline too, waiting for a Mac runner —docs/MOBILE.mdsays what to register.Updates are the last thing in Settings. On Android a permanent row checks gitlab.com on demand and installs a newer release with one tap (the download is verified against its checksum first); on the web the same spot links to the APK. The row no longer hides inside "Data" and no longer disappears when there is nothing new.
Combine routines (HenryByte, !102, #59): a weekday can hold several routines, and a running session can pull another routine in from the header ⋮ — a rehab routine on top of push day. The layout switch moved into that menu. Older data with one routine per day reads unchanged.
Compact layout (HenryByte, !100, #57): a third workout view with only the sets you are logging, and a per-session ⋮ switcher between cards, list and compact.
One-sided exercises log each side (ErrorUsernameAlreadyTaken, !107, #60): weight, reps, effort and the done tick per side, drop-sets and rest-pause per side too; history reads "L 15×8 · R 15×7". Totals, volume, PRs and progression keep reading the combined row.
Rating a set completes it (ErrorUsernameAlreadyTaken, !106, #64): picking RIR/RPE ticks the set and starts the rest timer.
Check-in cards (ErrorUsernameAlreadyTaken, !105): edit a card's photo and label, the last card used opens first, manual code entry removed.
Deloads aim at an estimated 1RM (mflova, !103): linear and double progression deload to 90 % of the Epley estimate of the target, on the exercise's weight grid, never above the load that stalled — a 5 kg lift keeps 5 kg and drops reps instead of falling to 2.5 kg. The factor is per exercise.
A climb through the rep range is progress, not a stall (arhx91, !101): under double progression a session that beat its best at the current weight no longer counts toward a deload.
Swipe to remove (surohsusej, !73): swipe a routine exercise or warm-up set left to remove it.
The OpenAI model list only shows models this request shape can use. The account's full list — speech, embeddings, image models, realtime and Responses-only variants — made it easy to pick one Chat Completions refuses with a 400 or a 404. Compatible endpoints (Ollama, LM Studio, OpenRouter) stay unfiltered. The Gemini key field also names the new
AQ.key prefix.openGym is back on GitHub, and GitHub is home again. The account suspension that took
github.com/DuarteSantos8/openGymoffline on 2026-08-19 is lifted. Everything that happened on GitLab in the meantime is there again: history, tags, the releases v1.2.9 to v1.3.5 with their APKs, the GHCR images and the GitHub Pages demo. GitLab is now a mirror, pushed by a GitHub Actions workflow on every push tomainand everyv*tag; it keeps running the CI that builds the signed APK and the images. Issues and pull requests go to GitHub; the merge requests still open on GitLab are reviewed and land onmainfrom there. The site follows suit.
v1.3.5 (2026-09-06)
One bug, and the one everybody with the Android app and their own API key ran into. Web bundle and APK; the API only carries the version number.
- "Bring my own API key" works on the phone. Since v1.3.0 every key-store call on Android
hung before it started: the secure-storage plugin was handed to the app as the value of a promise,
and a Capacitor plugin object answers any property name with a native method —
thenincluded — so the promise took it for a thenable, called a nativeSecureStorage.then()that does not exist, and never settled. That one stuckawaitwas all three reports at once: "Save and use the Coach" greyed out forever, the key "not saved" when you came back, and a Coach that sat on "thinking…" without end because the job read the key first. The plugin now travels inside a plain object, a test drives the store through a Capacitor-style proxy so it cannot come back, and the whole flow — save, intake, plan, restart with the key still there — was run on an emulator before tagging. The web app and the "use my self-hosted openGym" mode were never affected. (issues #42, #58; reported by many on Discord)
v1.3.4 (2026-09-05)
Two things noticed on the phone right after v1.3.3. Web bundle and APK; the API only carries the version number.
- The effort picker looks like the rest of the app. The v1.3.3 sheet was a grid of colour-edged tiles that matched nothing else on screen. It is now the same list the ⋯ menus use: a tinted square with the value where the icon sits, the sentence as the row, a tick on the current one, and an "Exact RIR" row carrying the app's own stepper, tinted like the logged cell. Same six levels, same colours, same free value.
- Animations that fail to load fall back instead of breaking. If the animation cannot be fetched (dropped connection, CDN hiccup, an instance that gates media behind a session) the still picture takes its place; if that fails too, a neutral tile does, and a tap tries again. No more broken-image glyph on a white block.
v1.3.3 (2026-09-05)
The workout screen gets out of the way, and the bug round from the board. Same day as v1.3.2 on purpose: that one is the contributors' batch, this one is the redesign and the fixes on top of it. Self-hosters need the new web bundle and images; the API is unchanged. This is the release to install on Android — it is the first APK that can update itself.
The workout screen
- ⋯ One menu per exercise. Note, details, progression settings, bar weight, add a warm-up set, make a superset with the previous or next exercise, swap, move up, move down, remove — all behind one button next to the exercise name, acting on exactly that exercise, also inside a superset. The rows of buttons that used to sit in the header, under the sets and under the card are gone; a pencil still appears once an exercise has a note. (issue #20)
- The set number is the set's menu: drop set, rest-pause burst, remove this set. No more "+ Drop / + Burst" chips on every row and no per-row X on warm-ups.
- List view keeps the header pinned — name, clock, set counter, discard and finish stay at the top while the session scrolls.
- Settings → During a workout → Workout controls. Four switches bring any of the old groups back: weight and reps +/− buttons (off: tap the number and type it), drop/burst shortcuts on every set, superset buttons in the header, move/swap/remove buttons below the exercise. Existing profiles read as the lean default.
- Colour-coded RIR / RPE. An unrated set shows one "RIR" (or "RPE") button; tapping it opens a picker with six levels, each with a sentence — "Nothing left, went to failure" through "Easy, warm-up territory" — and a field for an exact value. A logged rating tints its cell by how close to failure it was, the same colour whether you think in RIR or RPE; the +/− on it follow the Workout-controls switch. (ErrorUsernameAlreadyTaken, !91 — issue #32)
- History without leaving the workout. ⋯ → History: a line of your best set (or estimated 1RM, longest hold, minutes) over time and the last ten sessions with every set, the volume and a PR marker. Also reachable from an exercise's details in the library. (issue #43)
- ▶️ On the workout screen the centre tab button reads "Workout" and stays lit instead of an idle "Resume"; Resume from anywhere else returns to the exercise you marked, which no longer moves on its own. (issues #29, #21)
Planning and library
- Favourite exercises. Star an exercise in its details; favourites sort first in the picker, the library and the muscle explorer, and the picker gets a Favourites chip. (issue #6)
- Switching kg ↔ lb converts your numbers — or keeps them and only changes the label, your choice in a sheet: logged sets and drops, working weights, routine targets and increments, warm-up configs, body weight, goal and bar weights; lb rounded to 0.5, kg to 0.25. (issue #22)
- Resistance bands count as bodyweight equipment: one reps stepper and the reps-then-sets progression, unless you switch Bodyweight off for that exercise. (issue #39)
- Warm-up ramps snap to the exercise's own increment (1.25 kg plates) instead of the unit default.
- Copying a copy of a routine gives "Name (Copy 2)"; the swap picker's "+" quick-adds like every other picker; a weekday whose routine no longer exists no longer triggers the starter-plan prompt.
Android
- In-app update. Settings → Data shows "openGym vX available" when a newer release exists; one tap downloads the signed APK, verifies its SHA-256 against the published checksum and opens the installer. No checksum, no install. Needs the "install unknown apps" permission the first time. (ErrorUsernameAlreadyTaken, !40 — issues #38, #9)
- Saving the Coach with your own API key no longer hangs on a greyed-out button: the mode is written before the key, the secure store gets a timeout, and every failure says what went wrong in a toast. (issue #42)
- The APK carries version code 17 (v1.3.2: 16). Two releases had reused 15; the update check compares the version name, so nothing changes for you, but Android's own "newer" check is honest again.
v1.3.2 (2026-09-05)
Seventeen community merge requests from twelve contributors, each read, rebased onto a staging instance and put through a tester round before landing, plus the fixes that round turned up. The web bundle and the images change; the API only gains the Coach schema tightening. The Android APK ships with a real version code again (16 — the last two releases had reused 15).
Active workout
- List view. Settings → During a workout → Workout view: Cards (as before) or List, the whole session stacked and scrollable, the current exercise outlined, "Set current" to move the marker, supersets grouped with their own Unpair. (dpatrongomez, !96 — issues #28, #44, #50)
- The working weight is captured, not asked. Finishing an exercise no longer opens the "confirm your working weight" sheet: the heaviest completed work set becomes the working weight, for both members of a superset, and the current marker stays where you are until you press Next. Working weights are stored when the workout is finished, so a typo corrected before that, or a discarded session, never becomes your "Best". (mflova, !92 — issue #18)
- One tap, one step — in supersets too. The +/− on weight, reps and RIR moved two steps per tap on the second member of a superset. (ErrorUsernameAlreadyTaken, !97 — issue #41)
- The weight stepper uses the exercise's own increment (1.25 kg plates, 5 lb, whatever you set), with progression's rounding, on set rows and drop-set rows; timed sets keep their seconds. A value off the increment grid steps by exactly one increment rather than snapping. (mflova, !84)
- Routines with progression off keep their targets. The same exercise as 2×15 in one routine and 4×8 in another no longer opens the second with the first's reps — also when adding or swapping an exercise mid-session and when saving the progression sheet. (mflova, !71)
- No deload spiral. A weight change starts a new stall streak, so one bad day at the lighter weight after a deload cannot trigger the next one. (arhx91, !93)
- The progression sheet cannot save into the wrong exercise after the list shifted under it or the workout was replaced. (Space-Hermes, !77)
- Timer flash blinks the theme instead of a black/white overlay and settles back on your theme. A timer that ended while the app was in the background no longer replays the beep and flash when you come back; a quiet toast still says the rest is over. (mzspicoli, !89)
Planning and library
- Four starter plans. Home, Plan and Settings → Load starter plan open a chooser: Push/Pull/Legs, Upper/Lower, Full Body, 5×5. Free weekdays load at once, occupied ones ask first; existing routines are never touched. (lordlukem, !94)
- Muscle explorer. Library → "By muscle" (and "By muscle" inside Add exercise): tap a muscle on the body map or its chip, filter by search, body part and equipment, open details or plan it. Follows your equipment profile like the library does. (prasad_gade05, !87)
- Copy routine at the bottom of the routine editor. (ErrorUsernameAlreadyTaken, !85)
- The "+" in the exercise picker adds immediately with the default config (freestyle: last session's) and says so in a toast; tapping the row still opens the config sheet. (surohsusej, !72)
- Stats → Exercise progress: long exercise names use the full width. (mflova, !80)
MCP and Coach
preview_session— a ninth MCP tool: what a routine will actually open with after the progression policy, the confirmed weight and history have had their say, with the source of every number and a list of exercises where plan and screen disagree. Built on the app's own session builder, so progression-off and deload routines preview exactly what the screen shows. (koyosan, !90)get_routinereports each exercise's own rest asrest_sec. (TheophileDiot, !81 — issue #36)- The Coach's create schema requires a routine id and a week and caps the arrays, so a small local model cannot answer with a plan the validator can only reject. (subdee, !99)
- BodyMap tests import the geometry before the first render — no more one-off failures on a slow runner. (TheophileDiot, !82 — issue #35)
Self-hosting and infrastructure
- nginx re-resolves the api container per request. Recreating only
api(new IP) no longer leaveswebanswering 502 until it is restarted too. (issue #16) - The published
apiimage drops npm and both images take alpine's package fixes at build time; the image scan reports nothing. - CI: JUnit and coverage in every merge request, a bundle-size diff against main, a compose smoke test of the pushed images, a Trivy scan with SBOMs attached to the release, a tag preflight (versions and changelog checked before anything builds), and pipelines for contributors' fork MRs started automatically for returning contributors.
- Renovate runs again: its configuration had two unknown keys and had stopped opening MRs. (issue #37)
v1.3.1 (2026-09-04)
- "Use my self-hosted openGym" works on a paired phone. The phone app never fetched the
server's
/api/configafter boot or after pairing, so the Coach setup screen told everyone "your server has no Coach enabled" — while the admin was looking at a passed test. The screen now asks the server afresh every time it opens, and the boot and pairing paths load the config like the web app always did. Reported on Discord.
v1.3.0 (2026-09-03)
The AI Coach gets the version number it deserves. v1.2.16, earlier today, was the release that got it out of the door; v1.3.0 is the same app with one more fix, and the number that says "something new is in here" to everyone who reads a changelog. If you are on v1.2.16, this is a small update. If you are on anything older, read the v1.2.15/v1.2.16 notes below — the Coach, bar weights, the rest-day line and the rewritten admin dashboard are all new to you.
- The Strength map's list makes sense again. Below the map, every detrained muscle
showed its set count of the last 90 days — which, for a muscle that is on that list precisely
because it has not been trained lately, was a column of "0 sets", and where it was not zero it
printed as
1.2000000000000002. Each row now says how many weeks ago the muscle was last trained (or "not trained"), with the rounded 90-day sets on top only when there are any.
v1.2.16 (2026-09-03)
- The web image builds again. v1.2.15's tag pipeline published the API image and the APK
but the web image failed to build: the frontend imports the Coach's core from
api/coach/core, andweb/Dockerfilecopied onlyfrontend/. The image now carries that directory at the same relative position it has in the repository, and a newbuild:web-checkjob builds the web image on every merge request that touches the frontend, the Dockerfile or the core — the API image had that check, the web image did not. Nothing else changed; v1.2.15's notes below are this release's notes.
v1.2.15 (2026-09-03)
The AI Coach. An optional coach that designs a training plan from a few answers and reviews what you actually log — off by default, switched on by the admin, consented to by each user, and driven by whatever AI you bring: an Anthropic, OpenAI or Gemini API key, any OpenAI-compatible endpoint (Ollama, LM Studio, vLLM, OpenRouter), or a Claude Code / Codex runtime inside the container. Nothing it proposes is applied on its own; every change carries its reason and can be undone. Details in docs/AI_COACH.md. Also in this release: per-exercise bar weight, a rest-day line on the home screen, and the admin dashboard rewritten in plain language — those three shipped to main earlier and are here for everyone.
AI Coach
One API key serves the whole instance. A pasted Anthropic, OpenAI, Gemini or OpenAI-compatible key is shared by every profile, bounded by the daily limits in the admin card — it is metered and issued for exactly this use. Only a personal credential (a Claude Code setup token) still binds to the first profile that spends it, and that binding now actually happens when a job runs rather than only existing in the tests.
A rate limit or an overloaded provider is not a failed job. 429, 529 and 5xx get two more tries a few seconds apart before the status becomes the job's failure; a 4xx that means the request is wrong is never retried.
Warm-up sets no longer read as work. They were counted into stalls (a light ramp set below the rep target looked like a miss), into done/planned sets and into the top set of a session. They are now filtered the way the app's own progression engine filters them, and the few that still travel in full sessions are flagged
warmup: trueso the model reads them as prep.Admin card fields are visible again. The base-URL and model fields shared the card's background and the two daily-limit numbers were the browser's white default box; both are real fields now, sized so a phone does not zoom into them.
An API key is proven end to end in CI: a local stand-in for each provider's API receives the pasted key on the right header, the cached rules block, the schema, and answers a review that lands as a proposal — the test that says "paste a key and it works".
A local model answers in a fraction of the time. The prompt is split so the rules — identical for every job of a task — ride as the system message and only the payload changes: a llama.cpp/Ollama endpoint reuses its KV prefix cache instead of re-reading ~2.7k tokens of rules per job, and Anthropic caches the same block server-side at a tenth of the input price. The payload itself shrank by more than half: compact JSON, full set-by-set detail only for the five most recent sessions (older ones become one line per exercise —
aggregatesalready counts stalls over the whole window), and a library slice of{id, name, bodypart}. ~14,600 tokens processed per review before; ~5,900 now, plus a cached prefix.The answer cannot leave its shape. Providers that support schema-constrained decoding (Ollama, LM Studio, vLLM, OpenAI) get a JSON schema with the request; the repair round is for content now, not syntax. Endpoints that reject it fall back to JSON mode, then to plain text, exactly as before — and the validator stays the only judge either way. The OpenAI-compatible endpoint also runs at temperature 0: a plan diff wants determinism.
A debrief of one workout. "Review my last workout" hands the Coach a single session — with the last three of the same routine, the stall picture and four weeks of weigh-ins — and gets back a score out of ten, what went well, what to watch and what to do next time, each item citing the session's own numbers. It cannot carry a plan change: the validator refuses one rather than trimming it. Kept in the Coach history like everything else.
Compare with others on your instance — if the admin allows it. A new switch under Advanced turns on anonymous medians across profiles that opt in (each person flips Include me in the chat; a profile that does not share sees nothing). Sessions per week and the best estimated 1RM per exercise, you against the median, plus a rank — only where three or more people train it, and nothing at all until three people share. The same medians (in kg) go to the model on a review or a debrief, for perspective only. The opt-in lives server-side, not in synced state, so a stale device cannot flip it back on.
The Coach is a conversation now. The first visit is an intake in the style of a phone setup — one question per screen, 1–7 days a week, session length as hours:minutes, the consent text with room to read it. After that it is a chat: your answers are the first message, a typing bubble counts the seconds while the job runs, the plan lands as a card with a tab per routine and the reason under every change, free text asks for a refinement, one button applies it. Coming back, asking for a review, changing an answer — same chat. The per-user off switch is gone; only the admin turns the Coach off.
Admin card in numbered steps — provider → endpoint → access → model → test — with a status pill and plain-language state; limits, account and isolation under Advanced, the job log under Activity.
A local model gets the time it needs.
COACH_JOB_TIMEOUT_MSraises the five-minute job budget for a CPU-bound Ollama or LM Studio; the api's HTTP client now waits as long as the job does instead of hanging up after undici's 300 s while the model was still typing; the phone's own-key mode gives a local endpoint 25 minutes and never lets the native transport cut first; and the chat stops promising "a minute or two" when the endpoint is local.The exercise catalogue in the payload is capped at 160 — round-robin across body parts, deterministic, with everything in your plan and your history always included so a review can name what it is talking about. All 1,324 used to go along: 10k+ tokens a job against a metered API, and more than a small local model's context holds.
A single session is not a trend. The review prompt now refuses structural changes on fewer than three sessions or less than a week of data — a small model used to remove a leg exercise because "the one session had no leg work".
Four providers that only need an API key. Anthropic, OpenAI, Google Gemini, and any OpenAI-compatible endpoint — Ollama, LM Studio, vLLM, OpenRouter, a gateway of your own — can now drive the Coach. They speak plain HTTPS from the api process, so they need no AI runtime in the image and no unprivileged user: they work on the default
apiimage. Thecoachimage is now only for the Claude Agent SDK and the Codex CLI. Setup is a chip and a pasted key in Settings → Admin → AI Coach; List models fills the model picker from what the endpoint actually serves. A model on your LAN is the compatible endpoint with no key.Keys, models and account bindings are kept per provider. Switching chips used to clear the stored credential; now each provider keeps its own, and the chip shows when one is held.
./data/coach.jsonchanged shape for this: an existing file's one flat credential, model and binding are lifted onto the provider they belonged to on first load. One-way — downgrading to an earlier build will not read them back, which costs one paste of the key.The Anthropic API-key path was unreachable. The admin card hid "Use an API key" for any provider that also took a setup token, which was exactly the Claude one. Both buttons render now.
The Coach on the App-Store build, chosen in Settings → AI Coach: pair the phone with your self-hosted instance and the Coach runs there, or bring your own API key and the phone calls the provider directly with the same allowlist, validator and repair round as the server. Nothing AI-related is loaded until one of the two is chosen; a BYOK key lives in the platform's secure storage, never in the app's state; a local daily cap bounds what you spend.
The Coach's core — payload builder, validator, parser, prompts, plan fingerprint and the invoke → parse → validate → repair loop — moved to
api/coach/core/, runtime-neutral, so the phone imports the same code the server runs. The exercise catalogue and the prompts are generated ES modules (scripts/build-coach-assets.mjs --checkin CI), andapi/scripts/check-core-loadable.mjsproves the core still loads under bare node.Validator hardening: the lifter's own custom exercises are now accepted when the model names them (they were offered to it and then refused, burning the one repair round); ids that are object keys downstream (
__proto__,constructor) are refused; weight and speed have ceilings; an exercise cannot be added twice to a routine; two changes cannot share an id; a weight for an exercise never lifted is dropped rather than guessed.
v1.2.14 (2026-08-30)
The largest community release so far: twenty merge requests from ten contributors, read and tried one by one on a staging instance, plus two features of our own and a pass over how the app feels under a thumb. Nothing changes on the server — a self-hosted instance only needs the new web bundle; the APK carries the new reminder scheduling.
New
- Log a past workout. History → "Log a past workout": pick date, start time, duration and a routine (or freestyle), then log it on the normal workout screen — weights, reps, RIR/RPE, timed sets, everything. A day that already has a workout asks: replace it, add a second one, or cancel. Backfilled sessions are filed in chronological order, claim no PRs against later history, and don't touch the weights your next session starts from.
- Import straight from Hevy. Settings → Import from Hevy with a Hevy Pro API key pulls workouts, routines and weigh-ins directly — no CSV export needed. The key is used for the one import and never stored; importing again updates the routines it created instead of duplicating them. (JuliusHaring, !30)
- Rest per exercise. Any exercise can carry its own rest time; a superset rests once, with the longest of the group. The global timer stays the default, and "Off" is overridden only by an explicit per-exercise rest. Shared plans carry it. (trapy, !34 — issue #10)
- Planned deloads. A routine can be excluded from automatic progression: its sessions open on the routine's own targets, stay in history and statistics, and are skipped when the next regular session computes its prescription — reps and durations included. (tokyo_underworld, !28)
- Timer flash. Opt-in screen flash when a rest or work timer ends — for loud gyms and headphones. (mzspicoli, !29)
- Thai and Hungarian. Full UI translation in both; Hungarian also localizes all 1,326 exercise names and instructions. That makes 14 languages. (tomzt, !64 · kecskemethy, !68)
Active workout
- Adding an exercise mid-session now also moves and swaps cleanly: move the current exercise or superset up/down (the rest countdown follows it), or swap it for another — logged sets stay with the original, the replacement arrives with your usual weights, and a grouped exercise asks whether the replacement stays in the group. (Space-Hermes, !41, !43)
- Swipe between exercises on the workout card — left/right moves through the session, buttons and inputs stay untouched. (Space-Hermes, !48)
- Supersets keep the next set centered on screen, not just in view. (Space-Hermes, !52)
- The progression line is now a button: tap "Linear · +2.5 kg…" mid-workout to open the exercise's settings; changed rules rebuild the open rows and keep everything you already logged. (Space-Hermes, !54)
Routines and progression
- Reorder by long-press. Hold a routine row and drag it; superset groups move as one block. The arrow buttons stay, now group-aware and disabled at the ends. (Space-Hermes, !45, !47)
- The double-progression rep range is visible: "Reps from" and "Reps up to" side by side, per-side exercises stepping in twos — and a progression step of zero can no longer be saved by accident. (mflova, !69 and !60 follow-up)
Stats and the rest
- The Stats exercise picker is searchable, and the results stay above the mobile keyboard. (mflova, !27)
- The muscle map works from the keyboard and ranks ties in body order. (Space-Hermes, !46)
- Android reminders follow the calendar: scheduled per date instead of per weekday, so a rescheduled day reminds you and a day you already trained stays quiet. (mflova, !66)
- The MCP coach reads what the app shows: custom exercises resolve in every tool, warm-ups no longer count as PRs, and progression policies report the value the UI uses. (TheophileDiot, !38)
- A self-hosting HTTPS guide for valid certificates on a LAN-only address — wildcard cert via DNS challenge, Caddy in front, no ports opened. (andi242, !67)
Feel
A pass over touch, scroll and tap across the whole app: chip rows keep a slightly diagonal swipe instead of handing it to the page; sheets decide an axis before following the finger, snap back cleanly and close on a quick flick; the body-weight slider drags relative to the knob instead of jumping to it; steppers repeat while held; going back restores your scroll position; a just-dropped routine row is tappable immediately; the exercise picker's search stays above the keyboard; set-row inputs, checkboxes and small icon buttons all got bigger touch targets; and rows everywhere can be driven from a keyboard.
With thanks to Space-Hermes, mflova, JuliusHaring, trapy, tokyo_underworld, mzspicoli, TheophileDiot, tomzt, kecskemethy and andi242 — ten contributors in one release.
v1.2.13 (2026-08-30)
One follow-up that arrived on !60 minutes after v1.2.12 was tagged, and belongs with it.
- An empty or zero progression step can no longer be saved. With a progression rule on,
leaving the step field empty or at
0marks it red, explains why, and holds the save — a step that cannot progress anything is no longer stored by accident. Nothing else changed; a self-hosted instance only needs the new web bundle. (mflova, !60)
v1.2.12 (2026-08-30)
Six small fixes from the community, each read and tried on staging before it went in. All of them are in the active workout or the exercise settings; nothing changes on the server, so a self-hosted instance only needs the new web bundle.
Active workout
- Adding an exercise mid-session puts it right after the one you are on, not at the end of the list, and the flow carries on from there: "next" takes you to the next unfinished exercise and the finish prompt only appears once nothing is left open. Before, a set added late could leave you looking at a completion prompt with work still pending. (Space-Hermes, !42)
- Removing an exercise no longer leaves a timer behind. A rest countdown that belonged to the removed exercise stops with it — but a rest you are in the middle of for a different exercise keeps running and simply follows that exercise. (Space-Hermes, !51, narrowed here)
- Discarding a workout stops a running timed set. The countdown used to keep going, and beep, on a session that no longer existed. Cancelling the confirmation leaves it running. (Space-Hermes, !59)
- A custom exercise you delete still counts in recovery. The muscle map and the recovery view read the snapshot saved with each finished workout, so deleting the exercise afterwards no longer blanks the muscles it trained. (Space-Hermes, !58)
Exercise settings
- Progression steps below one can be typed. Entering
0.5used to snap back to the default halfway through, because the field rejected the intermediate0. A cleared field still means "use the default". (mflova, !60) - Long values in routine rows no longer squash the title. The value column is capped instead of reserving space, so a "3 × 12 @ 102.5 kg" row keeps its exercise name readable on a narrow phone. (MokshManral, !37)
With thanks to Space-Hermes, mflova and MokshManral.
v1.2.11 (2026-08-25)
A correction release. v1.2.10 landed planned warm-ups and notes, and reviewing that release afterwards turned up six defects it had either introduced or made matter — three of them in the warm-up work itself. None of them broke a test, which is the point: they were gaps beside the tests rather than failures in them.
Warm-ups
- Warm-ups were counted in your session volume. Every other part of the app leaves them out — records, progression, the muscle map — and the routine screen says so in as many words ("left out of volume, records and progression"). Volume was the one place it was not true. Three planned warm-ups on a 3×5 at 100 kg reported 2562.5 instead of 1500, and that number is written into the finished workout, so it would have stayed wrong for good.
- On a deload, the last warm-up came out heavier than the work sets. The ramp was built before progression had its say and nothing recalculated it, so a plan dropping from 100 kg to 50 kg gave you warm-ups of 50 and 75 under work sets of 50. The ramp is now derived after the prescription, so it always aims at the weight you are actually about to lift. A warm-up you have already logged keeps its weight — it happened.
- One too-heavy warm-up spread to the rest. Editing a warm-up above the working weight made every warm-up added after it inherit that number. Your own edit stays as you typed it; what stops is the inheritance.
Notes
- The session note now exists. v1.2.10 described three kinds of note and shipped two: the code that saves a whole-session note was there, and tested, but nothing in the app ever wrote one. There is a note field next to the finish button now — wrapping up is when you know how the session went.
- The session note stopped being thrown away. In a past workout it only saved when the field lost focus, and Escape, the Android back gesture and swipe-to-dismiss all close a sheet without that ever happening. Type a note, press Escape, gone. It now saves on the way out too.
Sharing, stats and settings
- Shared plans carry drop-sets and rest-pause. A routine built as "3×5 with a double drop" arrived at the other end as a plain 3×5, silently. Both the intensifier and the planned warm-up count are now clamped in both directions, so a hand-edited plan file cannot put a nonsense number in front of you either.
- The version is visible again, at the bottom of Settings — which is where the support template has been telling people to look for it. On the phone there is no address bar, so there was no way to tell which build you had or whether an update installed. (issue #7)
- The rest timer can be turned off. v1.2.10 made this worse before it made it better: it started resting after every set instead of finishing an exercise quietly, and there was still no way out. "Off" now sits with the other durations.
- The exercise picker in Stats no longer runs long names into the label (mflova, !24), and a chart tooltip no longer lingers from the previous exercise (mflova, !25). The estimated-1RM series is memoised as well, so the tooltip stops vanishing under your finger while you read it.
Website
- opengym.duarte-santos.ch has been rebuilt — a bento layout with real device frames, a
mobile menu that opens instead of hiding, scroll reveals that respect
prefers-reduced-motion, and a section collecting where the project actually lives. It had been live for a while without ever being committed, so the repository and the site had drifted apart.
v1.2.10 (2026-08-25)
The first release since the move to GitLab that is mostly other people's work. Nine contributors, thirteen merge requests: Brazilian Portuguese in full — interface, all 1,324 exercise names and all 7,710 instruction steps — equipment profiles for people who train in more than one gym, drop-sets and rest-pause, a way to pair the mobile app with your own server, and a round of security hardening on the API and the reverse proxy.
Alongside that, the bugs you reported in #bugs-and-ideas and on the issue tracker, several of which turned out to be worse than they looked from the outside.
Training
- "Add warm-up set" gave you a warm-up at your full working weight. It looked for the row to ramp from at the position before the first work set — which for the first warm-up is index −1, so it fell through to the last row instead: your heaviest set. Every warm-up you added had to be corrected by hand. Warm-ups now ramp toward the work weight, each one closing half the remaining gap (50% → 75% → 87.5%), rounded down to what you can actually load.
- Warm-ups can be planned in the routine. Set how many an exercise gets and the session starts with them already in place, ramped, instead of you adding them every time. They stay out of volume, records and progression, and they travel with a shared plan.
- The rest timer skipped the last set of every exercise. It was written as "final sets finish quietly", but another exercise follows that set and you rest before it too — so a two-set exercise timed one rest instead of two. It now rests after every completed set except the last one of the session. (issue #3, and zkssyth arrived at the same rule independently)
- Notes you can write during a workout, in three kinds, because they have three different lifetimes: what happened today, on the exercise; what is always true about the movement (seat height, pin position); and how the session went as a whole. The per-session note carries a pin — the app cannot know whether "shoulder twinged" is a diary line or "go narrower" is a message to your next self, but you do, at the moment you write it. Pinned notes come back the next time that exercise comes up.
- Drop-sets and rest-pause / myo-reps, planned per exercise and extending the set row itself rather than adding new sets.
Equipment, and training in more than one gym
- Equipment profiles. Build a "Home" and a "Gym" list of what you actually own, and the library, the exercise picker and your routines filter to it — with a warning on any routine exercise that needs something the active profile does not have. Body-weight exercises are always available.
Brazilian Portuguese
- 🇧🇷 pt-BR is complete: the interface, every built-in exercise name, and every instruction step. It is defined as a layer over pt-PT rather than a copy, so a string added to Portuguese can never silently go missing here — with tests that fingerprint every inherited entry and refuse European vocabulary (ficheiro, telemóvel, ecrã, «guillemets»).
- Server-sent notifications — rest-timer alerts, test pushes, workout-day reminders — follow the profile's language instead of always arriving in English.
Fixes
- Home kept asking you to do the workout you had just done. The week strip knew the day was finished; the row underneath did not, and went on showing the routine behind a green Start tag. (issue #4)
- "Exercise progress" was empty for bodyweight exercises. Pull-ups and push-ups carry no weight, and every point without one was dropped, so a full history read as "No data yet". When nothing in an exercise's history was ever loaded, the reps are the progress — so that is what is plotted now. Add a weighted set later and it switches back to weight. (issue #5)
- The tab bar was see-through. At 72% opacity the page read straight through it and the
labels competed with whatever was scrolling behind them — nobody needs to read the content
under a navigation bar. It is 94% now in both themes, and blurs less, which is also faster on
Android, where a blur behind a fixed element is recomposited on every scroll frame. Where
backdrop-filteris unavailable at all — old Android WebViews, "reduce transparency" — the blurred surfaces now go fully opaque instead of leaving just the alpha, which was the worst of both. (reported by mflova, seconded by seals187) - No Smith-machine exercise could ever match on import. The
machine → leverrule ran beforesmith machine → smith, so the generic one ate the word first. Hevy's vocabulary is now mapped as well, and exercises it cannot match take their body part from the name instead of defaulting to "upper legs" — which had been attributing a third of an imported history to the legs. (diagnosed by rubik_97, fixed by koyosan) - Charts show the calendar year when the data spans more than one, so a point from November 2025 is not confused with February 2026. (mflova)
- Exercise search matches whole words in any order, ignores accents, and searches the translated names too — "bench barbell" finds the barbell bench press, "elevacao" finds "elevação". The haystack is now built once per exercise instead of on every keystroke.
- Passkeys work in Chrome on iOS, which was excluded by a user-agent test rather than by asking the browser what it supports.
- The reps field in a superset is no longer squeezed on narrow phones, and secondary muscles are visible while building a plan, not only in the Exercises tab.
Self-hosting
- Security hardening on the API and the proxy: SSRF and an unbounded handler in push delivery, CSRF from a sibling subdomain, session-cookie shadowing, and non-forgeable proxy headers. Details in SECURITY.md.
- When a passkey fails, the error now says what is misconfigured. "Unexpected RP ID hash"
told you nothing about your own
.env; it now names theRP_IDandORIGINthe server is actually running with.docs/SELF_HOSTING.mdgained a section that works through the usual causes in order — including thatdocker compose restartdoes not re-read.env, and that on a LAN without certificates there is nothing you can configure to make passkeys work. - "Connect to my server" pairs the standalone mobile app to a self-hosted instance with a one-time code, no passkey ceremony needed inside the app's WebView.
- Optional local auto-backup on the mobile app after finishing a workout or editing a routine, and a System theme option that follows the OS.
With thanks to mzspicoli, Josevi, andi242, Space_Hermes, Horus Gonzalez, wagenheimer, koyosan, mflova and Aaron Sachs — and to everyone who reported one of the bugs above.
v1.2.9 (2026-08-23)
If you run openGym for other people, you have had no way to answer "who signed in, and when?" — the server kept no record of anything. It does now: an activity log in the admin dashboard, covering sign-ins, sign-outs, the attempts that failed, and every admin action. The other half of this release is that the live demo is back, self-hosted this time, after two months offline. And the project has a working home again: openGym now lives on GitLab, where CI builds the container images and the signed Android APK for every release — the thing that has been missing since the GitHub account went.
Activity log
- The admin dashboard has an activity log. Successful and failed sign-ins, profile creations and refused signups, sign-outs (including "sign out everywhere"), and every admin action: disabling or re-enabling an account, creating or revoking an invite code, and clearing the log itself. Filter it by sign-ins, admin actions or failures, and page back through it.
- It is a plain file.
./data/audit.log, one JSON object per line —tail -fandjqread it directly, which also means it is its own export format. Deliberately not part ofdb.json: that file is rewritten in full on every save, and the sign-in handshake is unauthenticated, so a log living in there would have turned one junk request into a full rewrite. Retention is a cap rather than an archive — the lastAUDIT_MAXevents (5,000) orAUDIT_DAYSdays (90), whichever runs out first. - It records less than you might expect, on purpose. No IP addresses unless you turn them
on (
AUDIT_IP=netkeeps only the network,fullkeeps the address); never the browser's user-agent; and never the passkey id behind a failed sign-in, because that id is a stable handle for one device and storing it would let an admin follow an unknown device from one attempt to the next. A rejected invite code is not stored either — a near-miss guess sitting in a log file helps nobody. - Clearing it is itself logged, and the event ids keep counting, so an erased stretch always leaves a visible gap.
- On by default when you update, and one variable turns it off. It records strictly less
than your instance already holds — every profile is in
db.json, every workout is instate-<uid>.json, and any admin can already read both — and a log that ships switched off tells you nothing on the day you need it.AUDIT_LOG=0disables it completely; no file is written. Nothing leaves your server either way: this is a local file, not telemetry. - Guests still never appear anywhere — guest mode does not talk to the server at all.
The live demo is back
- ▶️ https://opengym.duarte-santos.ch/demo/ — the in-browser demo, running on the project's own site instead of GitHub Pages, which went down in August with the suspended account. Same build as before: no backend, no account, seeded example history, and a reset button in its settings. The embedded demo on the landing page works again too.
openGym moved to GitLab
- https://gitlab.com/DuarteSantos8/opengym is the home of the project. Same history, same tags, same AGPL. gitea.com was the stopgap after the GitHub suspension and stays as a mirror; it never had a CI runner, which is why releases there had no images.
- Prebuilt images are back.
docker compose pullnow fetchesregistry.gitlab.com/duartesantos8/opengym/apiand/web, built for amd64 and arm64 on every release. Pulling is anonymous — the project is public, no login, no token. - The APK is built by CI now, not by hand. Every
vX.Y.Ztag produces azipaligned, signed APK, attached to the GitLab release and mirrored onto the download page. The signing key sits in protected CI variables, so it exists only onmainand on version tags — a merge request from a fork builds an unsigned APK and never touches the key. - Every merge request is tested again. The frontend suite (346 tests), the locale checks,
the fatigue probe and the MCP suite all run on GitLab CI. The GitHub Actions workflows stay
in
.github/for the day that account comes back. - The in-browser demo also builds to GitLab Pages (https://opengym-bc111a.gitlab.io/, which https://duartesantos8.gitlab.io/opengym/ redirects to); https://opengym.duarte-santos.ch/demo/ remains the copy the landing page embeds.
- Security reports have a private channel again: a confidential issue on GitLab. See
SECURITY.md. - Dependency updates continue. GitLab has no Dependabot, so Renovate runs from a monthly
scheduled pipeline with the same deliberately quiet policy the Dependabot config had:
grouped per ecosystem, majors on their own, odd-numbered Node images skipped, and the
generated
android//ios/projects left to follow their@capacitor/*packages. Security advisories ignore the schedule and land on their own.
Housekeeping
- The self-hosting docs,
SECURITY.mdand.env.examplecover the activity log, and theapi/server.jsline references inSECURITY.mdare accurate again. - Every repository link in the README, the docs, the app and the website points at GitLab, and the website's live star/release numbers come from GitLab's API.
v1.2.8 (2026-08-22)
A housekeeping release, and two things worth reading even if you skip the rest. openGym has moved to gitea.com — the GitHub account it lived on was suspended, and everything you click to self-host pointed there. And the exercise media's licence is now stated correctly: the images and animations are © Gym visual, not CC, which matters if you redistribute them.
The project moved to gitea.com
- openGym now lives at https://gitea.com/DuarteSantos/openGym. The GitHub account
was suspended on 2026-08-19 and took the repository, the GHCR images, the Pages demo and
Discussions with it.
docker composenow pullsgitea.com/duartesantos/opengym-{api,web}; the README,SECURITY.md,CONTRIBUTING.mdand the self-hosting docs point at the new home; issue forms, tests and the image publish run as Gitea Actions. If you self-host, re-pull: the oldghcr.ioimages are gone and will not update again. - Gitea has no Discussions, so questions and ideas are labelled issues — or the Discord, which is where most of it happens now: https://discord.gg/e62jY6fwVb.
- Old issue and PR numbers in the entries below stay as plain text. They point at a dead repo and do not match the numbering here.
The exercise media is © Gym visual — not CC
- openGym described the exercise dataset as "CC". That was wrong, and it is now
corrected everywhere it appeared (README,
NOTICE.md, the website, the in-app credit, the compose file andscripts/fetch-media.sh). Upstream hasaneyldrm/exercises-dataset licenses its two halves differently: the exercise metadata and instruction text are MIT, while the images and animations are © Gym visual, used under that dataset's terms with permission that is not transferable. - Nothing changes for using openGym. It never shipped that media — not in the repository, not in its history, not in the images or the APK; your instance downloads it from upstream on first run, and the media step now prints where it comes from and under what terms.
- It does change what you may do with the media. Reusing the images or animations — in openGym or anywhere else, commercially or not — needs your own licence from Gym visual. See NOTICE.md.
Features
- 🇧🇷 Brazilian Portuguese UI — Portuguese now has separate Portugal and Brazil options, with Brazilian terminology, date formatting and localized instructions for all 1,324 exercises. Built-in exercise titles show the Brazilian Portuguese name followed by the canonical English name, so both vocabularies remain recognizable and searchable.
Fixes
Server-generated notifications follow Brazilian Portuguese — rest-timer alerts, test notifications and workout-day reminders now use the profile's
pt-BRlanguage instead of always arriving in English.The back gesture no longer quits the app (Android). The packaged app never listened for the system back event at all — Capacitor leaves that to
@capacitor/app, which was not installed — so a back swipe went straight past the WebView and finished the activity from wherever you were. The per-sheet history entries added in #63 only ever did anything in a browser tab. Back now dismisses the open sheet, then walks back through the screens you came from, and only leaves the app after a second press at the root ("Press back again to exit"). A sheet that is locked mid-task still swallows back, as it does in the browser.
The website counts visits; the app still counts nothing
- https://opengym.duarte-santos.ch now runs self-hosted, cookieless Umami — page views for the landing, about and docs pages, no cookies, no third-party service.
- Your instance does not. The frontend only gets an analytics tag when
VITE_UMAMI_SRCandVITE_UMAMI_IDare set at build time, which they are not in any published image or in a plainnpm run build. A self-hosted openGym remains telemetry-free, as advertised.
v1.2.7 (2026-08-18)
The muscle map answers a third question. Balance showed where the volume went and Fatigue what was still recovering; Strength now names the exercises behind a muscle and what each one is worth in estimated 1RM. Fatigue itself got harder to fool — a set counts for more the closer it is to your maximum, and it can no longer creep upward across a rest week. In a session, supersets finally behave: pair them as you go, rest once per round, and drop an exercise you have decided against.
The muscle map, read as strength
- A per-muscle exercise breakdown behind the muscle card — estimated 1RM per exercise, decay bars, and primary/secondary tags, with a best-weight fallback for holds and carries that have no reps to work from. Contributed by @Space-Hermes in #92, #93 and #94.
- Fatigue is now intensity-weighted, not volume alone: a set counts for more the closer it is to your estimated maximum. It also reads against a stable historical reference, so fatigue can no longer rise across a rest week, and bodyweight movements no longer register as zero load. A property probe over 108,000 comparisons runs in CI to keep it that way. Contributed by @Space-Hermes in #55.
In a session
- Supersets advance properly. Completing a set moves to the next member of the group, the active exercise scrolls into view, and rest starts once the whole round is done rather than after each set. Contributed by @Space-Hermes in #80.
- Remove an exercise from a running session, with a superset-aware picker and a confirmation. Contributed by @Space-Hermes in #83.
- The Android back button closes the open sheet instead of leaving the screen or the app (#63). Each open sheet gets its own history entry, so stacked sheets unwind one at a time. Contributed by @Space-Hermes in #85.
Self-hosting
- The API service no longer has to be called
api(#99). The web image builds its nginx config at startup fromBACKEND,PORTandNGINX_PORT, all defaulted to today's values, so existing compose files are unaffected. Reported and fixed by @GAS85 in #100. - …and the shipped
docker-compose.ymlnow actually passes those through. Thewebservice had no environment of its own and published a hardcoded:80, so settingBACKENDorNGINX_PORTin.envdid nothing at all on the stock stack — the setting existed, the wiring did not. Both services now readPORTfrom the same place, so nginx cannot end up proxying to a port the API is not listening on. Defaults are unchanged, so an existing.envbehaves exactly as before. - Health checks and OCI image labels on both images — source, licence, version, revision and build date, so image tooling can tell what it is holding. Contributed by @GAS85 in #98.
- Images are published from a release, not from any tag (#87). A tag that gets consolidated away before it becomes a release used to leave its image tags behind in the registry, where dependency bots read them as newer versions.
Fixes
- Imported warm-up sets were counted as work. The importer marks them with
phase, but several places still read the older boolean, so warm-ups from FitNotes/Strong/Hevy history inflated set counts, progression and the fatigue map.
v1.2.6 (2026-08-11)
The muscle map learned to answer a second question — not just where the volume went, but what is still recovering from it. Plus: a freestyle session no longer starts from blanks, the rest timer can reach you in another app, and a self-hosted instance can insist that everyone using it has an account.
The muscle map, read as recovery (#44)
- A
Balance | Fatigue | Strengthswitch on the Stats muscle card. Balance is the map you already had and is untouched. Fatigue shades each muscle by how much of the recent training it is still carrying; Strength shades it by how long it has been since you trained it at all, with the weeks-since count spelled out underneath. - Fatigue is volume-sensitive and fades smoothly. A hard twelve-set chest day starts near the top and takes about six days to read ready again; a single set barely registers and is gone in two. It decays continuously on a 36-hour half-life rather than expiring at a window edge, so the map never flips from "fatigued" to "ready" between one look and the next.
- Strength holds for two weeks, then decays toward a floor. A muscle you have not trained in months reads detrained rather than absent, which is the state that actually tells you something.
- Both views are pure functions over your existing history — no new stored data, no schema change, nothing sent anywhere.
The rest timer can reach you in another app (#49)
- A system notification when rest is over, on top of the beep, for when you have switched to another tab or app mid-session. Permission is asked the first time a rest starts, and everything degrades quietly where notifications are unsupported or refused.
- It goes through the service worker where the browser requires that — which is most phones — and falls back to the direct API elsewhere. No new dependencies; the existing server push path is untouched.
Rows now strain the rear delts (#51)
- Four row variations gained rear-deltoid secondaries — barbell, dumbbell, inverted and cable seated rows — so the muscle map spreads their load the way the lift actually does. The overrides live in a small table that survives a regeneration of the exercise dataset rather than being edited into the generated data.
An instance can require an account (#42)
ALLOW_GUEST=0removes the "Continue without account" button. Guest mode keeps everything in the browser and never touches the server — no account, no sync, nothing the admin dashboard can see — so on an instance meant for a known set of people it was a door leading nowhere useful, and until now there was no way to close it.- It also ends guest sessions that already exist. Guests never authenticate, so there is no request for the server to start refusing; the switch reaches someone already inside on their next visit, when the app checks the config and returns them to the login screen. Their data is not deleted — it stays in that browser, and moves into a real profile if they create one on the same device.
- A server it cannot reach is not a server that said no. The button is only withdrawn on an
explicit
allow_guest: false; a failed config request, or a server too old to send the flag at all, leaves guest mode exactly as it was. An instance that is merely offline for a moment does not lock out everyone who never made an account. - Default is on, so nothing changes for existing instances. Set it alongside
INVITE_ONLY=1: invite-only governs who may create a profile and says nothing about the guest button, which never creates one.
Freestyle sessions start where you left off
- Adding an exercise to an empty workout now prefills it from the last time you trained it — the same number of sets, with each row's reps and weight carried across by position. Cardio brings its duration and speed, a hold brings its seconds. Until now every row opened on the config-sheet defaults, so the first thing a freestyle session asked of you was to retype what you already did last week.
- The config sheet agrees with the rows it is about to create. It opens on the last target you actually trained rather than the generic default, so the set count you confirm is the set count you get.
- Planned sessions are untouched. A routine-driven workout still runs the progression logic and still applies its prescription; only the freestyle path — which has no prescription to apply — reads from history instead.
Contributed by @Space-Hermes in #50.
Pair exercises into a superset mid-session (#64)
- "Make superset with previous / next" on each exercise card. Two exercises paired in the session collapse into a single Superset card — do them back-to-back, rest once at the end — with an Unpair button in the header. No planning ahead required; pair them when you decide to, in the workout.
- Groups are any size. Pairing the end of one group to the start of another merges them, and the header wording stays correct past two exercises.
- Unpairing cleans up after itself. A group reduced to one exercise is dissolved rather than left as a superset of one, and the pairing helpers never mutate the running session.
- Session-only by design: pairings drive the workout, and history stores the sets.
Contributed by @Space-Hermes in #64.
The muscle map stops rewriting the catalogue (#67)
- The curated secondary-muscle additions are now an overlay, not a mutation. The four row exercises that strain the rear delts used to get that written into the shared exercise dataset at import time, which meant export, print and import saw a catalogue that had been edited underneath them. They are derived at the read points instead, so the dataset stays pristine.
- The detail sheet's tag row reads through the same overlay, so those muscles still show where they always did.
Contributed by @Space-Hermes in #67.
Fixes
- Exercise images and animations were blank on the routine screen (#79). The media paths
were relative, and
/plan/r/:idis the app's only two-segment route — so the browser asked for/plan/r/img/…and got a 404 with nothing in the console to say why. Every other screen was fine, which is what made it look like a one-screen mystery. Reported with the root cause already found, by @lemi1000. - Imports mapped more of what other apps export (#74). Treadmill, Goblet Squat, Cycling and Cable Core Pallof Press arrived as custom exercises rather than catalogue ones — no word overlap could reach the names openGym stores them under. Those and their neighbours are now in the alias table. Already-imported history stays custom; new imports resolve. Reported by @KiloOscarSix.
- A progression edge case that could loop forever (#60). An entry left with nothing but warm-up rows seeded the set-growth loop from a warm-up, which could never satisfy its own exit condition. It leaves the entry alone instead. Contributed by @Space-Hermes.
- Documented that
VITE_IMG_BASE/VITE_GIF_BASEare build-time values, so setting them next todocker composedoes nothing on a prebuilt image.
v1.2.5 (2026-08-04)
Nothing in the app itself changed. This release adds an optional side door: a small server that lets an AI assistant you already run — Claude Desktop, Cursor, Cline — answer questions about your own training, off the same files your instance already writes. If you don't use one, this release is invisible to you.
Ask an AI about your training, without the data leaving your box (#19)
- An MCP server (
mcp/) — opt-in, read-only, and not part of the Docker build. Your LLM client spawns it as a local process, it reads./datadirectly, and it exits when the client disconnects. No new container, no extra auth on the api, no third-party service, nothing over the network. "What did I bench last week?", "what's my estimated 1RM on deadlift?", "which muscles have I been neglecting?" - The answers match the Stats screen because they are the same numbers. The server calls the
very functions in
frontend/src/lib/the app already computes with, rather than reimplementing them. Eight tools: routines, the week plan, workouts, one session in detail, body weight, estimated 1RM and muscle balance. - Read-only on purpose. Logging a workout from an assistant needs a long-lived token the api does not have yet, plus a lock against the web UI's read-modify-write. Until both exist, the server answers questions and does nothing else. It never reads passkey material, VAPID keys or session state — only the profile it was pointed at.
docker-compose.ymlis untouched and nothing new enters the image, so an instance that ignores this ships exactly what it shipped before. Setup is in mcp/README.md.
Under the hood
- The pure half of
i18n.js— the language state, the constants, the readers — moved intoi18n-core.js, so the helpers underfrontend/src/lib/can be loaded by a plain Node process and not only by Vite.i18n.jskeeps the Vite-only parts (the locale-pack loader, the React hook) and re-exports the rest, so nothing that imports it had to change. - The shared lib modules that only need
tnow take it from the core directly. A Vite-only import inside a shared module is invisible under vitest, which transforms it, and fatal to the MCP server, which does not — so the shared half stays clear of the bundler half by construction rather than by remembering to. npm run check:node-loadableinmcp/walks the server's import graph under a barenode, which is the one thing the test suite cannot do from inside Vite. CI runs it, alongside the MCP tests — neither had ever run there before.
The MCP server was contributed by @Pengboi — the first feature in openGym written by someone other than me. Thank you.
v1.2.4 (2026-08-01)
The effort ratings you have been recording since v1.2.3 now answer questions, and bodyweight training stops being treated as barbell training with the weight left at zero. Plus: creating a profile from Settings works on an invite-only instance, which it never has.
The effort ratings, read back as statistics
v1.2.3 let you rate how hard a set was. Nothing then read that rating back — it lived in the set label and nowhere else. Stats now answers the question the number was recorded for.
- An Effort card in Stats over 30d / 90d / 1Y / all time: average effort, the share of sets taken close to failure, and — always alongside them — how much of your training was rated at all. Rating is optional and off by default, so a partly rated history is normal; an average without its denominator would quietly speak for sets you never rated.
- Week by week. The weekly average with that week's set count in the tooltip, because the pair is the reading: volume up with effort up is fatigue accumulating, volume up with effort flat is the adaptation you were training for. Weeks resting on a single rated set are dropped rather than drawn.
- Where the sets land. The spread across the scale, not just the middle of it. Half your sets at failure and half in warm-up territory average out to a healthy-looking number; this is the chart that shows it.
- Hard-sets mode on the muscle map. The same body diagram, counting only sets taken near failure — "where did the stimulus go" rather than "where did the volume go". A muscle can lead on set count and still never be trained hard.
- Effort on the exercise curve. Each session's dot on the top-set chart fills in as less is left in the tank, so the same weight moved with more in reserve stops reading as a flat line. Exercises with enough ratings also get an Effort curve of their own.
- One history, whichever scale you use. Everything aggregates internally in RIR and converts back for display, so a history that mixes your own RIR logs with imported RPE averages as one series instead of two half-empty ones. RIR charts count downward on the axis, so harder sets sit higher.
- Translated into all 12 UI languages.
Bodyweight training, logged the way it is done
A push-up has no weight to type, and the app asked for one anyway — every set, on a quarter of the catalogue. Three reports (#31, #32, #33) turned out to be the same gap: the app assumed progress lived in the load. It doesn't, for the exercises most people actually start with.
- Exercises know they are bodyweight. Seeded from the equipment the dataset already records, so push-ups, pull-ups, dips and 300-odd others arrive marked. The weight column is not shown, the set row is one stepper instead of two, and the "confirm your working weight" prompt at the end of an exercise stops asking about a weight that was never there. (#32)
- Added weight when there is any. A dip belt or a weighted vest is entered once in the exercise settings and reads as an addition — "+10 × 8", not "10×8" — everywhere it is shown back. With load on the belt the normal progression rules take over again, because now there is something to add.
- Reps and sets are the progression. Clean session, one more rep. Set a top of the range and reaching it adds a set and starts the reps over instead of climbing forever; at six sets it says what it should have said all along, which is that it is time for weight or a harder variation. No ceiling set keeps the old behaviour exactly. (#33)
- Reps per side. For lunges, single-arm rows and every other unilateral movement. You log what you did — 16, the total — and the app shows the split, "8 per side", so the set in front of you is unambiguous without the rep count meaning one thing here and another there. The target steps in twos, 16 → 18 → 20, because half of an odd total is a rep one side never gets. (#31)
- Both settings travel with a shared plan, and are written to a plan file only when they disagree with the catalogue — every existing plan, workout and backup is read unchanged and none of it needs migrating.
- Translated into all 12 UI languages.
Fixed
- Creating a profile from Settings on an invite-only instance. The sign-in screen asks for the invite code when the server needs one; the same registration reached from Settings never did, so it was refused with nothing on screen explaining why. It now asks on the same terms.
- A long value no longer runs through its own label in a settings row — "Follow the routine (Linear progression)" overlapped "Rule" rather than shortening itself.
v1.2.3 (2026-07-31)
How hard a set was, in whichever of the two scales you already think in — and the ratings your old app recorded come across with the rest of your history. Plus: the phone stops locking itself mid-workout, the rest timer can hand time back as well as take it, and Settings is grouped by what each thing actually affects.
The screen stays on while you train
- Keep screen awake — Settings → During a workout, on by default. Locking, unlocking and finding your place again between every set was the single most annoying thing about logging on a phone. The screen now stays lit for as long as a workout is running and lets go the moment you finish it, so nothing is held while you are not training.
- It survives a tab switch. Browsers release the lock whenever the page stops being visible, which is exactly what happens when you glance at a message. The lock is taken again each time the app comes back, rather than dying the first time you look away.
- It follows the workout, not the screen you are on. Checking Stats mid-session keeps the screen awake.
- Where it isn't available, it says so. iOS grants no wake lock in Low Power Mode, and older browsers have no Wake Lock API at all — the first is silent, the second shows the row disabled rather than offering a switch that does nothing. Needs HTTPS, like every other modern browser capability.
Rest timer: take 15 seconds off, too
- A −15s button next to +15s. The timer could only ever be extended or skipped outright; now it goes both ways. Taking off more than is left finishes the rest rather than counting into the negative — the same thing Skip does.
- Rearranged so three controls fit. The clock and the progress bar take the top row and the controls sit underneath: −15 and +15 together in number-line order, Skip pushed to the far edge so the button that ends the rest is not next to the one you tap to buy more time. On a wide screen it stays on one line. Tap targets are bigger than they were.
- The bar is nearly opaque. The set rows underneath were reading through it and making the clock hard to pick out.
Settings, grouped by what it affects
- General (language, units) · During a workout (rest timer, keep screen awake, sounds, effort per set) · Notifications · Appearance (theme, body diagram, accent) · Data.
- The old grouping mixed axes: "Units & timer" put a display preference next to two workout behaviours, language sat under Appearance, and Load starter plan was buried between the backup actions and the destructive reset. Data now reads in the order you would use it — fill the plan, bring history over from another app, restore a backup, export one, wipe everything.
- Nothing was removed and no setting changed its meaning.
Effort per set: RIR or RPE (#21)
- A third column on a working set, off by default. Settings → Effort per set switches it between Off, RIR and RPE. It only appears on weighted rep sets: a plank or a treadmill row has nowhere to put it.
- Two names for the same judgement. RIR counts the reps you left in the tank; RPE reads the same effort off a 10-point scale, so RPE ≈ 10 − RIR. The setting has an (i) that lays the two scales side by side in a conversion table rather than explaining them in a paragraph.
- Each set keeps the scale it was logged with. Switching the setting changes what new sets ask for and nothing else — history is never silently rewritten, and a set logged as RIR 2 still reads back as RIR 2 years later.
- An unrated set stays unrated. Blank and 0 are different things: RIR 0 says the set went to
failure. So
−on an untouched cell leaves it empty,+starts at the bottom of the scale and walks up in even steps, and stepping back off the bottom clears the cell again — a mistap is always undoable. - Nothing else reads the value. Progression rules and estimated 1RM are unaffected; the rating is yours to look at, not an input to the maths.
- Upgrading keeps the column you had: a profile still carrying the old
showRirflag — from this device, a sync, or a backup restored later — comes across as RIR.
Import brings your ratings with it
- The RPE Hevy and Strong export is no longer dropped. An
RPEcolumn is read into the set, as is anRIRcolumn if a file has one, and the import summary says how many sets arrived with a rating — plus where to switch the column on if it's off. - A blank cell stays unrated rather than becoming 0. A written-out
0counts as a rating on the RIR scale (a set to failure) but not on RPE, which starts at 1 — apps write 0 there to mean "nothing here", and reading it as an effort would stamp one on every unrated set in the file. - Ratings above the scale are capped instead of thrown away, and junk in the column is ignored without losing the set.
- Backups already carried both fields and the setting, since a backup is the whole state — there are now tests pinning that, so it can't quietly stop being true.
v1.2.2 (2026-07-25)
Training that moves on its own: an exercise can now be logged by time instead of reps, the next weight follows a progression rule you choose rather than a single hard-coded hint, and every lift carries an estimated 1RM. Plus a standalone mobile app, a shareable plan, and an importer for your history from other apps.
Timed sets and a timer for the set itself (#16)
- Reps or time, per exercise. Planks, hangs, wall sits, dead hangs and loaded carries no longer have to be filed under cardio to be timed. Each exercise in a routine picks its own mode, and a timed set can still carry weight for a weighted plank or a farmer's walk.
- ▶️ A work timer, separate from the rest timer. Start a timed set and it counts the hold down, beeping and buzzing at zero exactly as the rest timer does, then checks the set off itself. The two timers can never run at once — they mean opposite things.
- Finishing a hold early logs the time you actually held, not the target. A 38-second hold against a 45-second target is recorded as 38 seconds.
- The mode travels everywhere it should: routine editor, workout, history, exercise statistics (timed exercises chart their longest hold), the printable plan and the shared plan file.
- Plans made before this release are read exactly as they always were — nothing to migrate.
Progression rules you can read (#17)
- Pick a rule per routine, override it per exercise. Linear progression, Greyskull LP (two straight sets plus an AMRAP final set, with double jumps and a 10 % reset), double progression through a rep range, or adding time for timed work. Or none at all.
- Every target explains itself. "Every rep last time — 2.5 kg more." "Missed reps 3 sessions running — reset to 55 kg and work back up." The rule is visible before you train, not after.
- The session opens with the right weights already in the rows, instead of suggesting them once you are standing at the bar.
- A bad session can't look like a good one. Short reps count as a miss even when you checked the set off; a set you never checked counts as a miss because you did not do it. Nothing advances the load on a session that fell apart.
- Stalls and deloads are worked out from your log every time they are needed. Nothing is written back into a finished workout and no counters are stored, so fixing a mistyped set immediately produces the right next target.
- Lower-body lifts step up in larger jumps than upper-body ones by default, and any exercise can set its own step.
- Bodyweight exercises progress in reps, because there is no load to add to a push-up and no load to take off it either.
Estimated 1RM (#18)
- An estimated one-rep max for every lift, in the exercise progress card (with its own curve you can switch to) and in the exercise detail sheet.
- It always names the set it came from — "from 90 kg × 5 on 15 Jul" — because an estimate off a heavy triple and one off a set of ten are very different claims.
- A calculator for a set you have not done yet, so the number is reachable before there is any history.
- Epley by default, and it refuses to guess above 12 reps, where the common formulas disagree by double digits.
- A new best estimate is reported at the end of a workout separately from a weight PR — same weight for more reps is real progress, but it is not a heavier lift.
Share a plan
- Send someone your plan. Plan → Share your plan writes a small file with your routines, the week schedule and any custom exercises they use — and nothing else. No workouts, no weigh-ins, no settings.
- Importing merges: shared routines arrive as new ones with fresh ids, custom exercises are matched by name so they are not duplicated, and your own plan is never overwritten. Taking the week schedule with it is optional.
- A printable plan (Save as PDF) laid out so a single exercise never breaks across a page.
Fixes
- A shared plan file naming an exercise this build doesn't have can no longer take the app down. Unknown ids are dropped on import, anything that slips through renders as a placeholder you can delete, and an error boundary around the screens means a bad state is recoverable by switching tabs instead of reloading.
- Importing from another app converts weights per row, not per file. FitNotes writes the unit on each set, so a mixed export used to land 185 lb as 185 kg.
- Numbers follow the UI language instead of a hardcoded locale, which was putting Swiss apostrophes ("7'535 kg") in front of everyone. Volume stays in your own unit rather than switching to tonnes, which was wrong for pound profiles.
- Taking over a week schedule from a shared plan now really replaces Monday–Sunday instead of only the days the shared file happened to fill.
- The body-weight slider's ceiling follows your unit (300 kg / 660 lb).
- "Best: 85 Kg" is capitalised correctly again.
One codebase, two flavors
openGym is also a standalone mobile app — and it ships as a direct APK download, not through app stores.
Standalone mobile app. The same frontend now also builds as a native iPhone / Android app (Capacitor) — the install-and-done flavor of openGym: no account, no server, no sync. Everything stays on the phone.
- State is mirrored into a file in the app's private storage on every change, so your log survives even when the OS evicts WebView storage (iOS does).
- The workout-day reminder becomes a native notification scheduled on the weekdays your plan actually has a routine — no push server involved.
- Backups go out through the OS share sheet (Files, AirDrop, mail…).
- Exercise images/animations load from the same CDN as the live demo.
npm run build:mobile, then openandroid/in Android Studio orios/in Xcode — see docs/MOBILE.md.NOTICE.mdnow carries an AGPL §7 app-store exception.
Android APK, no Play Store. The official build is a signed, sideloadable APK (~4.5 MB) from opengym.duarte-santos.ch — deliberately store-free. docs/MOBILE.md covers building and signing your own.
iOS reality check. Apple permits no installs outside the App Store, so there is no iOS download; the docs explain the free options (self-hosted PWA on the home screen, or running the native app onto your own iPhone from Xcode).
Import your history from another app. Settings → Data → Import from another app reads an export from FitNotes (both the Android and the FitNotes 2 iOS format), Strong and Hevy, and pulls body-weight history out of an Apple Health export. Anything else with a date, an exercise name and weight/reps columns is read too.
- Every row becomes a set, grouped into workouts by date, so your history arrives with its real dates rather than as one lump. Hevy and Strong also carry session length, so the activity heatmap fills in properly.
- Exercise names are matched against the 1,324-exercise library — parenthetical qualifiers like "(Barbell)" and shorthand like BB/DB are normalised, and a curated table covers the plain names people actually log ("Bench Press", "Squat", "RDL"). Where a name is genuinely ambiguous it is not guessed at: it becomes one of your own exercises instead, because filing years of training under the wrong lift is worse than an unmatched name you can see and fix.
- A summary shows what will happen — workouts, sets, how many exercises matched, which ones didn't, and whether weights need converting — before anything is written.
- Importing is idempotent: days you already have data for are left alone, so running it twice, or importing from two apps, never duplicates a workout.
v1.2.1 (2026-07-23)
A muscle map across the app, and a live demo you can try without installing anything.
- Muscle map. Three places now show which muscles your training actually reaches, drawn on a
front-and-back body diagram shaded like the activity heatmap — more accent means more work.
- Stats → Muscle balance aggregates a week, 30 days, 90 days or everything, lists your hardest-worked muscles with their set counts, and names the ones that got nothing in that period. That last list is the point of the card: the gaps are what you'd otherwise never notice. Tap any muscle to read its name and volume.
- Routine editor previews what a session hits as you build it, so a hole in the plan shows up before you train around it for a month.
- The finish screen shows what you just trained.
- Load is counted in effective sets — a set counts fully for the exercise's target muscle and partially for its supporting ones — not in kilograms, because 100 kg of leg press and 12 kg of lateral raise say nothing about which muscle worked harder. Shading is relative within the period you're looking at, so the map always reads as a balance rather than an absolute.
- Settings → Appearance → Body diagram switches between a male and female figure.
- The exercise dataset spells muscles inconsistently ("delts", "deltoids" and "shoulders" are one muscle); all 50 spellings it uses are normalised onto the 18 the diagram can draw. Custom exercises, which only carry a body part, fall back to it. The geometry is ~90 kB and loads on demand, so the initial bundle is unchanged.
- Fixed: finishing a workout from its last exercise could blank the whole app. The per-exercise weight sheet read the running workout without checking it was still there, and finishing clears it while that sheet is still on screen.
- ▶️ Live demo at duartesantos8.github.io/openGym —
a browser-only build (
VITE_DEMO=1) published to GitHub Pages on every push tomain. It boots into guest mode with a seeded example profile (12 weeks of Push/Pull/Legs, weigh-ins, PRs) so every screen has something to show, and it never talks to a server. Passkeys, sync and the admin dashboard stay exclusive to self-hosted instances, which is where the backend lives. - Builds can point the exercise media elsewhere via
VITE_IMG_BASE/VITE_GIF_BASE— the demo serves the ~140 MB dataset from a CDN instead of shipping it. The default (img/andgif/next to the app) is unchanged.
v1.2.0 (2026-07-23)
A complete visual redesign. Same app, same data — every screen redrawn.
A designed interface, not an assembled one
- Rebuilt design system. One type scale carrying hierarchy through size instead of making everything bold, a neutral surface ramp instead of saturated blue-greys, hairline separators instead of outlined boxes, and motion that acknowledges a press rather than animating for decoration. Light and dark are both first-class, and the eight accent colours now pick their label colour by measured contrast — the default green in light mode was failing WCAG AA on every primary button before.
- A hand-drawn icon set (77 icons, single stroke weight, drawn on one 24×24 grid) replaces every emoji in the interface. Emoji render differently on each platform, sit on their own baseline and can't take a theme colour, which is what made the old UI feel stitched together. Icons inherit the surrounding text colour and optical size.
- Routine icons. Picking an icon for a routine now offers a grouped set — strength, equipment, cardio, recovery — instead of an emoji keyboard. Routines you already made keep their look: the old emoji are mapped forward automatically, so nothing to migrate and nothing to redo.
- ▶️ New tab bar with a raised Start button that turns into a pulsing orange Resume while a workout is running.
- Home reads as a plan for today — week strip, today's session as one tappable row, body weight, and your streak.
Charts
- Axis labels, gridlines and the target-weight line are visible again in dark mode. They were painted with colour variables that no longer existed, which silently fell back to black on black — and to no stroke at all for the lines.
- The hover readout stays on screen. It used to be positioned with a fixed offset that assumed one label width, so the first and last point pushed it under the chart's clip; it's now placed from its measured size and kept inside the frame, dropping below the point when the point sits high enough that the label would cover the value it reports.
- It also goes away again — moving off the chart now clears the readout, crosshair and marker, which previously stayed until you hovered somewhere else.
v1.1.3 (2026-07-22)
Admin dashboard for self-hosters (opt-in — off by default), equipment filtering, and workout-screen fixes.
Admin dashboard
- Admin dashboard (Settings → Admin dashboard) for whoever runs the instance: a users overview with workout counts and last-active times, plus a per-user drill-down into their full workout history and body-weight log.
- Live "training now" — see who's mid-workout in real time, with their current exercise and set progress, updated by a lightweight heartbeat while a workout is on screen.
- Disable / enable accounts — a disabled account is signed out and locked out everywhere until you re-enable it.
- Invite-only signup (optional) — require an invite code to create a profile; generate and revoke codes from the dashboard. Existing accounts are unaffected.
- Configured via environment:
ADMIN_UIDS(comma-separated user ids who are admins) andINVITE_ONLY=1; both default off, so a fresh instance stays open with no admin. See.env.example. Admin access is gated by your passkey and enforced server-side.
Exercises & workout
- Filter exercises by equipment (#6). A second filter row under the body parts lets you narrow the list to what you actually have — body weight, dumbbell, barbell, cable, band, and so on — in both the Exercises library and the exercise picker. The options adapt to what you've already selected and are ordered by how many exercises use them, so every combination on screen has results behind it and the row stays short. Building a bodyweight-only plan is now two taps per body part.
- Minimize the exercise animation during a workout (#12). A ⤡ Minimize / ⤢ Expand button on the animation shrinks it to a thin strip so the set rows sit right under your thumb — no more scrolling past a big GIF to tick off a set. Your choice is remembered and applied to every exercise and future workout until you change it, so you set it once. Tapping the animation still pauses/plays it as before.
- Fixed: the rest timer froze at 0:01 (#14) instead of counting down to the end. It also meant the timer could only be cleared with Skip, and a redundant "rest over" push notification could still fire.
v1.1.2 (2026-07-22)
Custom exercises, full localization, and input fixes.
Custom exercises (#11)
- Create your own exercise from the exercise picker or the Exercises tab: a name and a body part is all it takes. Your search text is pre-filled as the name, so "no match" flows straight into "create it".
- Optional description — setup, cues, anything you want to remember. It shows on the exercise's detail and config sheets (where a built-in exercise would show its animation), and it's searchable, so you can find your own exercises by their cues too.
- Custom exercises behave like built-in ones everywhere — routines, supersets, workout logging, weight suggestions, PRs, stats and history. The animation stays blank by design.
- Pick the cardio body part and it logs time + speed instead of weight × reps, like the built-in cardio exercises.
- Edit (rename, change body part or description) or delete your custom exercises — from their detail sheet in the Exercises tab, or straight from the exercise inside a routine via "Edit or delete this exercise". Deleting removes them from your routines; already-logged workouts keep their sets and still show the exercise name. (The routine sheet's old "Remove exercise" button is now labelled "Remove from routine", so the two are no longer confusable.)
Localization (#7)
- 12 UI languages: English, Deutsch, Español, Français, Italiano, Português, Polski, Türkçe, Русский, 中文, 한국어, हिन्दी. Pick yours under Settings → Appearance → Language; the choice syncs with your profile like the theme does.
- Localized exercise instructions for 10 of those languages (all except German and Portuguese, which the upstream dataset doesn't cover yet — those fall back to English), covering all 1,324 exercises. Body-part filters, equipment and muscle tags are translated too; exercise names stay English (upstream limitation). Custom exercises are translated too.
- Dates, weekday and month labels follow the selected language.
- Zero cost when unused: the app still ships English-only by default. Each UI language is a ~7 kB chunk and each instruction pack ~80–120 kB (gzipped), downloaded only when you switch — the initial bundle size is unchanged.
- New
scripts/build-instructions.mjsregenerates the instruction packs from the upstream dataset; translations live infrontend/src/locales/(PRs welcome — it's one flat English-string → translation map per language). - Known gaps: push notification texts (sent by the server) and plural forms in some languages are approximated; happy to take corrections from native speakers.
Fixes
- ⌨️ Weight and other numeric fields now accept a comma as decimal separator ("33,5") — iOS decimal keyboards in many locales only offer a comma, which previously reset the field to 0. Partial input like "33," no longer snaps to 0 while typing. (#13)
- Fixed the exercise-config sheet (Sets / Reps / Weight, and the cardio variant) overflowing the screen edge on narrow phones — the Weight stepper was clipped and could make the whole page pan sideways in iOS Safari. Steppers now shrink to fit the viewport. (#10)
- Added a global horizontal-overflow guard so a single too-wide element can no longer knock the page layout off-scale.
v1.1.1 (2026-07-21)
Reliability fixes for the push notifications shipped in v1.1.0, found through live testing:
- Workout day reminder now fires by each user's own browser-detected timezone instead of a single server-wide one — works correctly regardless of where the server runs, and follows you automatically if you travel.
- Settings changes (like the reminder time) are flushed to the server immediately when the tab backgrounds or closes, instead of relying solely on a 1.5s debounce that could get cut short.
- Reminder check tightened from a 60s to a 10s interval, and pushes are now marked
urgency: 'high'— cuts avoidable delay on top of it, though delivery time is ultimately up to Apple/Google's push relay. - Push send failures are now logged instead of silently swallowed.
v1.1.0 (2026-07-21)
- Prebuilt Docker images published to
ghcr.io/duartesantos8/opengym-{api,web}(amd64 + arm64) via GitHub Actions, so self-hosting no longer requires building from source.docker compose pullgrabs them;docker compose up -d --buildstill builds locally if you'd rather. - Push notifications: rest-timer-over alert (fires even if the app is closed) and an optional
daily reminder on days you have a workout planned but haven't logged one yet. Opt in per-profile
in Settings — requires a signed-in passkey profile. Backend gains one dependency (
web-push); VAPID keys are generated on first run. - Fixed the rest timer stalling when the tab/app is backgrounded — it's now anchored to a real timestamp instead of a plain per-second counter, so it stays accurate after you come back.
v1.0.0 (2026-07-20)
First public release. A complete, self-hostable gym & body-weight tracker.
Highlights
- Body-weight tracking with an interactive chart + goal line
- Weekly routine planner over 1,324 exercises with animated demos
- ▶️ Guided workouts: body-weight check-in, pre-filled weights, rest timer, PR detection, per-exercise weight tracking
- Supersets and cardio (time + speed) logging
- Per-day rescheduling without touching your weekly plan
- GitHub-style activity heatmap (by time trained)
- Passkey (WebAuthn) login with per-profile data that syncs across devices
- Light/dark themes + 8 accent colors, synced to your profile
- JSON export/import, guest mode, PWA install, no telemetry
Stack
- React 19 + Vite (React Router, Zustand)
- Node backend, no framework, single dependency (
@simplewebauthn/server), JSON-file storage - nginx + multi-stage Docker so
docker compose upbuilds and serves everything
Notes
- Exercise media (~140 MB) is fetched from hasaneyldrm/exercises-dataset on first run.
- Licensed under GNU AGPL v3.0.