peregin/gps-overlay-on-video
59.2
Adequate · 6 November 2026
4.1k
lines of production code
Scala
primary language
4
measurements over time
What this system is
Features
Added sample GPS telemetry data for chart visualization
A new default sample GPS data file (sample.gpx) has been added to the resources, containing track points with elevation, time, and cadence extensions. This data is intended to serve as default telemetry input, enabling users to visualize different chart types, such as elevation profiles, without needing to import their own data.
src/main/resources/gps · high confidence
Initial CircleCI configuration for SBT builds
Added a new CircleCI configuration (\.circleci/config.yml\) and a helper script (\cachekey.sh\) to automate the build and test process for the SBT project. The pipeline uses a custom Docker image, performs a blobless checkout, generates checksums for build files to optimize caching, and executes compilation and test steps.
.circleci · high confidence
Initial project setup and tooling
The repository is initialized with the application source, build configuration (version 3.0.2-SNAPSHOT), and essential documentation including the README, MIT License, and Code of Conduct. It introduces a \run.sh\ script for easy execution and a \release.sh\ script for automated publishing to GitHub, alongside a \.travis.yml\ configuration for continuous integration.
(repo-wide) · high confidence
Introduce customizable and activity-specific dashboards
The dashboard system now supports multiple preset layouts tailored for specific activities, including Cycling, Skiing, Motorbiking, and Sailing, each displaying relevant gauges such as speed, elevation, heart rate, and azimuth. Additionally, users can define custom dashboard layouts via YAML configuration files, allowing for flexible positioning, sizing, and color customization of individual gauges through the new DynamicResourceDashboard and YamlResourceDashboardLoader components.
src/main/scala/peregin/gpv/gui/dashboard · high confidence
Introduce video conversion dialog and unit selection controls
Users can now generate video overlays via a new Converter dialog that provides bitrate adjustment, output file selection, and progress/status feedback, while the main application window adds a unit chooser (Metric, Marine, Standard) to switch display units and a transparency slider to adjust dashboard opacity.
src/main/scala/peregin/gpv · high confidence
New GPS and time formatting utilities
Added GpsFormatter and TimeFormatter classes to handle coordinate and time display. GpsFormatter converts longitude and latitude into degree-minute-second strings with directional indicators (WE/SN), while TimeFormatter formats time durations in seconds into a HH:MM:SS string, supporting negative values for times when the GPX start is later than the video start.
src/main/scala/peregin/gpv/format · high confidence
New SVG-based and digital gauge components for video overlay
The gauge rendering system has been expanded with a new SVG-based visual style and several new data displays. A new \SvgGauge\ trait and \ImageCache\ (using Guava) provide a scalable, cached SVG rendering path, implemented by \SvgDigitalGauge\ and its specific variants for cadence, elevation, heart rate, and temperature, as well as \SvgDistanceGauge\ and \SvgElevationGauge\. Additionally, new \DigitalGauge\ implementations (using a digital font) and specific gauges for cadence, elevation, and speed have been added, alongside new chart-based gauges for elevation, distance/duration, and map location.
src/main/scala/peregin/gpv/gui/gauge · high confidence
New telemetry model and Garmin extension parsing
The application now parses Garmin-specific GPX extensions (cadence, heart rate, power, and temperature) via a new GarminExtension model and integrates this data into the core Telemetry and TrackPoint structures. This change introduces new calculation logic for speed, grade, and distance using the haversine formula, adds support for video captions, and refines the data model with new classes like MinMax, InputValue, and SlopeSegment to support gauge displays.
src/main/scala/peregin/gpv/model · high confidence
New utility library for image processing, data conversion, and telemetry alignment
This change introduces a new set of utility classes in the \peregin.gpv.util\ package to support core application features. \ImageConverter\ and \Io\ provide capabilities to load, manipulate, and compare images, including SVG rendering and handling missing resources with a placeholder. \UnitConverter\ adds support for displaying distance, speed, and elevation in both standard (metric/imperial) and marine units (nautical miles, knots). \VideoGpxAlignment\ enables automatic synchronization of video playback with GPX telemetry by reading video creation timestamps. Additionally, \JsonConverter\ and \YamlConverter\ standardize data serialization, while \TimePrinter\ and \SeqUtil\ offer helper functions for time formatting and sequence operations.
src/main/scala/peregin/gpv/util · high confidence
New video playback and telemetry visualization interface
The application introduces a new GUI layer for synchronizing video playback with GPS telemetry. Users can now load video and GPS files via dedicated file choosers, control playback with a custom percentage slider and start/stop button, and view synchronized data on map and altitude panels. The interface supports switching between map providers, adjusting GPS timestamp shifts, and selecting from predefined dashboard templates (e.g., Cycling, Sailing) that display various gauges like speed, elevation, and heart rate overlaid on the video.
src/main/scala/peregin/gpv/gui · high confidence
Behavioural changes
Actor-based video player with seek and delay control
The video playback engine has been refactored to use an Akka actor-based architecture (SeekableVideoPlayer and PlayerControllerActor) to manage play, pause, step, and seek operations more reliably. This change introduces precise delay compensation between video frames and system clock via a new DelayController, ensuring smoother playback timing. It also adds support for relative seeking (seekBy) and queries the player's running status asynchronously, improving responsiveness during user interactions like seeking or pausing.
src/main/scala/peregin/gpv/video · high confidence
Refactored map and altitude panels with new tile providers
The map and altitude display components have been refactored into separate, dedicated panels (MapPanel and AltitudePanel) to improve code organization. The map view now defaults to Microsoft tiles instead of the previous provider, with support for MapQuest tiles also included. The altitude panel now renders an elevation chart that can switch between time-based and distance-based modes, and the map overlay uses a new KnobPainter to display Points of Interest and current progress with distinct colored markers.
src/main/scala/peregin/gpv/gui/map · high confidence
Test coverage
Added GPS test data resources; Added initial test suite for PlayerControllerActor; Added manual test applications for UI components; Added test configuration for verbose FSM event logging; Added test coverage for GPV utility classes; Added tests for MapGauge coordinate scaling and edge cases; Added unit tests for GPS coordinate formatting; Added unit tests for GPS telemetry model components.
Dependencies
Migrate build system from Maven to SBT
The project has replaced its Maven build configuration (pom.xml) with an SBT build definition (build.sbt). This migration updates the build toolchain, sets the Scala version to 2.13.18, and configures the application to target Java 17. The new build file defines the complete dependency graph, including libraries for video processing (JavaCV, FFmpeg), UI (Scala Swing, MigLayout), data handling (Jackson, JSON4s, GeoTools), and testing (Specs2, Mockito), while also configuring the assembly plugin to produce a standalone executable JAR.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 60 → 59 (-0.7)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 61 → 61 (+0.0)
- Architecture 100 → 100 (+0.0)
- Maturity 51 → 51 (+0.0)
- Readiness 57 → 55 (-2.2)
- Security 97 → 95 (-2.1)
Resolved (6)
- Off-boarding risk: anonymized user #1
- Outdated: com.fasterxml.jackson.dataformat:jackson-dataformat-yaml
- Outdated: com.fasterxml.jackson.datatype:jackson-datatype-jsr310
- Outdated: com.fasterxml.jackson.module:jackson-module-scala_2.13
- Outdated: io.github.json4s:json4s-jackson_2.13
- Outdated: io.github.json4s:json4s-native_2.13
New (2)
- Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
- Off-boarding risk: anonymized user #1
Changes since last survey
- 10 commits — 10 feature/other, 0 fixes
By area
- (repo) — 5 commits
- (root) — 3 commits
- project/build.properties — 1 commit
- project/plugins.sbt — 1 commit
Notable commits
- change: Merge pull request #447 from scala-steward/update/logback-classic-1.6.6
- change: Merge pull request #448 from scala-steward/update/sbt-2.0.12
- change: Merge pull request #449 from scala-steward/update/joda-time-2.15.1
- change: Merge pull request #450 from scala-steward/update/guava-33.8.0-jre
- change: Merge pull request #451 from scala-steward/update/sbt-sbom-0.7.0
- change: Update guava to 33.8.0-jre
- change: Update joda-time to 2.15.1
- change: Update logback-classic, logback-core to 1.6.6
- change: Update sbt to 2.0.12
- change: Update sbt-sbom to 0.7.0
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
peregin/gps-overlay-on-video was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 33bee6b2e2f38bc633508cb49dbd2823996b60ab — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-60d1b390edf0.