MQTTfy
Back to Resources

Analyzing Real-Time Audio with the Soundscape Widget in MQTTfy

November 21, 2025

Unlocking the World of Sound: A Deep Dive into the Soundscape Widget

In the expanding universe of the Internet of Things (IoT), data comes in many forms beyond simple numbers and text. One of the most information-rich, yet often underutilized, data sources is audio. From monitoring industrial machinery for signs of wear to analyzing environmental noise pollution, understanding the soundscape of an environment can provide invaluable insights. MQTTfy's Soundscape Widget is a powerful tool designed to demystify audio data, transforming raw sound into intuitive, real-time visualizations directly on your dashboard.

This article will guide you through the capabilities of the Soundscape Widget, explain the underlying concepts like Fast Fourier Transform (FFT) and decibels (dB), and provide practical steps on how to use it for various applications, including monitoring audio from a microphone or an MQTT data stream.

A dashboard showing the Soundscape Widget visualizing an audio spectrum

What is a Soundscape and Why Visualize It?

A "soundscape" refers to the total acoustic environment of a particular area, comprising all the sounds—human-made and natural—within it. Analyzing this soundscape can help in:

  • Predictive Maintenance: Detecting subtle changes in the operating sounds of a motor, engine, or pump can predict failures long before they happen. A new whine, a deepening rumble, or a high-frequency vibration can all be early indicators of mechanical trouble.
  • Environmental Monitoring: Tracking noise levels in urban areas, identifying the sources of noise pollution, or studying wildlife by their calls are all made possible through audio analysis.
  • Quality Control: In manufacturing, the sound a product makes can be an indicator of its quality. The click of a switch, the hum of a fan, or the seal of a container can all be monitored for consistency.
  • Security and Safety: Audio sensors can detect anomalies like breaking glass, alarms, or shouts in areas where video monitoring is not feasible or desired.

The Soundscape Widget in MQTTfy takes this complex audio information and presents it in a way that is easy to understand at a glance.

Key Features of the Soundscape Widget

The widget offers two primary visualization modes and can source audio from multiple inputs, making it incredibly versatile.

Visualization Types

  1. Waveform Line: This view shows the amplitude of the audio signal over time, similar to what you might see in audio editing software. It's excellent for observing the overall volume and rhythm of the sound.
  2. Frequency Bars (Spectrogram): This is where the real analytical power lies. The widget uses a Fast Fourier Transform (FFT) to break down the audio signal into its constituent frequencies and displays the intensity of each frequency band as a vertical bar. This allows you to see not just how loud a sound is, but what pitches make up that sound. A low-pitched hum will show activity on the left side of the graph, while a high-pitched squeal will light up the right side.

Audio Sources

  • Browser Microphone (with Bluetooth): The widget can directly access your device's microphone (after you grant permission). This is perfect for quick, on-the-spot analysis of ambient noise or a nearby machine.
  • API Stream: You can configure the widget to play and analyze an audio stream from a URL, such as an internet radio station or a security camera's audio feed.
  • MQTT Topic: For IoT applications, you can have a remote device measure the sound level (in decibels) and publish it to an MQTT topic. The widget can subscribe to this topic and display the dB level as a simple, effective progress bar.

How to Configure the Soundscape Widget

Let's walk through setting up the widget for two common use cases.

Use Case 1: Real-Time Microphone Analysis

This is the quickest way to get started and is ideal for diagnosing a noisy piece of equipment or analyzing the ambient sound in a room.

  1. Add the Widget: From your MQTTfy dashboard, click "Add Widget" and select "Audio Spectrum".
  2. Configure Data Source: In the configuration sheet, set the Data Source Type to Bluetooth. Note: While it seems counterintuitive, this setting is used to signal the widget to request microphone permissions from the browser.
  3. Grant Permission: Once you save the configuration, the widget will appear on your dashboard with a prompt to "Grant Access". Click this button. Your browser will ask for permission to use your microphone.
  4. Adjust Analysis Parameters (Optional):
    • FFT Size: This determines the resolution of the frequency analysis. Larger values (e.g., 2048, 4096) provide more frequency detail but require more processing power. A value of 256 or 512 is a good starting point.
    • Smoothing: This averages the analysis over time, making the visualization less "jumpy" and easier to read. A value around 0.8 is typical.
    • Min/Max Decibels: This adjusts the sensitivity range of the analysis, helping you focus on the most relevant volume levels for your specific environment.

You will now see a real-time visualization of the sound being picked up by your microphone. Try speaking, clapping, or playing music to see how the waveform and frequency bars react.

Use Case 2: Monitoring a Decibel Level from an MQTT Sensor

Imagine you have an ESP32 with a microphone sensor that measures the ambient noise level in a factory and publishes the value in decibels (dB) every 5 seconds to the topic factory/floor1/noise_level.

  1. Add the Widget: Add a new "Audio Spectrum" widget to your dashboard.
  2. Configure Data Source: Set the Data Source Type to MQTT.
  3. Set MQTT Details:
    • Enter your Broker URL and Port.
    • In the Topic field under the "Widget Specifics" section, enter factory/floor1/noise_level.
  4. Adjust Min/Max Decibels: In the widget's specific settings, set the Min Decibels and Max Decibels to match the expected range of your sensor (e.g., 30 dB for a quiet room to 110 dB for loud machinery). This will calibrate the progress bar visualization.
  5. Save and Observe: Save the configuration. The widget will now display a simple bar that fills up according to the decibel level received from your MQTT sensor, providing an immediate visual indicator of the noise level on your factory floor.

Conclusion: From Noise to Knowledge

The Soundscape Widget transforms raw, complex audio signals into actionable visual insights. Whether you're a maintenance engineer listening for the tell-tale signs of a failing bearing, a city planner monitoring urban noise, or a hobbyist creating a sound-reactive art installation, this widget provides the tools you need. By leveraging the power of real-time audio analysis directly on your MQTTfy dashboard, you can add a whole new dimension to your IoT monitoring and control systems, turning what was once just noise into valuable knowledge.