# Strava massexport

lotc kan läsa dina aktiviteter från ett **Strava-kontoarkiv** (ZIP eller extraherad mapp) i stället för inbyggd exempeldata.

## Ladda upp i webbläsaren

På **startsidan** kan du välja Stravas **ZIP-fil** (fältet ”Ladda upp Strava-arkiv”). Filen sparas lokalt som `data/strava_upload.zip` och har **högre prioritet** än miljövariabeln `STRAVA_EXPORT_DIR`. Du kan **ta bort** den uppladdade filen med knappen på sidan och då används exempeldata igen (om ingen env-sökväg är satt).

Stora arkiv kan ta lång tid att ladda upp – vänta tills bekräftelsen visas.

Officiella steg från Strava:

- [Exporting your Data and Bulk Export](https://support.strava.com/hc/en-us/articles/216918437-Exporting-your-Data-and-Bulk-Export)

Kort version:

1. På **Strava.com**, öppna **Settings** (profilmeny) sedan **My Account** (eller **Privacy Controls** beroende på gränssnitt).
2. Under **Download or Delete Your Account**, se **Download Request** och klicka **Request Your Archive**.
3. Vänta på e-post (kan ta några timmar), ladda sedan ner ZIP-filen.
4. Extrahera ZIP till en mapp eller behåll `.zip`-filen som den är.

## Vad arkivet innehåller

Vanligtvis:

- `activities.csv` – sammanfattning per aktivitet (distans, tid, typ m.m.)
- `activities/` – originalfiler (ofta `.gpx`, `.fit` eller `.tcx`) som matchar exporten

Appen läser `activities.csv`, kopplar varje rad till en fil under `activities/` och ritar GPS-spår på kartan.

## Konfigurera via miljövariabel (alternativ)

Utan webuppladdning: sätt **en** av dessa miljövariabler till **sökvägen till den extraherade mappen** eller **till `.zip`-filen**:

| Variabel | Exempel (bash) |
|----------|----------------|
| `STRAVA_EXPORT_DIR` | `export STRAVA_EXPORT_DIR=/data/strava_export` |
| `LOTC_STRAVA_EXPORT` | Samma beteende (alternativt namn) |

Valfritt: begränsa hur många **senaste** aktiviteter som laddas:

| Variabel | Betydelse |
|----------|-----------|
| `STRAVA_EXPORT_MAX` | Max antal aktiviteter (nyast först), t.ex. `200`. Om den inte är satt används **500**. Sätt **0** för ingen gräns (stora exporter kan bli långsamma). |

Starta sedan servern från projektmappen:

```bash
cd /sökväg/till/lotc
export STRAVA_EXPORT_DIR=/sökväg/till/export_123456789.zip
./.venv/bin/python -m uvicorn app.main:app --reload --host 127.0.0.1 --port 8765
```

Om variabeln inte är satt eller sökvägen saknas faller appen tillbaka till **exempeldata**.

## Tips

- Strava rekommenderar **originalfiler** när det går; GPX/FIT/TCX stöds för kartlinjer.
- Aktiviteter **utan GPS** kan få tom kartlinje men visas i listan om `activities.csv` har mätvärden.
- Om inget laddas: kontrollera att `activities.csv` ligger i arkivets rot och att filer i `activities/` stämmer med kolumnen `filename` eller aktivitetens `id` i CSV.

Samma text finns i webbläsaren under `/docs/strava` medan appen kör.