GitHub release GitHub Release Date

♪♫ 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!


  • High-resolution (retina / HiDPI ready) real-time audio spectrum analyzer with fullscreen support
  • Logarithmic frequency scale with customizable range
  • 12 visualization modes: visualize discrete frequencies, or octave bands based on the equal tempered scale
  • 17 beautiful color gradients, with optional vintage LEDs and variable luminance effects
  • 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 with Firefox, Chrome and Safari)

Online demo


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 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)

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!


For full documentation summary, see the docs folder.


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

1/12th-octave bands mode with LED effect and on-screen song information. User interface showing the settings panel. screenshot2

Full screen view: 1/6th-octave bands, Regular bar spacing, 30Hz-16KHz, “Outrun” gradient, Reflex effect and complete on-screen information. screenshot3

Full screen view: Area fill mode, 20Hz-22KHz, frequency scale on, “Rainbow” gradient. screenshot4

Full screen view: 1/8th-octave bands mode with Luminance bars effect, 30Hz-16KHz, frequency scale on, “Tie Dye” gradient. screenshot5

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:

Graphic resources


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


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