BLE Sync Cycle: Features

Jump to bottom

github-actions[bot] edited this page Oct 29, 2025 · 3 revisions

Real-time synchronization of cycling speed and video playback
Supports compliant BLE Cycling Speed and Cadence (CSC) sensors (in speed mode)
Integrates with mpv and VLC media players
Highly configurable TOML-based config file for:
- BLE sensor address (BD_ADDR) and scan timeout
- Wheel circumference (for accurate speed)
- Speed units (mph or km/h)
- Speed smoothing for natural playback
- Video file selection
- Display options:
  - On-screen display (OSD) for speed and time remaining
  - Video window scaling (fullscreen, etc.)
  - OSD position and font size
Command-line interface for real-time application status
CLI flags to override settings:
- Configuration file path (allows for multiple profiles)
- Video start time (seek)
- Help/usage information
Configurable log levels (debug, info, warn, error)
On every application startup, the battery level of the BLE sensor is checked and displayed
Graceful handling of connection interrupts and system signals for a clean shutdown

The BLE Sync Cycle Project Wiki