https://github.com/nce/tourenbuchctl
A go application managing my personal outdoor activity log book
https://github.com/nce/tourenbuchctl
gnuplot go gpx latex oauth strava-api
Last synced: 3 months ago
JSON representation
A go application managing my personal outdoor activity log book
- Host: GitHub
- URL: https://github.com/nce/tourenbuchctl
- Owner: nce
- License: apache-2.0
- Created: 2024-07-01T09:36:12.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-03-08T02:05:12.000Z (3 months ago)
- Last Synced: 2026-03-08T07:32:02.372Z (3 months ago)
- Topics: gnuplot, go, gpx, latex, oauth, strava-api
- Language: Go
- Homepage:
- Size: 1.79 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# :books: tourenbuchctl
This is a tool for working with my `tourenbuch`.
`Tourenbuch` is a digital & printed log book of my personal outdoor sports activities.
Each activity consists of gpx tracks, map, stats, plotted elevation graphs and an
overall summaray/description.
This CLI helps me to interact with it. Until i release more information about
my (private) Tourenbuch, it's probably not useful for anyone.
See the example of an activity page below:
# :grey_question: How does this work
I'm using two local folders:
* `textdir` (← a (private) git repository containing my written/text elements)
* `assetdir` (← a cloud synced folder containing my images/gpx/asset elements)
tbc.
# :mountain_bicyclist: Usage
### New Single Day activity
```sh
tourenbuchctl new mtb -d -t ""
tourenbuchctl new skitour --max-elevation <1234> -d -t ""
```
### New Multiday activity
```sh
tourenbuchctl new mtb transalp-2013/ -d -t '' -m -c "" -y -r
```
# :hammer: Tech Details
## Strava
Activity stats like distance or climbed elevation get queried from strava and
parsed in the Tourenbuch.
# Dev
## Prerequisites
### Swagger
Go-swagger is incompatible with 3.x api defintion of strava...
And strava declared their current 3.x api incompatible with swaggerv3. I played
around with different `2.x` releases, which in fact generated a different codebase.
I [struggled with](#13) `swagger-codegen-cli-v3:3.0.58` on the `ActivitiesApiUpdateActivityByIdOpts`,
switching to `2.4.43` solved the problem, though generated a wrong `model_lat_long.go`, which i
had [to patch](https://github.com/nce/tourenbuchctl/blob/e2147617af8eaaae55847c9ee69f8fa6b2eb1e41/pkg/stravaapi/model_lat_lng.go#L12-L16).
Refer to the [Makefile](Makefile) for the current swagger build.