BLE Sync Cycle

BLE Sync Cycle is an innovative Go application that seamlessly synchronizes video playback with real-time cycling data from Bluetooth Low Energy (BLE) devices, such as Cycling Speed and Cadence (CSC) sensors. This application enhances the indoor cycling experience by matching the video playback speed to the user's actual cycling pace, providing a more immersive environment when outdoor cycling is not feasible.

Key Features

• Real-time synchronization: Ensure that cycling speed is perfectly aligned with video playback.
• Wide compatibility: Supports compliant BLE Cycling Speed and Cadence sensors configured for speed mode.
• Customizable configuration: Utilize a TOML-based configuration to tailor the app to specific needs, including:
  • BLE sensor setup (BD_ADDR)
  • Bluetooth device scanning timeout
  • Wheel circumference for accurate speed conversion
  • Support for various speed units: miles per hour (mph) and kilometers per hour (km/h)
  • Speed smoothing for a more natural playback experience
  • Configurable video file selection for playback
  • Diverse display options for the best viewing experience, such as:
    • On-screen display (OSD) showing sensor speed, playback speed, and remaining playback time
    • Options for video window scaling (full screen, half screen, etc.)
    • Adjustable OSD font size
• User-friendly interface: A command-line interface provides real-time application status, with easy-to-modify command-line flags allowing for configuration overrides, including:
  • Location of configuration files for various cycling sessions
  • Video playback start points (seek functionality)
  • Help and usage information
• Flexible logging: Configurable logging levels (debug, info, warn, error) manage the information displayed during execution.
• Robust design: Graceful handling of connection interrupts and system signals ensures all components shut down cleanly when the application exits.

Purpose

Developed to meet the need for effective indoor cycling during unfavorable weather conditions, BLE Sync Cycle offers an alternative to existing virtual cycling solutions that often require expensive equipment and reliable internet connectivity. This application accommodates cyclists who prefer to use their own bicycles and need a solution with minimal dependencies, designed for flexibility and customization.

For those interested in further details about BLE Sync Cycle, additional information is available in the project wiki.