Hyperborea

Connecting Fitness Apps

How to connect external fitness apps to your machine through Hyperborea, and how resistance and incline control works.

Pairing with a Fitness App

  1. Open your fitness app (Zwift, TrainerRoad, Rouvy, etc.) on your phone, tablet, or computer.
  2. Go to the app's device or sensor pairing screen.
  3. Scan for Bluetooth devices — your machine will appear by its detected name (you can change this in Device Configuration).
  4. Select it as a power source, controllable trainer, or both, depending on what your app supports.

Once connected, your fitness app will receive live data from your machine.

Resistance & Incline Control

Fitness apps that support FTMS Control Point (such as Zwift) can send commands back to your machine:

  • Resistance targets — the app sets a specific resistance level.
  • Incline targets — the app sets a specific incline percentage.
  • ERG mode — the app sets a target power (watts), and the machine automatically adjusts resistance to maintain that power regardless of your cadence.

These commands are handled automatically. When your fitness app changes the target, the machine responds within a few seconds. Target values appear below the current reading on the dashboard (e.g. "→ 5.0" under incline).

Wi-Fi Streaming

Hyperborea runs a TCP server on your machine and advertises itself via mDNS. Compatible apps (such as Zwift) will automatically discover your equipment on the network — no manual IP configuration required. The result is lower latency and a more reliable link than Bluetooth alone.

Wi-Fi streaming is useful when:

  • Bluetooth is unreliable or congested
  • The device running your fitness app is out of BLE range but on the same network

Both Bluetooth and Wi-Fi connections can be active simultaneously. You can toggle each independently from Quick Settings.

Compatible Fitness Apps

Hyperborea broadcasts your machine's data using the BLE FTMS (Bluetooth Low Energy Fitness Machine Service) standard. The following apps should be compatible:

  • Zwift — tested
  • MyWhoosh — untested
  • TrainerRoad — untested
  • Rouvy — untested
  • Wahoo SYSTM — untested
  • Kinomap — untested
  • FulGaz — untested
  • Xert — untested

Any fitness app that supports BLE FTMS should be able to detect and use your machine through Hyperborea. If your app can connect to smart trainers over Bluetooth, it will likely work.

What Is BLE FTMS?

BLE FTMS (Bluetooth Low Energy Fitness Machine Service) is an industry-standard Bluetooth protocol for smart fitness equipment. It defines how devices like bikes, treadmills, rowers, and ellipticals communicate workout data (power, speed, cadence, etc.) to apps and head units.

Hyperborea turns your machine into a standard BLE FTMS device. From the perspective of your fitness app, it looks and behaves like any other smart trainer on the market. There is nothing extra to configure on the app side — just scan for Bluetooth devices and connect.