michaellihs · July 26, 2025 19:45 · May 4, 2022 · May 4, 2022 · May 3, 2022 · May 3, 2022
diff --git a/strava_cli.md b/strava_cli.md
@@ -63,7 +63,7 @@ curl -X POST https://www.strava.com/api/v3/uploads \
 > To check the status of your update, use the `id` from the JSON response and run
 >
 > ```shell
-> curl https://www.strava.com/api/v3/uploads/ID -H "Authorization: Bearer ${STRAVA_ACCESS_TOKEN}"
+> curl https://www.strava.com/api/v3/uploads/ID -H "Authorization: Bearer OAUTH_TOKEN"
 > ```
 
 If you want to upload a directory with files, use the following command

diff --git a/strava_cli.md b/strava_cli.md
@@ -3,11 +3,10 @@ Upload GPS Tracks to Strava from your Command Line
 
 This short tutorial describes how to upload GPS tracks to Strava using your command line interface / shell. It requires no special tools or any 3rd party code.
 
-**Run all following steps with your user logged in to Strava in your browser!**
-
-
 ## 1. Generate an API Key
 
+> **Run the following steps with your user logged in to Strava in your browser!**
+
 Strava uses OAuth to authenticate against 3rd party applications. In order to authenticate to your Strava account from your command line, you first have to generate an API key. Therefore go to this page [https://strava.github.io/api/v3/oauth/](https://www.strava.com/settings/api) and create a new API. The settings are as follows:
 
 * `Application Name` chose whatever name you like (does not matter for our use case)
@@ -36,13 +35,13 @@ For the purpose of generating the OAuth token, this documentation helps a lot [h
    
 3. Click "Authorise"
 4. Cope the Code from the URL that is given as the URL `code` parameter
-5. Run the following CURL request, to get the final OAuth token:
+5. Run the following CURL request, to get the final OAuth token (replace `CLIENT_ID`, `CLIENT_SECRET` and `CODE` accordingly):
 
-    ```
+    ```shell
     curl -X POST https://www.strava.com/oauth/token \
-      -F client_id=12345 \
-      -F client_secret=... \
-      -F code=...
+      -F client_id=CLIENT_ID \
+      -F client_secret=CLIENT_SECRET \
+      -F code=CODE
     ```
 
 5. Copy the `access_token` from the JSON response - this is your OAuth token
@@ -69,9 +68,11 @@ curl -X POST https://www.strava.com/api/v3/uploads \
 
 If you want to upload a directory with files, use the following command
 
-    for i in `ls /path/to/files/*.tcx`
-      do curl -X POST https://www.strava.com/api/v3/uploads -H "Authorization: Bearer OAUTH_TOKEN" -F file=@"$i" -F data_type="tcx"
-    done
+```shell
+ for i in `ls /path/to/files/*.tcx`
+   do curl -X POST https://www.strava.com/api/v3/uploads -H "Authorization: Bearer OAUTH_TOKEN" -F file=@"$i" -F data_type="tcx"
+ done
+ ```
 
 
 ## Further References

diff --git a/strava_cli.md b/strava_cli.md
@@ -35,7 +35,7 @@ For the purpose of generating the OAuth token, this documentation helps a lot [h
    > make sure to properly quote the redirect URL
    
 3. Click "Authorise"
-4. Cope the Code from the URL that is given as the `code` parameter
+4. Cope the Code from the URL that is given as the URL `code` parameter
 5. Run the following CURL request, to get the final OAuth token:
 
     ```

diff --git a/strava_cli.md b/strava_cli.md
@@ -28,7 +28,9 @@ For the purpose of generating the OAuth token, this documentation helps a lot [h
 
 1. Open the following URL (replace `CLIENT_ID` with the ID from above): 
 
-   ```https://www.strava.com/oauth/authorize?client_id=CLIENT_ID&response_type=code&redirect_uri=http%3A%2F%2Flocalhost&scope=activity:write&state=mystate&approval_prompt=force``` 
+   ```
+   https://www.strava.com/oauth/authorize?client_id=CLIENT_ID&response_type=code&redirect_uri=http%3A%2F%2Flocalhost&scope=activity:write&state=mystate&approval_prompt=force
+   ``` 
 
    > make sure to properly quote the redirect URL
    

diff --git a/strava_cli.md b/strava_cli.md
@@ -26,10 +26,15 @@ Open the [https://strava.github.io/api/v3/oauth/](https://strava.github.io/api/v
 
 For the purpose of generating the OAuth token, this documentation helps a lot [https://strava.github.io/api/v3/oauth/](https://strava.github.io/api/v3/oauth/).
 
-1. Open the following URL (replace `CLIENT_ID` with the ID from above): `https://www.strava.com/oauth/authorize?client_id=CLIENT_ID&response_type=code&redirect_uri=http%3A%2F%2Flocalhost&scope=activity:write&state=mystate&approval_prompt=force` (make sure to properly quote the redirect URL)
-2. Click "Authorise"
-3. Cope the Code from the URL that is given as the `code` parameter
-4. Run the following CURL request, to get the final OAuth token:
+1. Open the following URL (replace `CLIENT_ID` with the ID from above): 
+
+   ```https://www.strava.com/oauth/authorize?client_id=CLIENT_ID&response_type=code&redirect_uri=http%3A%2F%2Flocalhost&scope=activity:write&state=mystate&approval_prompt=force``` 
+
+   > make sure to properly quote the redirect URL
+   
+3. Click "Authorise"
+4. Cope the Code from the URL that is given as the `code` parameter
+5. Run the following CURL request, to get the final OAuth token:
 
     ```
     curl -X POST https://www.strava.com/oauth/token \

diff --git a/strava_cli.md b/strava_cli.md
@@ -54,11 +54,11 @@ curl -X POST https://www.strava.com/api/v3/uploads \
 > other `data_type`s can be
 > `fit`, `fit.gz`, `tcx`, `tcx.gz`, `gpx`, `gpx.gz`
 
-To check the status of your update, use the `id` from the JSON response and run
-
-```shell
-curl https://www.strava.com/api/v3/uploads/ID -H "Authorization: Bearer ${STRAVA_ACCESS_TOKEN}"
-```
+> To check the status of your update, use the `id` from the JSON response and run
+>
+> ```shell
+> curl https://www.strava.com/api/v3/uploads/ID -H "Authorization: Bearer ${STRAVA_ACCESS_TOKEN}"
+> ```
 
 If you want to upload a directory with files, use the following command
 

diff --git a/strava_cli.md b/strava_cli.md
@@ -52,7 +52,7 @@ curl -X POST https://www.strava.com/api/v3/uploads \
 ```
 
 > other `data_type`s can be
-> `fit, fit.gz, tcx, tcx.gz, gpx, gpx.gz`
+> `fit`, `fit.gz`, `tcx`, `tcx.gz`, `gpx`, `gpx.gz`
 
 To check the status of your update, use the `id` from the JSON response and run
 

diff --git a/strava_cli.md b/strava_cli.md
@@ -45,7 +45,20 @@ For the purpose of generating the OAuth token, this documentation helps a lot [h
 
 Now comes the funny part. Use the following command to upload a track to Strava:
 
-    curl -X POST https://www.strava.com/api/v3/uploads -H "Authorization: Bearer OAUTH_TOKEN" -F file=@"PATH_TO_FILE" -F data_type="tcx"
+```shell
+curl -X POST https://www.strava.com/api/v3/uploads \
+    -H "Authorization: Bearer OAUTH_TOKEN" 
+    -F file=@"PATH_TO_FILE" -F data_type="tcx"
+```
+
+> other `data_type`s can be
+> `fit, fit.gz, tcx, tcx.gz, gpx, gpx.gz`
+
+To check the status of your update, use the `id` from the JSON response and run
+
+```shell
+curl https://www.strava.com/api/v3/uploads/ID -H "Authorization: Bearer ${STRAVA_ACCESS_TOKEN}"
+```
 
 If you want to upload a directory with files, use the following command
 

diff --git a/strava_cli.md b/strava_cli.md
@@ -26,7 +26,7 @@ Open the [https://strava.github.io/api/v3/oauth/](https://strava.github.io/api/v
 
 For the purpose of generating the OAuth token, this documentation helps a lot [https://strava.github.io/api/v3/oauth/](https://strava.github.io/api/v3/oauth/).
 
-1. Open the following URL (replace `CLIENT_ID` with the ID from above): `https://www.strava.com/oauth/authorize?client_id=CLIENT_ID&response_type=code&redirect_uri=http%3A%2F%2Flocalhost&scope=write&state=mystate&approval_prompt=force` (make sure to properly quote the redirect URL)
+1. Open the following URL (replace `CLIENT_ID` with the ID from above): `https://www.strava.com/oauth/authorize?client_id=CLIENT_ID&response_type=code&redirect_uri=http%3A%2F%2Flocalhost&scope=activity:write&state=mystate&approval_prompt=force` (make sure to properly quote the redirect URL)
 2. Click "Authorise"
 3. Cope the Code from the URL that is given as the `code` parameter
 4. Run the following CURL request, to get the final OAuth token:

diff --git a/strava_cli.md b/strava_cli.md
@@ -0,0 +1,61 @@
+Upload GPS Tracks to Strava from your Command Line
+==================================================
+
+This short tutorial describes how to upload GPS tracks to Strava using your command line interface / shell. It requires no special tools or any 3rd party code.
+
+**Run all following steps with your user logged in to Strava in your browser!**
+
+
+## 1. Generate an API Key
+
+Strava uses OAuth to authenticate against 3rd party applications. In order to authenticate to your Strava account from your command line, you first have to generate an API key. Therefore go to this page [https://strava.github.io/api/v3/oauth/](https://www.strava.com/settings/api) and create a new API. The settings are as follows:
+
+* `Application Name` chose whatever name you like (does not matter for our use case)
+* `Website` chose whatever website you want to use (needs to be a valid url, e.g. [http://google.com] (does not matter for our use case)
+* `Callback Domain` any domain name that should be used as a callback (does not matter for our use case)
+
+After you saved your API, you need to upload a image for it.
+
+Open the [https://strava.github.io/api/v3/oauth/](https://strava.github.io/api/v3/oauth/) page again and copy the following values to a text editor
+
+* `Client ID` - an ID for your application, used later on to identify your App
+* `Secret` - a secret token generated for you (not your OAuth Token!)
+
+
+## 2. Generate an OAuth Token
+
+For the purpose of generating the OAuth token, this documentation helps a lot [https://strava.github.io/api/v3/oauth/](https://strava.github.io/api/v3/oauth/).
+
+1. Open the following URL (replace `CLIENT_ID` with the ID from above): `https://www.strava.com/oauth/authorize?client_id=CLIENT_ID&response_type=code&redirect_uri=http%3A%2F%2Flocalhost&scope=write&state=mystate&approval_prompt=force` (make sure to properly quote the redirect URL)
+2. Click "Authorise"
+3. Cope the Code from the URL that is given as the `code` parameter
+4. Run the following CURL request, to get the final OAuth token:
+
+    ```
+    curl -X POST https://www.strava.com/oauth/token \
+      -F client_id=12345 \
+      -F client_secret=... \
+      -F code=...
+    ```
+
+5. Copy the `access_token` from the JSON response - this is your OAuth token
+
+
+## 3. Upload your tracks
+
+Now comes the funny part. Use the following command to upload a track to Strava:
+
+    curl -X POST https://www.strava.com/api/v3/uploads -H "Authorization: Bearer OAUTH_TOKEN" -F file=@"PATH_TO_FILE" -F data_type="tcx"
+
+If you want to upload a directory with files, use the following command
+
+    for i in `ls /path/to/files/*.tcx`
+      do curl -X POST https://www.strava.com/api/v3/uploads -H "Authorization: Bearer OAUTH_TOKEN" -F file=@"$i" -F data_type="tcx"
+    done
+
+
+## Further References
+
+* [Strava Documentation for OAuth](https://strava.github.io/api/v3/oauth/#get-authorize)
+* [Python Implementation](https://github.com/mpolla/stravaup)
+* [Runtastic Downloader](https://github.com/Metalnem/runtastic)