audioMotion.js

layout: default
title: Home
nav_order: 1
permalink: /

♪♫ See your music with audioMotion! ♪♫

audioMotion.js is a high-resolution real-time audio spectrum analyzer and full-featured music player written in JavaScript.

The spectrum analyzer module is also available as a standalone project and a zero-dependency npm package you can use in your own JavaScript projects!

Features

• High-resolution (retina / HiDPI ready) real-time audio spectrum analyzer with fullscreen support
• Logarithmic frequency scale with customizable range
• Visualize discrete frequencies with full FFT resolution, or octave bands based on the equal tempered scale
• Optional effects: vintage LEDs, luminance bars, reflection, radial visualization
• 17 beautiful color gradients
• Customizable Web Audio API parameters (FFT size, sensitivity and time-smoothing constant)
• HTML5 audio player supports MP3, AAC (m4a), OGG and FLAC files (support may vary depending on browser)
• Visual file explorer and play queue with drag-and-drop functionality
• Support for M3U playlists (m3u and m3u8 file extensions)
• Visualize audio from your microphone (or "stereo mix", if your soundcard supports it)
• Lightweight custom file server — also works on standard web servers with minimal configuration
• Client runs on any modern browser (tested on Chrome, Firefox, Opera and Safari)

Online demo

DEMO SITE ▶ audioMotion.me/public

The demo allows you to play audio files from your PC, load songs and streams from remote URLs and use the microphone input.
The file explorer is not available, since there are no media files hosted on the demo server.

Also check out our ▶ YouTube channel for videos of some cool songs visualized with audioMotion!

Download

Download the latest version from the releases page. Portable binaries are available for Windows, Linux and macOS.

Launch audioMotion and you'll be asked for the path to your music folder. Only files under that folder will be accessible to the player.

You can also use the command line argument -m to set the music folder when launching audioMotion:

audioMotion -m c:\users\john\music

This will start the server and should also launch the client in your browser.

The complete command line options are:

-m <path> : path to music directory
-p <port> : change server listening port (default is 8000)
-s        : start server only (do not launch client)
-e        : allow external connections (by default, only localhost)

⚠ WARNING:
Please be aware that the -e flag will expose the contents of the mounted folder to anyone in your network (and potentially to the entire internet!) — use it only if you're in a trusted network and behind a firewall!

Documentation

• User interface
• Server modes
• Building audioMotion
• Legacy features

For full documentation summary, see the docs folder.

Screenshots

Discrete frequencies mode. User interface showing the file explorer and play queue.

1/4th-octave bands with LED effect, extra wide bar spacing and on-screen song information. User interface showing the settings panel.

Fullscreen 1/6th-octave bands, regular bar spacing, 30Hz-16KHz, "Outrun" gradient, Reflex effect and complete on-screen information.

Fullscreen Line graph, 20Hz-22KHz, frequency and level scales on, "Rainbow" gradient.

Fullscreen 1/8th-octave bands with Luminance bars effect, 30Hz-16KHz, frequency scale on, "Tie Dye" gradient.

Fullscreen Radial 1/6th-octave bands with frequency scale on, "Apple ][" gradient.

Credits and acknowledgments

audioMotion was largely inspired by Soniq Viewer for iOS, by Yuji Koike.

JavaScript libraries

Some of audioMotion's great features are provided by these awesome open-source libraries:

• express - fast, unopinionated, minimalist web framework for node
• music-metadata-browser - stream and file based music metadata parser for the browser
• notie - clean and simple notification, input, and selection suite for javascript, with no dependencies
• open - open stuff like URLs, files, executables
• pkg - single-command Node.js binary compiler
• readline-sync - synchronous Readline for interactively requesting user input via console
• scrollIntoViewIfNeeded 4 everyone - polyfill for non-standard scrollIntoViewIfNeeded() method
• sortablejs - JavaScript library for reorderable drag-and-drop lists
• webpack - JavaScript module bundler for the browser
  • mini-css-extract-plugin - extracts CSS into separate files
  • optimize-css-assets-webpack-plugin - a webpack plugin to optimize / minimize CSS assets
  • terser-webpack-plugin - JavaScript compressor

Graphic resources

• Gradients Candy, Miami, Outrun and Tie Dye from Gradient Hunt
• Gradients Pacific Dream, Shahabi, Summer and Sunset from uiGradients
• The Apple ][ gradient was created based on this post by Creative Market
• Gradients used in the UI buttons are from ColorZilla's Ultimate CSS Gradient Generator
• The audioMotion logo uses the Orbitron font by Matt McInerney
• Icons provided by icons8 licensed under Creative Commons Attribution-NoDerivs 3.0 Unported

References

These online references were invaluable for the development and improvement of audioMotion:

• HTML Canvas Reference @W3Schools
• Web Audio API documentation @MDN
• Web Audio API Specification
• What does the FFT data in the Web Audio API correspond to?
• HTML5 check if audio is playing?
• Unlocking Web Audio — the smarter way
• Equations for equal-tempered scale frequencies
• Efficient case-insensitive sorting in JavaScript
• Fastest way to find the index of a child node in parent

License

audioMotion.js copyright (c) 2018-2020 Henrique Avila Vianna
Licensed under the GNU Affero General Public License, version 3 or later.