Naughty Pinching Mannequins

    TypeScript icon, indicating that this package has built-in type declarations

    2.1.0 • Public • Published

    NativeScript Pedometer plugin

    Supported platforms

    • iOS 8 (the newer the OS the more features are available)
    • Android, any device with a step counter sensor


    From the command prompt go to your app's root folder and execute:

    tns plugin add nativescript-pedometer

    Demo app

    Want to dive in quickly? Check out the demo app! Otherwise, continue reading.

    You can run the demo app from the root of the project by typing npm run demo.ios.device and you'll see this:



    The key feature of this plugin is counting steps. And it's also the only feature that Android supports.

    // require the plugin
    import { Pedometer } from "nativescript-pedometer";
    // instantiate the plugin
    let pedometer = new Pedometer();
    pedometer.isStepCountingAvailable().then(avail => {
      alert(avail ? "Yes" : "No");
    // require the plugin
    var Pedometer = require("nativescript-pedometer").Pedometer;
    // instantiate the plugin
    var pedometer = new Pedometer();
    pedometer.isStepCountingAvailable(function(avail) {
      alert(avail ? "Yes" : "No");

    Providing only TypeScript examples from here on out, but usage it largely similar. Also, I'm leaving out the Promises where they don't add clarity to the code sample.


    To start receiving step count updates from this moment forward you can invoke startUpdates. If you want historic data on iOS, pass in a custom fromDate.

      fromDate: new Date(), // iOS only. Optional, default: now
      onUpdate: result => {
        // see the table below
        console.log(`Pedometer update: ${JSON.stringify(result)}`);
    }).then(() => {
      console.log("Pedometer updates started.");
    }, err => {
      console.log("Error: " + err);

    The onUpdate callback receives an object containing these properties:

    Property iOS? Android? Description
    startDate This is when recording of the currently returned data was started.
    endDate This is when recording of the currently returned data was ended (usually: now).
    steps Step count between startDate and endDate
    distance ◻️ The distance covered in meters between startDate and endDate.
    floorsAscended ◻️ The number of floors ascended between startDate and endDate.
    floorsDescended ◻️ The number of floors descended between startDate and endDate.
    currentPace ✅ iOS9+ ◻️ The current pace in seconds per meter.
    currentCadence ✅ iOS9+ ◻️ The current cadence in steps per second.
    averageActivePace ✅ iOS10+ ◻️ The average pace while active in seconds per meter between startDate and endDate.

    If you want to check beforehand if things like currentPace are available, there's a few functions similar to isStepCountingAvailable that you can invoke:

    • isDistanceAvailable
    • isFloorCountingAvailable
    • isPaceAvailable
    • isCadenceAvailable


    You can wire up a Promise but there's no real need.


    query (iOS)

    Instead of listening to "live" updates you can query historic data:

      fromDate: new Date(new Date().getTime() - (1000 * 60 * 60)),
      toDate: new Date() // default
    }).then(result => {
      // see the table at 'startUpdates' above
      console.log(`Pedometer update: ${JSON.stringify(result)}`);

    startEventUpdates (iOS)

    From iOS 10 onwards it's possible to get notified whenever the device detects a switch between a 'paused' and 'resumed' state (so starting/stopping walking).

    To check beforehand whether or not this feature is availbe, call isEventTrackingAvailable (which has a similar API to isStepCountingAvailable).

      onUpdate: result => {
        // see the table below
        console.log("Pedometer event update: " + JSON.stringify(result));
    }).then(() => {
      console.log("Pedometer event updates started.");

    The onUpdate callback receives an object containing these properties:

    Property Description
    date The moment the event occured.
    type Either "pause" or "resume".


    • 2.0.0 Android support added.
    • 1.0.0 Initial release, iOS only, but full featured.


    npm i nativescript-pedometer

    DownloadsWeekly Downloads






    Unpacked Size

    22.2 kB

    Total Files


    Last publish


    • eddyverbruggen