Metadata-Version: 2.4
Name: vkx2gpx
Version: 1.0.0
Summary: Convert Vakaros .vkx sailing telemetry files to .gpx format
Author-email: Matxin Jiménez <matxinj@gmail.com>
License-Expression: MIT
Project-URL: Repository, https://github.com/Matx1n3/vkx2gpx
Project-URL: Issues, https://github.com/Matx1n3/vkx2gpx/issues
Keywords: sailing,gps,gpx,vakaros,telemetry
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: gpxpy
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# vkx2gpx

Convert [Vakaros](https://vakaros.com) `.vkx` sailing telemetry files to `.gpx` format.

Preserves track points (position, speed, course over ground) and start line marks (pin and committee boat) as numbered GPX waypoints.

## Installation

```bash
pip install vkx2gpx
```

Or from the repository:

```bash
pip install git+https://github.com/Matx1n3/vkx2gpx.git
```

## Usage

### CLI

```bash
vkx2gpx --input race.vkx
vkx2gpx --input race.vkx --output race.gpx
vkx2gpx --input race.vkx --verbose
```

### Python

```python
from vkx2gpx import vkx2gpx

vkx2gpx("race.vkx", "race.gpx")
```

## Output format

The generated `.gpx` file contains:

**Track points** — one per PVO record (`0x02`):
- Latitude / longitude (degrees, 1e-7 resolution)
- Elevation (meters)
- Timestamp (UTC)
- Speed over ground (m/s)

**Waypoints** — one per start line position record (`0x05`):
- Latitude / longitude
- Timestamp (UTC)
- Name: `Pin (port) 1`, `Pin (port) 2`, `Committee boat (starboard) 1`, etc.

## License

MIT
