BLE Sync Cycle Features

• Real-time synchronization between cycling speed and video playback

• Support for compliant BLE Cycling Speed and Cadence (CSC) sensors (in speed mode)

• Integrates with the mpv media player

• Highly configurable TOML-based file for setting up application options, including:

  • 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 with support for 10 file formats (mp4, mkv, avi, etc.)
  • Seek to a specific start time in the video
  • Auto resume video playback from the last playback position
  • Display options:
    • On-screen display (OSD) for speed and time remaining
    • Video window scaling (fullscreen, etc.)
    • OSD position and font size

• Choice of running modes:

  • GUI Mode: a modern GTK4/Adwaita design with interactive graphical support for:

    • Cycling session selection
    • Session status (including cycling speed, ride time, and session time remaining), and video playback
    • Session logging
    • BSC session creation, editing, and management

  • CLI Mode: a simple command-line interface for minimal operational overhead

    • Application flags to override configuration file settings:
      • Configuration file path (allows for multiple profiles)
      • Video start time (seek)
      • Help/usage information

• Support for video playback on a non-primary display, allowing users to utilize a dedicated big-screen monitor or TV for video output while keeping the application running on a separate display

• Configurable logging levels (debug, info, warn, error)

• BLE sensor battery level is checked and displayed on every session start, ensuring that users have sufficient battery life for an accurate training session

• Graceful handling of connection interrupts and system signals for a clean shutdown

• Integrated application installer/uninstaller for easy setup and self-removal of the application