explaingit

digitalhen/bike-bar

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 3/5Setup · easy

TLDR

Bike Bar shows your Bosch eBike's battery, range, and ride data in a Mac menu bar app, with an optional web dashboard and API for developers.

Mindmap

mindmap
  root((Bike Bar))
    What it does
      Battery in menu bar
      Web dashboard
      Ride tracking with maps
    Tech stack
      Python
      FastAPI
      Swift menu bar app
    Use cases
      Quick battery glance
      Ride history review
      Charging alerts
    Audience
      Bosch eBike owners
      Developers running the API
    Notes
      Unofficial
      Reverse engineered login

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check your Bosch eBike's battery and range from the Mac menu bar without opening a phone app.

USE CASE 2

View past rides on a map colored by speed, power, or cadence.

USE CASE 3

Get desktop notifications when the battery is full, low, or a ride finishes.

What is it built with?

PythonFastAPISwiftmacOS

How does it compare?

digitalhen/bike-bar0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The Mac app is one download and sign-in, running the backend yourself instead requires Python and a manual first-time login.

The README excerpt provided does not state the license.

In plain English

Bike Bar puts the battery, range, and ride data from a Bosch eBike into a Mac menu bar app, a web dashboard, a local API, and event notifications. It works with Tern GSD bikes and any Bosch Smart System bike that has a ConnectModule, and it shows the same information you would see in Bosch's own eBike Flow app, just in more places. The project is unofficial and talks to Bosch's private servers using a reverse engineered login method from the official mobile app, so the author is upfront that it could break if Bosch changes something on their end. Most people only need the Mac app itself: download it, drag it into Applications, open it, and sign in with your existing eBike Flow account in a browser window. It is signed and notarized so macOS will not warn you when opening it, and it updates itself automatically. Once running, it lives quietly in the menu bar showing a battery icon and can send desktop notifications for things like the battery finishing charging or a ride ending. For developers, the same functionality is also available as a small Python backend you can run yourself: a REST API and web dashboard built with FastAPI, plus a dependency free command line tool. The web dashboard shows battery level, efficiency by riding mode, firmware details, and a map of past rides where the track is colored by speed, power, or cadence. Logging in this way is more involved, since Bosch's login flow is designed for its own mobile app, so getting the first access token means manually copying a code out of your browser's developer tools. The Mac app actually bundles this same backend inside itself as a background process, so most users never need to touch Python at all. The whole thing is aimed at Bosch eBike owners who want a quicker glance at their bike's status than opening the official app.

Copy-paste prompts

Prompt 1
Walk me through installing and signing into the Bike Bar menu bar app on macOS.
Prompt 2
Explain how Bike Bar authenticates with Bosch's private eBike Flow API without an official developer key.
Prompt 3
Show me how to run the Bike Bar API and dashboard myself instead of using the packaged Mac app.
Prompt 4
Help me set up webhooks so Bike Bar notifies me when my eBike finishes charging.

Frequently asked questions

What is bike-bar?

Bike Bar shows your Bosch eBike's battery, range, and ride data in a Mac menu bar app, with an optional web dashboard and API for developers.

What language is bike-bar written in?

Mainly Python. The stack also includes Python, FastAPI, Swift.

What license does bike-bar use?

The README excerpt provided does not state the license.

How hard is bike-bar to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is bike-bar for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.