0.11.0 • Public • Published

Cylon.js For Audio

Cylon.js ( is a JavaScript framework for robotics, physical computing, and the Internet of Things.

This repository contains the Cylon adaptor for Audio playback. The implementation uses the node-mpg123 node module from @maciek134. Thank you!

Want to use Ruby on robots? Check out our sister project Artoo (

Want to use the Go programming language to power your robots? Check out our sister project Gobot (

Build Status Code Climate Test Coverage

How to Install

Install the module with:

$ npm install cylon cylon-audio

Prerequisites for OSX

$ brew install mpg123    

Prerequisites for Ubuntu

$ sudo apt-get install mpg123

Prerequisites for Windows

Download and install the latest release for Windows from

Special instructions for Intel Edison

You need to install the various dependencies before you can install cylon-audio on your Intel Edison. First, make sure you have updated to the very latest Edison firmware.

Then, add these lines to your /etc/opkg/base-feeds.conf file:

src/gz all
src/gz edison
src/gz core2-32

And then run:

opkg update
opkg install mpg123

How to Use

Using the cylon-audio module is pretty easy, pretty much just install the npm module and you are good to go, use it as you would any other device passing along the audio you wish to reproduce. To play audio, pass a full or relative path to the play function. See the example below for further details.

"use strict";
var Cylon = require("cylon");
  connections: {
    audio: { adaptor: "audio" }
  devices: {
    sound: { driver: "audio", file: "./audio_samples/audio-sample.mp3" }
  work: function(my) {;


We're busy adding documentation to our web site at please check there as we continue to work on Cylon.js

Thank you!


For our contribution guidelines, please go to

Release History

For the release history, please go to


Copyright (c) 2014-2016 The Hybrid Group. Licensed under the Apache 2.0 license.

Package Sidebar


npm i cylon-audio


Weekly Downloads






Last publish


  • andrewstewart
  • deadprogram
  • edgarsilva