Skip to content

Latest commit

 

History

History
47 lines (32 loc) · 1.43 KB

File metadata and controls

47 lines (32 loc) · 1.43 KB

Peloterm

A cycling metrics application that connects to Bluetooth sensors to display real-time performance data while you ride. Supports embedding compatible streaming content (like Jellyfin) in the built-in media player using HTML iframes. When you're done, easily save and upload your rides to Strava.

Peloterm Screenshot

Features

  • Real-time BLE sensor connection (heart rate, power, cadence, speed)
  • Modern web-based UI with configurable video integration
  • Automatic ride recording with FIT file generation
  • Interactive Strava upload
  • Smart listening mode - turn on devices when you're ready

Installation

pip install peloterm

Quick Start

  1. First time setup - scan for your sensors:

    peloterm scan

    This saves your device addresses to a config file, so you only need to do this once.

  2. Start your ride:

    peloterm start
  3. Turn on your devices when prompted and start cycling!

  4. Press Ctrl+C when done to stop the session.

Web Interface

When you run peloterm start, a web interface opens at http://localhost:8000 with:

  • Real-time cycling metrics
  • Interactive chart
  • Configurable video panel (Jellyfin by default)

Contributing

Want to contribute? Check out our CONTRIBUTING.md for development setup, project structure, and how to submit pull requests.