wger-project/wger

Self hosted FLOSS fitness/workout, nutrition and weight tracker

wger

wger (ˈvɛɡɐ) Workout Manager is a free, open source web application that helps you manage your personal workouts, weight and diet plans and can also be used as a simple gym management utility. It offers a REST API as well, for easy integration with other projects and tools.

For a live system, refer to the project's site: https://wger.de/

Mobile app

Installation

These are the basic steps to install and run the application locally on a Linux system. There are more detailed instructions, other deployment options as well as an administration guide available at https://wger.readthedocs.io or in the docs repo.

Please consult the commands' help for further information and available parameters.

Production

If you want to host your own instance, take a look at the provided docker compose file. This config will persist your database and uploaded images:

https://github.com/wger-project/docker

Demo

If you just want to try it out:

    docker run -ti --name wger.demo --publish 8000:80 wger/demo

Then just open http://localhost:8000 and log in as admin, password adminadmin

Please note that this image will overwrite your data when you pull a new version, it is only intended as an easy to setup demo

Development version

We provide a docker file that sets everything up for development (however this won't persist any data)

docker run -ti  \
    -v /path/to/your/wger/checkout:/home/wger/src \
    --name wger.dev \
    --publish 8000:8000 \ 
    wger/server

Then just open http://localhost:8000 and log in as: admin, password adminadmin

For more info, check the README in wger/extras/developemt.

Alternatively you can use the production compose file for development as well, just bind your local source code into the web container (see the docker-compose.yml file for details). You will also probably want to set `DJANGO_DEBUG to false

Local installation

If you prefer a local installation, consult the development documentation

Contact

Feel free to contact us if you found this useful or if there was something that didn't behave as you expected. We can't fix what we don't know about, so please report liberally. If you're not sure if something is a bug or not, feel free to file a bug anyway.

• Discord: https://discord.gg/rPWFv6W
• Issue tracker: https://github.com/wger-project/wger/issues
• Mastodon: https://fosstodon.org/@wger

Sources

All the code and the content is available on github:

https://github.com/wger-project/wger

Translation

Translate the app to your language on Weblate.

License

The application is licensed under the Affero GNU General Public License 3 or later (AGPL 3+).

The initial exercise and ingredient data is licensed additionally under one of the Creative Commons licenses, see the individual exercises for more details.

The documentation is released under a CC-BY-SA: either version 4 of the License, or (at your option) any later version.

Some images were taken from Wikipedia, see the SOURCES file in their respective folders for more details.

wger's Issues

BMI calculator

Add a BMI calculator. The weight can be read from the weight app, the height can be saved in a new field in the user's profile. Render the result in this diagram or similar.

Rename functions

The views are now split up in different files, there is no need to have e.g. /set/edit_set(). These should be renamed to something like /set/edit()

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/1
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-19 21:51:53

Queue ajax requests in add set form

When changing the number of sets in the add set form, the ajax requests to get the formsets are fired immediately. This means that the second might finish before the first, changing randomly the order of the formsets, and that's ugly.

Cant't add custom exercise

After sending a new custom exercise I get the following message:

Unhandled Exception

An unhandled exception was thrown by the application.

Gym mode

There should be a "gym mode" for the workouts. Possible workflow:

• Start gym mode by pressing "start workout" or such
• Countdown warm-up
• Exercise 1, set 1
• Pause
• Exercise 1, set 2
• Pause
• ...
• Exercise 2, set 1
• Pause
• ...
• Workout done!

Features:

• Implement this mobile first, on a desktop this doesn't make as much sense. Everything is simple and big: buttons, text, etc.
• All countdowns are skippable and editable (+/- time)
• After the exercise (during pause?) it's possible to enter a weight log
• It should be always clear what to do and what comes next, with big obvious buttons ("skip" or "next")
• Weight logs are optional
• Exercises can be skipped or repeated
• It's possible to do/log more sets than saved in the workout

Optional:

• display some other info (% completed, time left, )
• personal records
• Plates calculator (probably a separate issue, if implemented use code from e.g. https://github.com/borisjoffe/squats)

Cleanup unneeded forms

Many forms are only defined so the corresponding exclude can be set. This is better done with a editable = False in the model.

Demo data for everything

The demo data should create sample data entries for everything, not only workouts and weights.

• Nutrition plans
• Schedules

Remove decimal places on the diet plan

The two decimal places make absolutely no sense here. This also seems to be related to the underlying database.

Swapped exercises in demo workout

Curls and crunches are swapped in the workout for demo users (at least in the German version)

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/10
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-25 12:05:41

Calories calculator broken when no weight entries exist

The calories calculator doesn't work when the user has no weight entries. In this case the system should create a new entry, as with the BMI calculator.

Test entries with non-ASCII text

Test the application entering everywhere non-ascii text, there are sill many places with "{0}".format(foobar) instead of u"{0}"...

Overview of user submitted exercises

Administrators should have an overview of user submitted exercises that are pending approval

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/13
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-30 00:41:28

Test if delete cascade works

Do some tests to see if django's delete cascade actually deletes all objects, and no entries get orphaned because the foreign key points the other way round

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/16
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-30 00:53:40

Migrations with postgreSQL

The migrations 0002 in exercises and 0007 in ingredients fail in postgres. The reason for this is that in PostgreSQL you must not update the table and then alter the table schema in one transaction.

Either

db.start_transaction()
if not db.dry_run:
    orm.Foo.objects.all().update(bar=baz)
db.commit_transaction()

or do two migrations, one for the table, one for data.

MultipleObjectsReturned in get_current_workout

Traceback (most recent call last):

  File "/home/rge/www/python-django/lib/python2.7/site-packages/django/core/handlers/base.py", line 115, in get_response
    response = callback(request, *callback_args, **callback_kwargs)

  File "/home/rge/www/python-django/lib/python2.7/site-packages/django/contrib/auth/decorators.py", line 25, in _wrapped_view
    return view_func(request, *args, **kwargs)

  File "/home/rge/www/wger-patched/wger/manager/views/misc.py", line 93, in dashboard
    (current_workout, schedule) = Schedule.objects.get_current_workout(request.user)

  File "/home/rge/www/wger-patched/wger/manager/models.py", line 117, in get_current_workout
    schedule = Schedule.objects.filter(user=user).get(is_active=True)

  File "/home/rge/www/python-django/lib/python2.7/site-packages/django/db/models/query.py", line 407, in get
    (self.model._meta.object_name, num))

MultipleObjectsReturned: get() returned more than one Schedule -- it returned 2!

Add creation date to ingredients

Ingredients should have at least a creation date. Better would be a last_updated field that displayed the changed made, plain text would be enough here (old value: "foo", new value "bar"):

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/15
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-30 00:51:10

Move JS to external file

There is currently a great amount of JS directly in the HTML pages, this becomes a bigger maintenance problem with the mobile version, that basically duplicates the templates. Clean this up and move it to the central JS file.

Use messages framework

Use the messages framework when the success of actions is not always obvious (editing and being redirected to an overview, etc.)

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/5
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-19 22:28:30

Automatically generate robots.txt

The links to the sitemaps in the different languages in robots.txt should be automatically generated

Adding exercise to workout from detail view

It should be possible to add an exercise to a workout from the exercise overview or its detail page. A simple pop-up where one can select the workout, day, etc. should be enough.

Test multiple DBs in travis

Related to #26 , travis should run the tests with mysql and postgresql as dbs

Calories wizard for nutritional plan

The nutritional plan should have some kind of "wizard" to calculate the basic caloric intake needed by allowing the user to fill in some fields (should be saved to the profile). This makes it much easier to adjust the plan (e.g. +300 kcal over maintenance).

• age
• gender
• type of work
• other activities
• hours of sleep

Check update path of pypi package

It's necessary to check the update path from a pip-installed 1.1.x application to 1.2.

Add an offline mode to the weight log page

The weight log page should accept entries while the browser is offline, store them in HTML5 Local Storage and send them to the DB when there is an available connection.

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/9
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-22 21:50:30

Search and user submitted exercises

User submitted exercises should not appear in the exercises overview or any search till they are approved

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/12
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-30 00:40:46

Wiki-style editing of exercises

Rather than just allowing submitting exercises, a wiki-style editing of all exercises by all registered users might be better. Investigate if it's feasible/makes sense.

https://github.com/benjaoming/django-wiki
https://github.com/etianen/django-reversion

Migration issue with current tastypie

The current version of tastypie, 0.10.0, has a nasty bug (https://github.com/toastdriven/django-tastypie/issues/1005) that makes the migrations fail with a

TypeError: Item in ``from list'' not a string

The last version is pinned now in the requirements, but should be updated when possible.

Use manager to filter by language

Use a manager to filter exercises and ingredients by languages. This is more elegant and will save us pain e.g. if/when users can select the languages for items from their preferences.

User submitted exercises

Have an option to add custom exercises, submitted by the users. After a review by someone with the appropriate rights, they are added to the general database.

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/7
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-20 21:04:13

Separate views for create and edit

Some of the old views handle the creation and the edit of objects at the same time. Separate them (probably everything that has a "\w*" in url.py)

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/4
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-19 21:58:58

Remove unneeded settings templates

Check if the templates in manager/templates/settings are used and delete them if not.

More granular control of translated exercises and ingredients

There should be a setting to allow a more granular control of translated exercises and settings. This is specially useful (even necessary) for languages that have not translated all exercises and ingredients: here it should be possible to select which exercises and ingredients are shown. E.g. for language X, show also items in English and language Y.

This should be language wide, but possibly also a user setting.

Mark user submitted exercises

On the exercise detail page, there should be some mark that it was user submitted. If we want to show the username, we need to change the way django_browserid creates them, the default is some kind of UUID.

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/14
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-30 00:43:15

Process for submitted exercises

When users submit an exercise:

• some feedback that inclusion is pending
• a flag is set on the new exercise
• administrator users get an email

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/11
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-30 00:39:41

Exercise descriptions in English

The exercises in English should also get descriptions, at least very roughtly. They should also get the primary and secundary muscle groups.

Complete support for equipment

You can add equipment when you create a new exercise, but this information is never used again.

The required equipment for an exercise should be:

• displayed on the website
• be accessible by REST-API

Add scheduling options

The workout manager should be aware of and manage some kind of scheduling options. The most basic would be if a user has a number of workouts that always follow each other (workouts A, B, C, A, B, etc.), but other possibilities should be possible too.

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/8
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-21 23:06:33

Email remainders

Add email remainders, e.g. "your workout/schedule will finish in X weeks". This should be configurable by the user.

Make the workout aware of planed weight

It should be possible to tell the workout about the planed weights for the different exercises. It should:

• keep track of increments by which the used weight should rise.
• know how and when to apply the increments (weight, date interval)
• be flexible enough to cope with a failure in one of the sets or a skipped workout

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/6
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-20 21:01:05

Weight units in German

The German ingredients list need weight units and should get expanded as much as possible.

Allow sensible filters for REST API

Allow sensible filtering of fields in the REST API, otherwise an error is raised:

http://django-tastypie.readthedocs.org/en/latest/resources.html#basic-filtering
http://stackoverflow.com/questions/12285364/field-does-not-allow-filtering-no-relation-used

Add a calendar overview

There should be a calendar overview where the workout logs are shown in a calendar view. It should also have additional links to directly add logs or view the logs for a day.

Incorrect filtering of weight logs

In the workout weight log, the entries are not correctly filtered: only the data for the current workout should be shown.

Update django_browserid

Update app django_browserid to 0.8 (API-Changes!)

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/2
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-19 21:55:15

Improve message for demo user

Now that there are no anonymous users, the banner for demo users should be shown everywhere, otherwise it's confusing why it appears on some pages and not in others. Also it should have a button to create demo data (doing it on the middleware is not performant)

Ordering of exercises in log form

The order of the exercises in the weight log form should be the same as in the workout.

Easier implementation of excersises

Would be great to have the possibility to put easier excersises by myself in the system.
I do a lot of my training with a weight west, bodyweight and TRX Band.
Simple bodyweight exercises like push-ups and arnold dips are not in this software.
Bear in mind that there are a lot of versions for squats etc.
Would be nice to have a small file that we could update over git for all and of course for ourself as an option in the excercise dialog.

Thanks in advance

Update name of application

In the GPL headers "Workout Manager" should be replaced with "wger Workout Manager" and the logger workout_manager.custom, renamed to wger.custom

Traceback when exporting weight to CSV

This probably happens because the translations for 'weight' and 'date' are not ASCII

Traceback (most recent call last):

  File "/home/rge/www/python-django/lib/python2.7/site-packages/django/core/handlers/base.py", line 115, in get_response
    response = callback(request, *callback_args, **callback_kwargs)

  File "/home/rge/www/python-django/lib/python2.7/site-packages/django/contrib/auth/decorators.py", line 25, in _wrapped_view
    return view_func(request, *args, **kwargs)

  File "/home/rge/www/wger-patched/wger/weight/views.py", line 117, in export_csv
    writer.writerow([_('Weight'), _('Date')])

UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-4: ordinal not in range(128)

Alternative PDF output

Make a PDF output that doesn't print a log table, but simply lists the workout structure as in the website.

---

• Bitbucket: https://bitbucket.org/rolandgeider/workout_manager/issue/3
• Originally Reported By: Roland Geider
• Originally Created At: 2013-03-19 21:56:24