Install veloVigil

Karoo 2 and Karoo 3. Takes about ten minutes.

What you're doing here: Installing a small extension on your Karoo so it can record your ride data and prepare it for AI coaching. This is a normal process for Karoo extensions — no developer tools required.

Invite required. veloVigil is currently invite-only. Don't have a code yet? Sign up here and we'll email one when your spot opens. Your invite code unlocks the app during installation — you only use it once.

What You Need

RequiredWhat it does
Karoo 2 or Karoo 3Runs the veloVigil extension
Polar H10 chest strapThe only strap the extension reads today. HR, HRV (RR intervals), g-force
USB cableTo connect Karoo to your computer (one time only)
Invite codeRequired to register your device and start sending telemetry

Other straps: they keep working with the Karoo as normal, but veloVigil does not read them yet, so your rides will show HR 0 on the dashboard. A Polar H10 adds real HRV analysis (RMSSD, SDNN, pNN50 from beat-to-beat RR intervals) and crash detection (3-axis accelerometer at 200Hz). These features don't work with other heart rate straps - the H10 is the only consumer strap that exposes RR intervals and accelerometer data over Bluetooth.

Step 1: Download the extension

Download veloVigil v0.2.3 APK

Save the file somewhere you can find it. It's called velovigil-v0.3.2.apk.

All releases on GitHub — check here for newer versions.

Step 2: Connect your Karoo

  1. Plug your Karoo into your computer with a USB cable
  2. On the Karoo screen, swipe down from the top and tap the USB notification
  3. Select "File Transfer" (not charging only)
  4. Your Karoo will appear as a drive on your computer

Step 3: Copy the file

  1. Open the Karoo drive on your computer
  2. Find or create a folder called Download
  3. Drag velovigil-v0.3.2.apk into that folder
  4. Safely eject the Karoo from your computer

Step 4: Install on the Karoo

  1. On your Karoo, open Settings
  2. Scroll down to System and find File Manager (or use the built-in file browser)
  3. Navigate to Download
  4. Tap velovigil-v0.3.2.apk
  5. If asked to allow installs from unknown sources, tap Allow
  6. Tap Install

veloVigil appears in your Karoo's extension list.

Step 5: Allow the permission, then register

  1. Open the veloVigil extension and tap Settings
  2. It asks for a permission on first open. Karoo 2: Location. Karoo 3: Nearby devices and Location. Tap Allow. Without this the H10 scan never runs and every ride records HR 0 — this was the April beta bug, fixed in 0.2.4
  3. If no prompt appears: Karoo Settings → Apps → veloVigil → Permissions, turn them on there
  4. Back in veloVigil Settings, paste your invite code into Invite Code and tap Register with Invite Code
  5. Your Rider ID appears on that screen (rider_…). Write it down — it is your dashboard address

Step 6: Pair your Polar H10

  1. Put on your heart rate strap (wet the electrodes if it's a chest strap)
  2. On your Karoo, go to Settings → Sensors → Scan for Devices
  3. You'll see "veloVigil HR" with a puzzle piece icon
  4. Tap it to pair

Polar H10 users: If your H10 is already paired to the Karoo as a regular sensor, remove it from the Karoo's sensor list first. This frees up the Bluetooth connection so veloVigil can connect directly for HRV and accelerometer data. You'll still see your heart rate - veloVigil provides it back to the Karoo.

Step 7: Add data fields to your ride screen

  1. Go to your ride profile on the Karoo
  2. Edit your data pages
  3. Look for "Fleet Status" under veloVigil's data fields
  4. Add it to any page

That's it. You're ready to ride.

Next step: Go ride.

Ride for at least 10 minutes with the H10 on. Your dashboard is velovigil-fleet.robert-chuvala.workers.dev/dashboard/<your Rider ID> — you don't need to configure anything.

After your ride, head to velovigil.com/get-coaching for your AI debrief.

What works with which strap

FeatureOther BLE HR strapPolar H10
Heart rate on the Karoo itselfYes (Karoo's own pairing)Yes
Heart rate recorded by veloVigilNo (not yet)Yes
HRV (RMSSD, SDNN, pNN50)NoYes
G-force peak / average / airborneNoYes
Speed, power, cadence, distanceYes (from the Karoo)Yes
Dashboard + markdown for your ClaudeYes, without HRYes
Crash alertDetector runs on-device; no alert or upload wired yet

Troubleshooting

Karoo doesn't show "veloVigil HR" in sensor scan, or the extension says "device isn't ready"

Almost always the permission. Karoo Settings → Apps → veloVigil → Permissions: Location on (Karoo 2), Nearby devices + Location on (Karoo 3). Reopen the extension. If the toggle isn't listed at all, you are on 0.2.3 or older — install 0.2.4, which asks for it.

Install button says "Retry"

Karoo 3 sideload quirk. Tap Retry; it installs on the second or third try.

Dashboard shows HR 0

The H10 wasn't connected through veloVigil during the ride: permission not granted, or the H10 still paired to the Karoo directly. Fix both, ride again.

H10 shows double heart rate readings

Your H10 is paired to the Karoo directly AND through veloVigil. Go to Settings → Sensors and remove the H10 from the Karoo's sensor list. Keep only the veloVigil HR pairing.

HR works but no HRV data

HRV requires a Polar H10 connected through veloVigil (not paired directly to the Karoo). Other heart rate straps don't expose RR interval data over Bluetooth.