Create Stunning Visuals: Integrating Dotted Waveform Videos with lucataco's Cognitive Actions

22 Apr 2025
Create Stunning Visuals: Integrating Dotted Waveform Videos with lucataco's Cognitive Actions

In today’s digital landscape, visualizing audio data can significantly enhance user engagement and understanding. The lucataco/dotted-waveform-visualizer offers an innovative way to generate dotted waveform videos from audio files, allowing developers to easily integrate captivating visual representations into their applications. This blog post will guide you through the capabilities of the Create Dotted Waveform Video action, detailing how to utilize it effectively.

Prerequisites

Before you begin, ensure you have:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic familiarity with making API calls and handling JSON payloads.

Authentication can typically be done by including your API key in the request headers.

Cognitive Actions Overview

Create Dotted Waveform Video

The Create Dotted Waveform Video action enables you to generate a visually appealing video representation of audio data. This action allows customization of various visual elements, including dot size, color, and spacing, as well as the video's dimensions and frame rate.

Input

The input for this action requires the following fields:

  • audioFile: (Required) URI of the input audio file.
  • width: (Optional) Width of the output video in pixels. Default is 1280 (range: 100 - 1280).
  • height: (Optional) Height of the output video in pixels. Default is 720 (range: 100 - 1280).
  • dotSize: (Optional) Size of each dot in pixels. Default is 6.
  • dotColor: (Optional) Color of the dots in hexadecimal format. Default is #00FFFF.
  • dotSpacing: (Optional) Spacing between dots in pixels. Default is 6.
  • maximumHeight: (Optional) Maximum height for visualization as a percentage. Default is 30% (range: 5 - 100).
  • framesPerSecond: (Optional) Frames per second in the output video. Default is 10 (range: 1 - 30).

Example Input:

{
  "width": 1280,
  "height": 720,
  "dotSize": 6,
  "dotColor": "#00FFFF",
  "audioFile": "https://replicate.delivery/pbxt/MOcvx4yzpgKwg6OWSEkVRB8CKyAHIpTU633RR0FpiBYXyC58/perplexity.wav",
  "dotSpacing": 6,
  "maximumHeight": 25,
  "framesPerSecond": 10
}

Output

Upon successful execution, the action returns a URL to the generated dotted waveform video.

Example Output:

https://assets.cognitiveactions.com/invocations/29494a08-4e7e-4cdb-89d3-f0f82234db14/fb582c6a-67e1-4d2b-9e18-4d57f0e8e79b.mp4

Conceptual Usage Example (Python)

Here’s a conceptual Python snippet demonstrating how to call the Create Dotted Waveform Video action:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"  # Hypothetical endpoint

action_id = "48b416f4-43d2-4183-8c60-452c113c25b8"  # Action ID for Create Dotted Waveform Video

# Construct the input payload based on the action's requirements
payload = {
    "width": 1280,
    "height": 720,
    "dotSize": 6,
    "dotColor": "#00FFFF",
    "audioFile": "https://replicate.delivery/pbxt/MOcvx4yzpgKwg6OWSEkVRB8CKyAHIpTU633RR0FpiBYXyC58/perplexity.wav",
    "dotSpacing": 6,
    "maximumHeight": 25,
    "framesPerSecond": 10
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}  # Hypothetical structure
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this code snippet, you will replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload variable constructs the necessary input for the action, and the request is sent to the hypothetical endpoint.

Conclusion

The Create Dotted Waveform Video action from the lucataco/dotted-waveform-visualizer provides a powerful and straightforward way to create engaging audio visualizations. By integrating this action into your applications, you can enhance user interaction and present audio content in a visually appealing manner. Consider exploring different configurations to optimize the video output for your specific use case. Happy coding!

← Back to All Articles