wger is a free, open-source flutter application that manages and tracks/logs your exercises and personal workouts, weight, and diet plans. This is the mobile app written with Flutter, it talks via REST with the main server.
If you want to contribute, hop on the Discord server and say hi!
Install the wger server, the easiest way is to start the development docker-compose: https://github.com/wger-project/docker
Alternatively, you can use the test server (the db is reset every day):
- URL:
https://wger-master.rge.uber.space
- username:
user
- password:
flutteruser
- API key:
31e2ea0322c07b9df583a9b6d1e794f7139e78d4
Install Flutter and all its dependencies, and create a new virtual device: https://flutter.dev/docs/get-started/install.
The app currently uses flutter 3.19
The application will complain about an API key not being set. You can just ignore this during development, this is only important if you want to register directly over the app. If you just want to login, you can skip this section.
If you want to register directly over the app, you need to set a user on the backend
that is allowed to do this. For this, create/register a new user, generate an api key
and run python3 manage.py add-user-rest theusername
(you can later list all the
registered users with python3 manage.py list-users-api
).
Then create a new file wger.properties
in fastlane/metadata/envfiles/
and
add the key:
WGER_API_KEY=123456
Alternatively, add the key as an environment variables, e.g. by running the source
command on the file.
Start the application with flutter run
or use your IDE
(please note that depending on how you run your emulator you will need to change the IP address of
the server)
You can run the tests with the flutter test
Translate the app to your language on Weblate.
Feel free to get in touch if you found this useful or if something didn't behave as 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/flutter/issues
- Mastodon: https://fosstodon.org/@wger
The application is licensed under the GNU Affero General Public License 3 or later (AGPL 3+) with an app store exception.
As additional permission under section 7, you are allowed to distribute the software through an app store, even if that store has restrictive terms and conditions that are incompatible with the AGPL, provided that the source is also available under the AGPL with or without this permission through a channel without those restrictive terms and conditions.
The initial exercise and ingredient data is licensed additionally under one of the Creative Commons licenses, see the individual exercises for more details.