A TypeScript library to control WalkingPad treadmills via Web Bluetooth API | Try the Demo

Control your WalkingPad treadmill directly from your browser! This library provides a clean, type-safe API to connect, monitor, and control WalkingPad devices using the Web Bluetooth standard.

• 🔄 Dual Protocol Support — Works with both legacy (A1/R1/P1) and modern (Z1/R2/C2) WalkingPad models
• 🔍 Auto-Detection — Automatically detects the correct protocol for your device
• 💾 Device Memory — Remembers your device for seamless reconnection
• 📊 Real-time Stats — Live speed, distance, time, and step tracking
• 🛡️ Type-Safe — Full TypeScript support with strict type checking
• 🌐 Browser Native — Uses standard Web Bluetooth API, no native dependencies

Enable the experimental flag in Chrome:

1. Open chrome://flags
2. Search for "Experimental Web Platform features"
3. Set to Enabled and relaunch

You may also need Bluetooth permissions:

sudo usermod -a -G bluetooth $USER
sudo systemctl restart bluetooth
# Log out and back in

Grant Chrome Bluetooth access:

1. System Preferences → Security & Privacy → Privacy
2. Select Bluetooth and check Google Chrome

Usually works out of the box. If issues occur:

1. Ensure Bluetooth is enabled in Settings
2. Try chrome://flags → Enable "Experimental Web Platform features"

1. Enable Bluetooth and Location services
2. Grant location permission to Chrome when prompted

npm install walkingpad-js

import { getWalkingPadBLE } from 'walkingpad-js';

const pad = getWalkingPadBLE();

// Listen for state updates
pad.events.on('state', (state) => {
  console.log(`Speed: ${state.speed} km/h`);
  console.log(`Distance: ${state.distance} km`);
  console.log(`Time: ${state.time} seconds`);
  console.log(`Steps: ${state.steps}`);
});

// Handle errors
pad.events.on('error', (error) => {
  console.error('Error:', error.message);
});

// Connect to device (opens browser device picker)
await pad.connect({ rememberDevice: true });

// Control the treadmill
await pad.start();
await pad.setSpeed(3.5); // km/h
await pad.stop();

// Disconnect when done
await pad.disconnect();

For detailed API reference, advanced configuration options, and more examples, see the Technical Documentation.

git clone https://github.com/Mwea/walkingpad-js.git
cd walkingpad-js
npm install
npm test

This project is licensed under CC BY-NC-SA 4.0.

• Attribution — Give appropriate credit
• NonCommercial — Not for commercial purposes
• ShareAlike — Same license for derivatives

• WalkingPad for making great treadmills

Made with ❤️ by Mwea & Claude