- Python 80.2%
- Vue 16.9%
- JavaScript 2.1%
- TypeScript 0.5%
47a8fa476b
## What does this PR do? Adds support for Garmin Connect China (`connect.garmin.cn`) accounts. Users can now check a "China account" option when linking their Garmin account, which instructs the `garminconnect` library to use the China-specific endpoints for both initial authentication and all subsequent data fetches (activities, health, gear). The `is_cn` flag is persisted in the encrypted token stored per user, so the correct regional endpoint is used automatically on every sync, no re-linking needed after the initial setup. ## Related issue Closes #722 ## Type of change - [ ] Bug fix - [x] New feature (exception during freeze; link prior discussion/acknowledgment) - [ ] Documentation - [ ] Refactor / code quality - [ ] Translation - [ ] Other (describe below) > Acknowledged by maintainer in [#722](https://codeberg.org/endurain-project/endurain/issues/722) prior to implementation. ## Checklist - [x] This PR is focused on a single concern - [x] An issue was opened and acknowledged before writing this code (if not a small fix) - [x] If this PR introduces a new feature during freeze, it was discussed and explicitly acknowledged first - [x] The PR is under ~300 lines changed, excluding lock files, migrations, and generated code - [ ] Tests have been added or updated where applicable - [ ] Documentation has been updated where applicable - [x] Commit messages follow Conventional Commits format ## Notes for the reviewer - The `garminconnect` library already supports `is_cn` via a constructor parameter, no new dependency required. - `is_cn` defaults to `False`, so all existing linked accounts continue to work without re-linking. - The flag is stored alongside the encrypted token dict in the DB column, making it transparent to the rest of the data flow. - All 13 locale i18n files were updated with a translated label for the new checkbox. Co-authored-by: hugobatista <hugobatista@noreply.codeberg.org> Co-authored-by: emon <emon@masto.top> Reviewed-on: https://codeberg.org/endurain-project/endurain/pulls/731 |
||
|---|---|---|
| .forgejo | ||
| .github | ||
| aux_scripts | ||
| backend | ||
| docker | ||
| docs | ||
| frontend/app | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| docker-compose.yml-multiple-backends.example | ||
| docker-compose.yml.example | ||
| docker-compose.yml.secrets.example | ||
| LICENSE | ||
| mkdocs.yml | ||
| README.md | ||
| renovate.json | ||
| ROADMAP.md | ||
| screenshot_01.png | ||
| SECURITY.md | ||
| TRADEMARK.md | ||
Note
GitHub Mirror - If you are viewing this on GitHub, please be aware that this repository is a read-only mirror. Issues, pull requests, and all project activity are tracked on Codeberg: https://codeberg.org/endurain-project/endurain
Note
Endurain is on a temporary feature freeze - The project is not paused. The focus is shifting from new features to strengthening the foundations. More details here
Endurain
A self-hosted fitness tracking service
Visit Endurain's Mastodon profile and Discord server.
🚀 Try the Demo
Experience Endurain without installation:
Demo URL: https://demo.endurain.com
- Username:
admin - Password:
admin - Reset Schedule: Daily at midnight (Europe/Lisbon timezone)
⚠️ Note: The demo environment resets every day. Do not store important data.
Table of Contents
- Endurain documentation
- What is Endurain?
- Endurain screenshots
- Sponsors
- Contributing
- Help Translate
- License
What is Endurain?
Endurain is a self-hosted fitness tracking service designed to give users full control over their data and hosting environment. It's similar to Strava but focused on privacy and customization. Built with:
- Frontend: Vue.js, Notivue and Bootstrap CSS
- Backend: Python FastAPI, Alembic, SQLAlchemy, Apprise, stravalib and python-garminconnect for Strava and Garmin Connect integration, gpxpy, tcxreader and fitdecode for .gpx, .tcx and .fit file import respectively
- Database: PostgreSQL for efficient data management
- Observability: Jaeger for basic tracing and monitoring
- Integrations: Supports Strava and Garmin Connect. Manual upload of activities using .gpx, .tcx and .fit files are also supported
To deploy Endurain, a Docker image is available, and a comprehensive example can be found in the "docker-compose.yml.example" file provided. Configuration is facilitated through environment variables, ensuring flexibility and ease of customization.
For more information please see the Endurain's documentation.
Sponsors
A huge thank you to the project sponsors! Your support helps keep this project going.
Support Endurain's development on:
Contributing
Contributions are welcomed! Please open an issue to discuss any changes or improvements before submitting a PR. Check out the Contributing Guidelines for more details.
Help Translate
Endurain has multi-language support, and you can help translate it into more languages via Codeberg Translate.
License
This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.
Trademark Notice
Endurain® is a trademark of João Vitória Silva.
You are welcome to self-host Endurain and use the name and logo, including for personal, educational, research, or community (non-commercial) use.
Commercial use of the Endurain name or logos (such as offering paid hosting, products, or services) is not permitted without prior written permission.
See TRADEMARK.md for full details.