Help
In order for ASync to retrieve Garmin activity information and transfer it to Strava, it must have access to these services.
To access Garmin, you must have an email and password for your Garmin account.
To access Strava, you must obtain a Strava Client ID and Strava Client Secret through the Strava API Application registration. This is a one-time and simple manual step. Follow these steps:
- In your internet browser, log in to Strava at https://www.strava.com/.
- Continue by registering for the Strava API Application at https://www.strava.com/settings/api.
-
Carefully enter the following information here:
Item Value Application Name ASync Category Other Club do not fill in Website https://async.somee.com/ Application Description do not fill in Authorization Callback Domain async.somee.com - Check "I've read and agree with Strava's API Agreement".
- Press Create
- Make a note of the Client ID number.
- Display the Client Secret value hidden behind the asterisks (it is a combination of 40 letters and numbers) using the show option next to it, select the value with the mouse, and use Copy to save it to the clipboard.
You are now ready to synchronize using ASync.
Item | Value |
---|---|
Garmin email | Garmin login email |
Garmin password | Garmin password |
Strava Client ID | Data obtained by registering the Strava API Application before the first synchronization |
Strava Client Secret | Data obtained by registering the Strava API Application before the first synchronization |
Update weight | Check if you want to transfer your weight from Garmin to Strava. |
Beginning of the period | The date from which the activities will be synchronized. |
End of period | The date until which the activities will be synchronized. |
Update name | Check if you want to transfer activity names from Garmin to Strava. |
Update description | Check if you want to transfer activity descriptions from Garmin to Strava. The transfer will only occur if the description in Garmin is filled in or if it differs from the description in Strava. |
Gears to description | Check if you want to add a list of gears used for the activity in Garmin to the end of the activity description in Strava. This option requires the previous option to be checked. |
Properties to description |
Enter the Garmin activity properties you want to add to the end of the activity description in Strava.
This option requires the "Update description" option to be checked.
Separate property names with semicolons.
Then an optional display name separated by an equal sign may be present.
Finally, you can optionally add the desired formatting separated by a colon.
For example, specifying Steps;AvgStrideLength=Stride:0 cm will add the number of steps and the average stride length displayed as "Stride" in whole centimeters.
For those interested, a list of all available activity properties in Garmin and a description of the formatting is provided.
The entry VO2MaxValue=VO₂ max:0 ml/kg\.min;AverageRunningCadenceInStepsPerMinute=Cadence:0;AvgStrideLength=Stride:0 cm;AvgGroundContactBalance=Contact balance:0.00 \%;AvgVerticalOscillation=Vertical oscillation:0.0 cm;AvgVerticalRatio=Vertical ratio:0.0 \%;AvgGroundContactTime=Ground contact time:0 ms;_FlightTime=Flight time:0 ms;_FlightRatio=Flight ratio:0.0 \%;AerobicTrainingEffect=Aerobic training effect:0.0;AnaerobicTrainingEffect=Anaerobic training effect:0.0;Steps adds a number of properties including calculated Flight Time and Flight Ratio properties that are not available from Garmin. |
Start Synchronization | Pressing this button starts the set ASync sync from Garmin to Strava. Depending on the status of your Strava login in your web browser, you may optionally be presented with a Strava login page. You will then still be asked by Strava to authorize ASync to access Strava. Here, press Authorize and the sync will start. You'll see its progress on a new page. |
Is it possible to sync photos from Garmin to Strava?
Unfortunately, Strava only allows you to change a limited set of activity properties.
Why the name ASync?
ASync is both an English abbreviation for "Activity Synchronization" and a powerful C# keyword, without which the ASync application could not have been created.
Synchronization of many activities ends with a Strava error. What is it?
Please note that Strava limits API usage to a maximum of 100 requests every 15 minutes, with up to 1,000 requests per day.
Is the source code available?
The synchronization code is available.
I got feedback, what about it?
Great, please provide it at async[at]email.cz.
Aby mohla aplikace ASync získat informace o aktivitách v Garmin a přenést je do Strava, musí mít do těchto služeb přístup.
Pro přístup do Garmin je třeba mít k dispozici email a heslo k vašemu Garmin účtu.
Pro přístup ke službě Strava je třeba získat tzv. Strava Client ID a Strava Client Secret prostřednictvím registrace Strava API Application. Jedná se o jednorázový a jednoduchý manuální krok. Postupujte následovně:
- Ve vašem internetové prohlížeči se přihlaste do služby Strava na stránce https://www.strava.com/.
- Pokračujte registrací Strava API Application https://www.strava.com/settings/api.
-
Zde pečlivě zadejte následující údaje:
Položka Hodnota Application Name ASync Category Other Club nevyplňujte Website https://async.somee.com/ Application Description nevyplňujte Authorization Callback Domain async.somee.com - Zašktněte "I've read and agree with Strava's API Agreement".
- Stiskněte Create
- Poznamenejte si číslo Client ID.
- Zobrazte za hvězdičkami skrytou hodnotu Client Secret (jde o kombinaci 40 písmen a čísel) pomocí vedle něj zobrazené volby show, hodnotu vyberte myší a pomocí Copy si ji uložte do schránky.
Nyní jste připraveni pro synchronizování pomocí ASync.
Položka | Hodnota |
---|---|
Garmin email | Přihlašovací email do Garmin |
Garmin password | Heslo do Garmin |
Strava Client ID | Údaj získaný registrací Strava API Application před první synchronizací |
Strava Client Secret | Údaj získaný registrací Strava API Application před první synchronizací |
Update weight | Zaškrtněte, pokud chcete přenést vaši hmotnost z Garmin do Strava. |
Beginning of the period | Datum, od kterého se budou aktivity synchronizovat. |
End of period | Datum, do kterého se budou aktivity synchronizovat. |
Update name | Zaškrtněte, pokud chcete přenést jména aktivit z Garmin do Strava. |
Update description | Zaškrtněte, pokud chcete přenést popis aktivit z Garmin do Strava. K přenosu dojde jen tehdy, pokud je popis v Garmin vyplněn nebo pokud se liší od popisu ve Strava. |
Gears to description | Zaškrtněte, pokud chcete na konec popisu aktivit ve Strava přidat seznam vybavení použitého u aktivity v Garmin. Tato volba vyžaduje zaškrtnutou předchozí volbu. |
Properties to description |
Zadejte vlastnosti aktivit v Garmin, které chcete přidat na konec popisu aktivity ve Strava.
Tato volba vyžaduje zaškrtnutou volbu „Update description“.
Názvy vlastností oddělujte středníky.
Dále může být uveden nepovinný zobrazovací název oddělený rovnítkem.
Nakonec můžete volitelně přidat požadované formátování oddělené dvojtečkou.
Například zadáním Steps;AvgStrideLength=Krok:0 cm přidáte počet kroků a průměrnou délku kroku zobrazenou jako "Krok" v celých centimetrech.
Pro zájemce je k dispozici seznam všech dostupných vlastností aktivit v Garmin a popis formátování.
Položka VO2MaxValue=VO₂ max:0 ml/kg\.min;AverageRunningCadenceInStepsPerMinute=Cadence:0;AvgStrideLength=Stride:0 cm;AvgGroundContactBalance=Contact balance:0.00 \%;AvgVerticalOscillation=Vertical oscillation:0.0 cm;AvgVerticalRatio=Vertical ratio:0.0 \%;AvgGroundContactTime=Ground contact time:0 ms;_FlightTime=Flight time:0 ms;_FlightRatio=Flight ratio:0.0 \%;AerobicTrainingEffect=Aerobic training effect:0.0;AnaerobicTrainingEffect=Anaerobic training effect:0.0;Steps přidá řadu vlastností včetně vypočtených vlastností Flight Time a Flight Ratio, které nejsou od Garmin k dispozici. |
Start Synchronization | Stisknutí tohoto tlačítka spustí nastavenou ASync synchronizaci z Garmin do Strava. V závislosti na stavu vašeho přihlášení do Strava v internetovém prohlížeči může být volitelně zobrazena stránka pro přihlášení do Strava. Následně budete ještě požádání službou Strava, abyste autorizovali ASync k přístupu do Strava. Zde stiskněte Authorize a synchronizace se spustí. Její průběh budete sledovat na nové stránce. |
Je možné synchronizovat fotografie z Garmin do Strava?
Bohužel Strava umožňuje změnit pouze omezenou množinu vlastností aktivity.
Proč název ASync?
ASync je jednak anglická zkratka „Activity Synchronization“ a jednak i mocné klíčové slovo jazyka C#, bez kterého by aplikace ASync nemohla vzniknout.
Synchronizace mnoha aktivit končí chybou Strava. O co jde?
Vezměte prosím na vědomí, že společnost Strava omezuje používání rozhraní API na maximálně 100 požadavků každých 15 minut a až 1 000 požadavků denně.
Je k dispozici zdrojový kód?
Kód synchronizace je k dispozici.
Mám zpětnou vazbu, co s ní?
Skvělé, poskytněte ji prosím na async[zavináč]email.cz.