Normally Pleasant Mixture
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



    imperio is an open source JavaScript library that enables developers to build web applications that harness the power of mobile devices communicating sensor and gesture data to other devices in real-time. imperio provides developers an easy-to-use API, configurable middleware to easily set up device communication rules, and automatically initiates optimal data-streams based on browser compatibility with minimal code to get started.

    Check out our website for a glimpse at what is possible with imperio.


    npm version


    Front-end API

    • Sensor event data:
      • Accelerometer
      • Gyroscope
      • Geolocation
    • Gesture event data:
      • Pan
      • Pinch
      • Press
      • Rotate
      • Swipe
      • Tap
    • Peer client ID information
    • Room information

    Real-time Communication

    • Initiate streaming communication using WebSockets
    • Automatically switch to WebRTC DataChannels as appropriate with one line of code


    • Configurable middleware automatically creates and manages data streaming rooms for clients
    • Clients connect with short, randomly generated passwords provided to room initiator
    • Peristent client room connections


    Install via npm:

    npm install --save imperio

    Get Started

    Getting started with imperio is simple: add a few lines in your frontend and server code. Below is some code to get a basic example running. For all available functionality, check out our API docs.

    Check out the full code for the sample implementation here.

    Client Side Implementation

    Use imperio in your client-side code to emit and receive a wide range of sensor and gesture events and data.

    imperio is attached to the window object and is accessible by imperio once you add the script tag to your html files.

    <script src='./dist/imperio.min.js'></script>

    ListenerRoomSetup starts the socket room connection and listens for incoming data from other connected clients. This is generally, but not necessarily, on a desktop/main browser.


    The emitter(s), generally mobile devices, will connect to the room established above.


    The imperio.gesture() method gives developers access to all gesture events on a touch screen enabled device. Check out the API wiki page to see the full suite of features available.

    var swipeBox = document.getElementById('swipe-box');
    imperio.gesture('swipe', swipeBox);

    Server Side Implementation

    imperio provides connection and authentication functionality on the server via an Express middleware.

    npm install --save express

    Just require the module and pass it the server object of your app

    const imperio = require('imperio')(server);

    To correctly route the front-end request for the imperio bundle, include the following static route.


    Include imperio.init() as middleware in your desired express route.

    app.get('/:nonce', imperio.init(),
      (req, res) => {
        if (req.imperio.isDesktop) {
        } else {
          if (req.imperio.connected) {
          } else {

    And that's it! This application will now stream swipe data from client to client, with a just a few lines of front end code and one line of middleware. Now go forth and build awesome things.


    Other examples using imperio can be found in the other repos under the imperio organization and on our example page.






    npm i imperio

    Downloadsweekly downloads








    last publish


    • avatar
    • avatar
    • avatar
    • avatar