https://github.com/tderflinger/tcx-ls
CLI application to view information like heart rate, run cadence and others from a TCX-file.
https://github.com/tderflinger/tcx-ls
analytics cli running sports tcx tcx-parser typescript
Last synced: 2 months ago
JSON representation
CLI application to view information like heart rate, run cadence and others from a TCX-file.
- Host: GitHub
- URL: https://github.com/tderflinger/tcx-ls
- Owner: tderflinger
- Created: 2025-02-14T05:49:00.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-19T13:55:32.000Z (over 1 year ago)
- Last Synced: 2025-02-19T14:29:03.791Z (over 1 year ago)
- Topics: analytics, cli, running, sports, tcx, tcx-parser, typescript
- Language: TypeScript
- Homepage:
- Size: 35.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-computational-intelligence-in-sports - tcx-ls - CLI application for viewing TCX file information. (Software 💻 / Wrestling 🤼♀️)
README
This is a command line tool to view information from a TCX-file. It displays information like accumulated time, accumulated distance, maximum speed, average pace, maximum run cadence, and more.
The TCX file format is used by Garmin devices and other devices to store data such as GPS coordinates, heart rate, and other sensor data. You can export it for example from the Garmin Connect application.
The TCX file format schema is described on this page: https://www8.garmin.com/xmlschemas/TrainingCenterDatabasev2.xsd
With the optional '-l' flag you can also display the individual laps of the activity.
## Binary Release
You can download the binary version of the CLI tool from the releases page. The binary is compiled for x86 Linux.
First, make it executable, like so:
```bash
chmod +x ./tcx-ls
```
Start the application via:
```bash
./tcx-ls /path/to/your/file.tcx
```
In order to view the lap details, use the '-l' flag:
```bash
./tcx-ls -l /path/to/your/file.tcx
```
You can also export the tracks as a GeoJSON file:
```bash
./tcx-ls --geojson output.json /path/to/your/file.tcx
```
In order to export the laps as a CSV file:
```bash
./tcx-ls --csv laps.csv /path/to/your/file.tcx
```
## Command Options
| Option | Description |
|-----------------|---------------------------------------|
| `-l` | View the lap details |
| `-c` | View the creator data |
| `-a` | View the author data |
| `--geojson` | Export the tracks as a GeoJSON file |
| `--csv` | Export the laps as a CSV file |
## Source Installation
Install the dependencies using the following command:
```bash
deno install
```
## Usage
Specify the TCX file as an argument to view the sports activity information.
```bash
deno run --allow-read main.ts /path/to/your/file.tcx
```
If you want to export GeoJSON or CSV data you need to add --allow-write.
## License
This project is licensed under the MIT License.