Categories

Audio Goniometer

Render a polar stereo image to visualize width and panning

Uses FFmpeg avectorscope in polar mode for a goniometer-style display.

Click to upload file or drag and drop file here

Maximum file size: 200MB Supported formats: audio/*

Key Facts

Category
Media
Input Types
file, text, select, number
Output Type
file
Sample Coverage
4
API Ready
Yes

Overview

The Audio Goniometer tool generates a polar stereo image to visualize the width and panning of audio signals. It uses FFmpeg's avectorscope in polar mode for a clear goniometer-style display, ideal for audio analysis and mixing.

When to Use

  • When you need to check the stereo balance of an audio mix for proper imaging.
  • For visualizing panning effects in stereo audio files during production or mastering.
  • In educational settings to demonstrate stereo field concepts using audio examples.

How It Works

  • Upload an audio file in a supported format, such as MP3 or WAV.
  • Optionally configure settings like image size, draw mode (dot, line, or anti-aliased line), and zoom level.
  • The tool processes the audio using FFmpeg's avectorscope filter in polar mode to create the visualization.
  • Download the resulting polar stereo image file for analysis or reference.

Use Cases

Audio engineers analyzing stereo mixes to identify balance issues or phase problems.
Music producers verifying the panning of individual tracks in a multitrack session.
Educators creating visual aids for teaching stereo imaging and audio spatialization.

Examples

1. Analyzing Stereo Balance in a Music Mix

Audio Engineer
Background
An audio engineer is finalizing a stereo mix and needs to ensure the overall balance is even across the stereo field.
Problem
Quickly visualize the stereo width and panning to detect any imbalances or mono elements.
How to Use
Upload the mixed audio file, set the draw mode to 'Anti-aliased Line' for clarity, and generate the image with a size of 800 pixels.
Example Config
size: 800, drawMode: aaline, zoom: 1
Outcome
The goniometer image shows a symmetric spread, confirming a well-balanced stereo mix with appropriate panning.

2. Verifying Panning Effects in a Podcast

Podcast Producer
Background
A podcast producer has added sound effects with left-right panning and wants to check the effect before publishing.
Problem
Ensure that panned audio elements are correctly positioned and not causing phase issues.
How to Use
Upload the podcast audio file, use default settings or adjust zoom for a closer look, and review the generated polar image.
Outcome
The image reveals clear panning of sound effects, allowing the producer to confirm the spatial effects are as intended.

Try with Samples

image, audio, file

Related Hubs

FAQ

What audio file formats are supported?

The tool accepts common audio formats compatible with FFmpeg, such as MP3, WAV, and AAC, up to 200 MB in size.

How do I interpret the goniometer image?

The polar plot shows the stereo field; points near the center represent mono signals, while spread indicates stereo width and panning.

Can I customize the image appearance?

Yes, you can adjust the image size, choose between dot, line, or anti-aliased line draw modes, and set a zoom level from 0.1 to 10.

What is the purpose of the draw mode options?

Draw mode affects how audio data is plotted: dots for discrete points, lines for continuous traces, or anti-aliased lines for smoother visuals.

Is there a limit on audio file length?

The tool focuses on file size (up to 200 MB) rather than length, but longer files may take more time to process.

API Documentation

Request Endpoint

POST /en/api/tools/audio-goniometer

Request Parameters

Parameter Name Type Required Description
audioFile file (Upload required) Yes -
size text No -
drawMode select No -
zoom number No -

File type parameters need to be uploaded first via POST /upload/audio-goniometer to get filePath, then pass filePath to the corresponding file field.

Response Format

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
File: File

AI MCP Documentation

Add this tool to your MCP server configuration:

{
  "mcpServers": {
    "elysiatools-audio-goniometer": {
      "name": "audio-goniometer",
      "description": "Render a polar stereo image to visualize width and panning",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=audio-goniometer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

Supports URL file links or Base64 encoding for file parameters.

If you encounter any issues, please contact us at [email protected]