BLE Sync Cycle: Features

Jump to bottom

github-actions[bot] edited this page Oct 26, 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)
Graceful handling of connection interrupts and system signals for a clean shutdown

The BLE Sync Cycle Project Wiki