♪♫ 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
- Fullscreen support at up to 60 frames per second
- Logarithmic frequency scale with customizable range
- Visualize discrete frequencies, or octave bands based on the equal tempered scale
- Several color gradients with optional vintage LED effect
- Customizable Web Audio API parameters (FFT size, sensitivity and time-smoothing)
- HTML5 audio player for MP3, AAC (M4A), OGG and FLAC files (codec support may vary depending on browser and operating system)
- Visual file explorer and play queue with drag-and-drop functionality
- Support for M3U playlists (
m3uandm3u8file 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)
➡️ https://hvianna.github.io/audioMotion.js/public/
The demo allows you to play audio files from your PC, load songs and streams from a remote URL and use the microphone input. The file explorer is not available in the demo, since there are no media files hosted on that server.
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)
For complete documentation, see the docs folder.
Discrete frequencies mode. User interface showing the file explorer and play queue.
1/12th-octave bands mode with LED effect and on-screen song information. User interface showing the settings panel.
Full screen view: 1/6th-octave bands mode, 30Hz-16KHz, "Outrun" gradient, with complete on-screen information.
Full screen view: Discrete frequencies mode, 20Hz-22KHz, frequency scale on, "Prism" gradient.
audioMotion was largely inspired by Soniq Viewer for iOS, by Yuji Koike.
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
- Gradients Candy, Miami, Outrun and Tie Dye from Gradient Hunt
- Gradients Pacific Dream, Shahabi, Summer and Sunset from uiGradients
- Gradients used in the UI buttons 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
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
audioMotion.js copyright (c) 2018-2019 Henrique Avila Vianna
Licensed under the GNU Affero General Public License, version 3 or later.