Skip to content

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.

v1.4.0: the new exercise database, the v1.3.11 and v1.3.12 rounds and the most-asked features

Duarte Santos9819c7beeb2d
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b7cd5340e..481868e68 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,30 +1,123 @@
# Changelog
-## Unreleased
+## v1.4.0 (unreleased)
+
+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. Plan it too: "Last set to failure"
- in an exercise's settings makes the final set an all-out one every session, and Greyskull
- switches it on for you. The "F" shows in history, the finish summary and Copy as text, and Hevy
- and CSV imports keep it.
-- **Triple progression** (#179): reps climb to the top of the range, then a set is added (one at a
- time, each climbing on its own), up to the most sets you allow. When every set sits at the top,
- the weight goes up and you start over at your first sets and reps. Pick it like any other rule
- in an exercise's settings and set "Sets up to". Misses repeat the same sets and reps, more reps
- than last time still counts as progress, and three real stalls deload you back to the start.
+ 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).
-**Languages**
+**During a workout**
-- 🇵🇱 **Polish exercise names**: all 1,324 of them, with the same switch to show the English name
- beside them or only the English name. Polish is the eighth language with translated exercise
- names.
-- **Polish reviewed end to end**: one word for a routine ("plan treningowy") and for a passkey
- ("klucz dostępu", as Apple and Google say it), the Coach is always "Trener", gender-neutral
- wording where the text assumed a man, and a dozen smaller fixes, among them a hint that pointed
- to a setting by the wrong name.
+- **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 `media` service 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)
diff --git a/api/openapi.yaml b/api/openapi.yaml
index 544377695..bcb737a78 100644
--- a/api/openapi.yaml
+++ b/api/openapi.yaml
@@ -6,7 +6,7 @@ openapi: 3.1.0
info:
title: openGym API
- version: 1.3.10
+ version: 1.4.0
summary: Passkey (WebAuthn) auth + per-user state storage for openGym
description: |
The backend of [openGym](https://opengym.ch), a free, open-source
diff --git a/api/package-lock.json b/api/package-lock.json
index 5e5d85a7f..b421c7e83 100644
--- a/api/package-lock.json
+++ b/api/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "gym-api",
- "version": "1.3.10",
+ "version": "1.4.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "gym-api",
- "version": "1.3.10",
+ "version": "1.4.0",
"license": "AGPL-3.0-or-later",
"dependencies": {
"@simplewebauthn/server": "^13.1.1",
diff --git a/api/package.json b/api/package.json
index dbb625e09..731c96ef8 100644
--- a/api/package.json
+++ b/api/package.json
@@ -1,6 +1,6 @@
{
"name": "gym-api",
- "version": "1.3.10",
+ "version": "1.4.0",
"private": true,
"type": "module",
"main": "server.js",
diff --git a/docs/SELF_HOSTING_KUBERNETES.md b/docs/SELF_HOSTING_KUBERNETES.md
index 76eac6340..3fede5c89 100644
--- a/docs/SELF_HOSTING_KUBERNETES.md
+++ b/docs/SELF_HOSTING_KUBERNETES.md
@@ -39,7 +39,7 @@ Notes:
Coach with an API key works on that same API image; the Claude and Codex sign-in providers
need the `coach` build target, which is not published — build it yourself (see
[AI_COACH.md](AI_COACH.md)).
-- The images are pinned to a release (`1.3.10`), the API and the web image always to the same
+- The images are pinned to a release (`1.4.0`), the API and the web image always to the same
one. To update, read the release notes, set the new version on both and apply again; pinning
to `latest` instead means a restarted pod can come back on a version you never chose.
- Coming from a version before 1.4.0: the `media-download` initContainer and the `opengym-media`
diff --git a/frontend/android/app/build.gradle b/frontend/android/app/build.gradle
index 830b0b334..88d78e6b1 100644
--- a/frontend/android/app/build.gradle
+++ b/frontend/android/app/build.gradle
@@ -7,8 +7,8 @@ android {
applicationId "ch.duartesantos.opengym"
minSdkVersion rootProject.ext.minSdkVersion
targetSdkVersion rootProject.ext.targetSdkVersion
- versionCode 24
- versionName "1.3.10"
+ versionCode 25
+ versionName "1.4.0"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
aaptOptions {
// Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.
diff --git a/frontend/package-lock.json b/frontend/package-lock.json
index ddd1ca9f8..7f75b7386 100644
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "opengym-frontend",
- "version": "1.3.10",
+ "version": "1.4.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "opengym-frontend",
- "version": "1.3.10",
+ "version": "1.4.0",
"license": "AGPL-3.0-or-later",
"dependencies": {
"@aparajita/capacitor-secure-storage": "^7.1.6",
diff --git a/frontend/package.json b/frontend/package.json
index 064dbd1e9..20c380861 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,7 +1,7 @@
{
"name": "opengym-frontend",
"private": true,
- "version": "1.3.10",
+ "version": "1.4.0",
"type": "module",
"scripts": {
"dev": "vite",
diff --git a/helm/Chart.yaml b/helm/Chart.yaml
index dd9b0ef5c..65bae78cd 100644
--- a/helm/Chart.yaml
+++ b/helm/Chart.yaml
@@ -15,10 +15,10 @@ type: application
# This is the chart version. This version number should be incremented each time you make changes
# to the chart and its templates, including the app version.
# Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 0.1.0
+version: 0.2.0
# This is the version number of the application being deployed. This version number should be
# incremented each time you make changes to the application. Versions are not expected to
# follow Semantic Versioning. They should reflect the version the application is using.
# It is recommended to use it with quotes.
-appVersion: "1.3.9"
+appVersion: "1.4.0"
diff --git a/helm/README.md b/helm/README.md
index 80874e5ca..03202d163 100644
--- a/helm/README.md
+++ b/helm/README.md
@@ -128,7 +128,7 @@ longer mounted, and since Helm keeps it, delete it by hand once the new pod runs
### Images
-`api.image.tag` and `web.image.tag` default to `1.3.9`. Change them together: an API and a web
+`api.image.tag` and `web.image.tag` default to `1.4.0`. Change them together: an API and a web
image from different releases aren't meant to run side by side.
### Other values
diff --git a/helm/values.yaml b/helm/values.yaml
index 70bb45939..5264f54c2 100644
--- a/helm/values.yaml
+++ b/helm/values.yaml
@@ -96,7 +96,7 @@ api:
image:
repository: ghcr.io/duartesantos8/opengym-api
pullPolicy: IfNotPresent
- tag: 1.3.9 # keep in step with web.image.tag
+ tag: 1.4.0 # keep in step with web.image.tag
service:
port: 3000
resources:
@@ -151,7 +151,7 @@ web:
image:
repository: ghcr.io/duartesantos8/opengym-web
pullPolicy: IfNotPresent
- tag: 1.3.9
+ tag: 1.4.0
service:
# The port nginx listens on inside the pod: NGINX_PORT and the container's `web` port, which
# the Service and the probes follow by name. Not the image's default 80: the image runs as
diff --git a/kubernetes/deployment.yaml b/kubernetes/deployment.yaml
index 4e5045965..e378cdf75 100644
--- a/kubernetes/deployment.yaml
+++ b/kubernetes/deployment.yaml
@@ -21,8 +21,8 @@ spec:
# Pin both images to one release and move them together: a tag names what you run and
# what you roll back to, where :latest changes under a pod whenever it is rescheduled.
# The API and the web image of one version belong together. The published tags are
- # the version (1.3.10) and its minor line (1.3); see the release notes before a bump.
- image: ghcr.io/duartesantos8/opengym-api:1.3.10
+ # the version (1.4.0) and its minor line (1.4); see the release notes before a bump.
+ image: ghcr.io/duartesantos8/opengym-api:1.4.0
imagePullPolicy: IfNotPresent
env:
- name: PORT
@@ -64,7 +64,7 @@ spec:
limits:
memory: 512Mi
- name: web
- image: ghcr.io/duartesantos8/opengym-web:1.3.10 # same version as the api container
+ image: ghcr.io/duartesantos8/opengym-web:1.4.0 # same version as the api container
imagePullPolicy: IfNotPresent
env:
# Not the image's default 80: the image runs as uid 101, which can bind a port below