Hyperborea

Setup & Installation

Get Hyperborea running on your machine. This guide walks you through account creation, console preparation, ADB installation, linking, and verification.

Step 1: Create Your Account

  1. Click Sign up and enter your email address and a password.
  2. Confirm your email if prompted.
  3. Once logged in, you'll land on your Dashboard.

Step 2: Start Your Free Trial

  1. Your 30-day free trial starts automatically when you sign up.
  2. You can add a payment method anytime from the Dashboard.
  3. Your free trial activates immediately. You can now proceed with installing Hyperborea on your console.

Note: Each subscription covers one machine at a time. You can switch machines by unlinking your current one and linking a new one. If you need multiple machines linked simultaneously, you'll need a separate subscription for each.

Step 3: Prerequisites

Before you begin installation, make sure you have:

  • An iFit-based machine (NordicTrack, ProForm, or FreeMotion) with an Android-based touchscreen console (2019 or newer models with Android touchscreens)
  • A reliable Wi-Fi network that the console can connect to
  • A computer (Mac, Windows, or Linux) connected to the same Wi-Fi network the console will use
  • ADB (Android Debug Bridge) installed on your computer (see below)
  • A paperclip or SIM ejector tool for pressing the console's pinhole reset button

Installing ADB

ADB is a command-line tool that lets your computer communicate with the console over your Wi-Fi network. Install it using one of the methods below for your operating system.

macOS:

With Homebrew:

brew install android-platform-tools

Or download Platform Tools directly from Google and extract the ZIP.

Linux:

Debian / Ubuntu:

sudo apt install android-tools-adb

Fedora:

sudo dnf install android-tools

Arch:

sudo pacman -S android-tools

Windows:

With winget:

winget install Google.PlatformTools

Or download Platform Tools directly from Google and extract the ZIP.

Tip: New to the command line? MDN has a great introduction to the command line to help you get started.

Note (Windows): If you see an error about script execution being disabled when you try to run the installer later, you may need to adjust your PowerShell execution policy. The install command in Step 9 already handles this, but if you run into issues, see Microsoft's about_Execution_Policies documentation.

Step 4: Factory Reset

Factory resetting the console wipes all iFit data and returns it to a clean state. This is required so you can connect to Wi-Fi without iFit locking down the system.

These steps have been verified on the NordicTrack S22i. The process should be similar on other iFit-based consoles, but the pinhole location may vary by model.

  1. Power off the machine completely using the power switch.
  2. Locate the pinhole reset button on the edge of the console. On the S22i, it's on the left edge of the display. On other models, look for a small pinhole along the top, bottom, or side edges.
  3. Insert a paperclip or SIM ejector tool into the pinhole and press and hold the button inside.
  4. While still holding the pinhole button, power on the machine.
  5. Keep holding until you see recovery text appear on the screen, then release the button.
  6. Wait 3-5 minutes for the console to complete the factory reset and reboot. It will eventually land on the iFit onboarding/welcome screen.

Can't find a pinhole? Try skipping ahead to Step 6: Enter Privileged Mode first. If privileged mode works, you can factory reset through Android Settings > System > Reset options instead. If you're stuck, ask for help in our Discord.

Step 5: Connect to Wi-Fi

After the factory reset, the console will boot to the iFit welcome/onboarding screen.

  1. Tap Next on the welcome screen.
  2. Select your Wi-Fi network and enter the password.
  3. STOP immediately once Wi-Fi is connected. Do not continue the iFit onboarding process.

Warning: Do not proceed past the Wi-Fi step in iFit's setup. If you continue, iFit may download a firmware update that disables privileged mode, which would require another factory reset.

Step 6: Enter Privileged Mode

Privileged mode grants the access needed to install Hyperborea as a system app. The activation sequence is:

  1. Tap anywhere on the screen 10 times quickly (within about 3 seconds).
  2. Wait 5-10 seconds. This pause is important — wait at least 5 seconds, but no more than 10.
  3. Tap 10 more times quickly (within about 3 seconds).

After the second set of taps, one of two things will happen:

  • "Privileged Mode Enabled" toast message appears at the bottom of the screen. You're all set — skip ahead to Step 8.
  • A dialog with a challenge code appears. Continue to Step 7 to solve it.

Nothing happened? Wait a moment and try again. The timing can be finicky. You can retry as many times as you need — there is no lockout.

Step 7: Solve the Challenge Code

If the console displayed a dialog with a challenge code instead of enabling privileged mode directly, you need to solve it to continue.

  1. On your computer or phone, open the response code solver.
  2. Enter the challenge code shown on the console's dialog.
  3. The solver will give you a response code.
  4. Type the response code back into the dialog on the console and confirm.

Tip: The Hyperborea download ZIP (from Step 9) also includes offline solver scripts if you prefer not to use the web tool.

Step 8: Enable Developer Options & ADB

Now that privileged mode is active, you need to enable ADB so your computer can connect to the console.

  1. Swipe up from the bottom edge of the screen to reveal the Android navigation bar (Back, Home, and Recent buttons).
  2. Tap the Home button, then open Settings.
  3. Go to About tablet and tap Build number 7 times. You'll see a message confirming that Developer options have been enabled.
  4. Go back to Settings > Developer options and enable USB Debugging (this also enables wireless ADB).
  5. While you're in Settings, note the console's IP address: go to Settings > About tablet > Status and find the IP address. You'll need it if the install script asks for it.

Step 9: Download & Run the Installer

  1. On your computer, go to your Dashboard.
  2. Download the Hyperborea ZIP file.
  3. Extract the ZIP to a folder on your computer.
  4. Open a terminal (or PowerShell on Windows) and navigate to the extracted folder.
  5. Run the deploy script:

macOS / Linux:

bash deploy.sh

Windows:

powershell -ExecutionPolicy Bypass -File deploy.ps1

The script will connect to your console over the network, install the Hyperborea APK as a system app, and verify the installation. Follow any prompts that appear.

  1. Open the Hyperborea app on your console and tap Link Device. A QR code and a 6-digit pairing code will be displayed on screen.
Link Your Device screen
The pairing screen with QR code and 6-digit code
Link Your Device screen
  1. You can link your device using either method:

Option A: Scan the QR code

  • Scan the QR code with your phone's camera.
  • This opens the Hyperborea link page in your browser — confirm the pairing from there.

Option B: Enter the pairing code

  • In your browser, go to your Dashboard.
  • Click Link Device.
  • Enter the 6-digit pairing code shown on the console and confirm.
  1. The console and your account are now linked.

Note: Pairing codes expire after 10 minutes. If the code expires, restart the Hyperborea app on the console to generate a fresh code.

Step 11: Verify the Connection

Once linking is complete:

  • The console app will show the Hyperborea dashboard with live metrics.
Dashboard showing idle state
The main dashboard in idle state
Dashboard showing idle state
  • Open your preferred fitness app (Zwift, Wahoo, Rouvy, etc.) on your phone, tablet, or computer.
  • Scan for Bluetooth devices in the fitness app. Your machine should appear by its detected name as an FTMS-compatible device. You can change this name in Device Configuration.
  • Select it and start a workout to confirm that metrics like power, cadence, and speed are being transmitted.

Auto-Updates

The Hyperborea APK updates automatically while your subscription is active and the console has a Wi-Fi connection. You do not need to manually download new versions. Updates install in the background and take effect the next time you open the app.

If an update fails to install, check that your Wi-Fi connection is stable and that your subscription has not expired. See the Troubleshooting guide for more help.