Metadata-Version: 2.4
Name: skytraq_ui
Version: 0.1.0
Summary: PyQt6 desktop GUI for downloading and exporting SkyTraq Venus GPS tracks
Author-email: Teichi <tobias@teichmann.top>
Project-URL: Homepage, https://gitlab.com/Teigi/skytraq-ui
Project-URL: Issues, https://gitlab.com/Teigi/skytraq-ui/issues
Keywords: gps,skytraq,venus,datalog,gpx,pyqt6,gui
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: System :: Hardware :: Hardware Drivers
Classifier: Environment :: X11 Applications :: Qt
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt6>=6.4
Requires-Dist: skytraq-datalog>=0.1
Requires-Dist: pyserial>=3.5
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == "dev"
Requires-Dist: pyright>=1.1; extra == "dev"
Dynamic: license-file

# skytraq-ui

PyQt6 desktop GUI for downloading and exporting GPS tracks from SkyTraq Venus devices.

## Features

- Detects available serial ports and connects at configurable baud rates
- Downloads the full datalog from the device with a sector-level progress bar
- Splits the raw point stream into trips (configurable gap threshold in minutes)
- Exports selected trips as GPX files, optionally named by start timestamp

## Requirements

- Python 3.11+
- `PyQt6 >= 6.4`
- [`skytraq-datalog`](https://gitlab.com/Teigi/skytraq-datalog) (provides `skytraq.gps`, `skytraq.gpx`, `skytraq.types`)
- `pyserial` (pulled in transitively for port enumeration)

## Installation

```bash
pip install skytraq_ui
```

## Usage

```bash
skytraq-ui
# or
python -m skytraq_ui
```

1. Select the serial port and baud rate (default 9600).
2. Set the trip-gap threshold (minutes of inactivity that separate trips).
3. Click **Download from device**.
4. Check the trips you want to export.
5. Set an output directory and filename prefix, then click **Save selected trips**.

## License

MIT
