Files
wger/README.md
Roland Geider c6710a2c52 Merge pull request #2102 from DidiNDexter/DidiNDexter-patch-2
Make app-store badges uniform in height
2025-10-29 15:13:16 +01:00

103 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# wger
<p align="center">
<img src="https://raw.githubusercontent.com/wger-project/wger/master/wger/core/static/images/logos/logo.png" width="100" height="100" alt="wger logo">
![AGPLv3 License](https://img.shields.io/badge/License-AGPLv3-blue.svg)
![Build Status](https://img.shields.io/github/actions/workflow/status/wger-project/wger/ci.yml?branch=master)
[![Coverage Status](https://coveralls.io/repos/github/wger-project/wger/badge.svg?branch=master)](https://coveralls.io/github/wger-project/wger?branch=master)
![Translation Status](https://hosted.weblate.org/widget/wger/svg-badge.svg)
</p>
wger (ˈɡɐ) is a free workout and fitness manager.
- 🏋️ **Custom Workout Routines** Create flexible routines with automatic weight progression rules.
- 📊 **Comprehensive Tracking** Track diet plans, body weight, and custom measurements.
- 🍽️ **Nutrition Management** Log your calories with a food database
from [Open Food Facts](https://openfoodfacts.org).
- 📸 **Progress Gallery** Upload and track your fitness progress with photos.
- 📚 **Exercise Wiki** Access and contribute to the built-in exercises.
- 📱 **Cross-Platform Apps** Available on
[Android](https://play.google.com/store/apps/details?id=de.wger.flutter),
[iOS](https://apps.apple.com/us/app/wger-workout-manager/id6502226792),
[F-Droid](https://f-droid.org/en/packages/de.wger.flutter/),
and [Flathub](https://flathub.org/apps/de.wger.flutter).
- 🐳 **Self-Hostable** Deploy easily with Docker for full control.
- 🌍 **Multilingual Support** Translated by the community via Weblate.
- 🔗 **Powerful API** REST API for third-party integrations or automations.
- 👥 **Multi-User Support** Includes basic gym management features.
- 🆓 **100% Free & Open Source** Licensed under AGPL-3.0 or later.
For a live system, visit: <https://wger.de>
<p align="center" style="line-height:0; margin:0; padding:0;">
<a href="https://play.google.com/store/apps/details?id=de.wger.flutter" target="_blank" style="text-decoration:none; border:none; outline:none;"><img src="https://raw.githubusercontent.com/wger-project/wger/master/wger/core/static/images/logos/play-store/badge.svg" alt="Get it on Google Play" height="50" style="margin-right:8px; vertical-align:middle; border:none; outline:none; display:inline-block;"></a>
<a href="https://apps.apple.com/us/app/wger-workout-manager/id6502226792" target="_blank" style="text-decoration:none; border:none; outline:none;"><img src="https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg" alt="Download on the App Store" height="64" style="margin-right:8px; vertical-align:middle; border:none; outline:none; display:inline-block; background:none;"></a>
<a href="https://f-droid.org/packages/de.wger.flutter/" target="_blank" style="text-decoration:none; border:none; outline:none;"><img src="https://raw.githubusercontent.com/wger-project/wger/master/wger/core/static/images/logos/fdroid/get-it-on.png" alt="Get it on F-Droid" height="50" style="margin-right:8px; vertical-align:middle; border:none; outline:none; display:inline-block; background:none;"></a>
<a href="https://flathub.org/apps/de.wger.flutter" target="_blank" style="text-decoration:none; border:none; outline:none;"><img src="https://raw.githubusercontent.com/wger-project/wger/master/wger/core/static/images/logos/flathub/black.svg" alt="Get it on Flathub" height="50" style="vertical-align:middle; border:none; outline:none; display:inline-block; background:none;"></a>
</p>
## Self-hosting
Hosting your own instance is basically just a `docker compose up -d` away. For
more detailed setup instructions take a look at the provided
[docker compose file](https://github.com/wger-project/docker) and the
[corresponding documentation](https://wger.readthedocs.io/en/latest/production/docker.html).
## Developing and contributing
Our goal is to build an awesome and flexible fitness and nutrition manager,
along with a comprehensive list of exercises and ingredients, all released
under a free license.
For this, wed love your help! Whether its code, translations, exercises or
reporting issues and ideas, check out our
[contribution guide](https://wger.readthedocs.io/en/latest/contributing.html)
to get started.
A huge thank you to everyone who has contributed so far! ❤️ See the full list
in [AUTHORS.md](AUTHORS.md).
## Documentation
Consult the online documentation at
* <https://wger.readthedocs.io>
for installation instructions, API documentation, development guidelines, and
other information
## 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>
* **Mastodon:** <https://fosstodon.org/@wger>
* **Issue tracker:** <https://github.com/wger-project/wger/issues>
## Sources
All the code and the content is available on github:
* <https://github.com/wger-project>
## Translation
Translate the app to your language on [Weblate](https://hosted.weblate.org/engage/wger/).
[![translation status](https://hosted.weblate.org/widgets/wger/-/multi-blue.svg)](https://hosted.weblate.org/engage/wger/)
## License
* Application Code: [AGPL-3.0-or-later](https://www.gnu.org/licenses/agpl-3.0.html)
* Exercise/Ingredient Data: Creative Commons (see individual entries)
* Documentation: [CC-BY-SA-4.0](https://creativecommons.org/licenses/by-sa/4.0/)