Skip to content

vvrnv/wahoo-headwind-controller

Repository files navigation

WahooHeadwindController

A native macOS menu bar app to control the Wahoo KICKR Headwind fan over Bluetooth.

Wahoo Headwind Controller menu bar panel

Features

  • Menu bar icon (wind symbol)
  • On/Off power toggle
  • Quick presets: 25%, 50%, 75%, 100%
  • Slider for manual speed control (1–100%)
  • Launch at login toggle (starts with macOS)

Requirements

  • macOS 13 (Ventura) or later
  • Bluetooth enabled
  • Wahoo Headwind fan within range

Download

Get the latest build from the Releases page.

  1. Open github.com/vvrnv/wahoo-headwind-controller/releases
  2. Download the latest WahooHeadwindController .dmg (or .zip) under Assets
  3. Open the DMG and drag WahooHeadwindController to Applications
  4. Launch the app from Applications — allow Bluetooth when macOS asks
  5. If the app is blocked as unsigned: right-click the app → Open → confirm once

Usage

  1. Launch WahooHeadwindController
  2. Click the wind icon in the menu bar
  3. Press Connect (searches for a device named HEADWIND)
  4. Adjust speed and power

Disconnect and Quit send an off command to the fan before closing the Bluetooth link.

Enable Launch at login to start the app when you sign in. On first enable, macOS may ask you to approve it under System Settings → General → Login Items.

Quitting

This app runs in the menu bar only (no Dock icon). To exit:

  1. Click the menu bar icon → Quit (or press ⌘Q while the panel is open)
  2. If multiple copies are stuck, force-quit all of them in Terminal:
killall WahooHeadwindController

Only one instance can run at a time. If you launch the app again while it is already running, the existing copy is brought forward and the new one exits automatically.

Notes

  • While this app is connected to the fan, the official Wahoo app on the same Mac may not connect at the same time
  • BLE protocol based on community reverse-engineering: bluewind and tailwind
  • Unofficial app — not affiliated with Wahoo Fitness

License

MIT

About

A native macOS menu bar app to control the Wahoo KICKR Headwind fan over Bluetooth.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages