Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > OpenKatana > OpenKatana · Analyze audio

ComfyUI Node: OpenKatana · Analyze audio

Class Name

OpenKatana_analyze_audio

Category
OpenKatana/Tools
Author
rk0neki (Account age: 235days)
Extension
OpenKatana
Latest Updated
2026-11-05
Github Stars
0.05K

How to Install OpenKatana

Install this extension via the ComfyUI Manager by searching for OpenKatana
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter OpenKatana in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

OpenKatana · Analyze audio Description

Analyzes audio tempo, beats, onsets, and loudness to guide beat-synced visuals and edits.

OpenKatana · Analyze audio:

OpenKatana_analyze_audio examines the rhythm, timing, and energy of an audio recording so you can plan visuals around its musical structure. It estimates tempo, locates beats and likely bar beginnings, detects sudden sound attacks such as percussion hits, and identifies changes in level and silent passages. Its analysis compares changes across the sound spectrum, including a separate focus on low frequencies below 150 Hz, to find rhythmic accents rather than relying on volume alone. It also compares competing tempo interpretations, helping you recognize cases where a recording could reasonably be counted at half or double the selected speed. Loudness measurements provide additional information about the recording’s overall level and dynamic variation. These capabilities are useful for planning beat-synchronized edits, animation accents, and changes in visual intensity, although rhythmic estimates should be checked against the recording, especially for music with irregular timing or weak percussion.

OpenKatana · Analyze audio Input Parameters:

project_id

A required STRING supplied to the tool’s argument-building step to provide project context for the analysis request. The node passes this value together with the tool name and your arguments before invoking the tool; the supplied code does not show how project identifiers are created, validated, or used to resolve files. Use the identifier associated with the project you intend to work in rather than assuming this field is an audio filename. No default value, allowed identifier format, enumerated options, or minimum and maximum string lengths are specified in the provided interface.

arguments

A required STRING containing the tool arguments that are processed before the analysis tool is invoked. This is the node’s argument channel: the authoritative interface does not expose separate audio-path, tempo, duration, or frame-rate controls. The underlying analysis function accepts an audio path and supports a start position, an optional duration, an optional frame rate, and a beats-per-bar setting; its function defaults are start = 0.0 seconds, duration = None, fps = None, and beats_per_bar = 4. These are analysis-function defaults, not declared defaults for this STRING input. The supplied code does not include the tool’s argument schema or parser, so it does not establish the exact text format or field mapping you must use here. Follow the registered tool’s argument specification when supplying these settings. No default string, minimum or maximum length, or selectable options are shown for this input.

after

An optional STRING accepted by the node, with an execution-method default of None when omitted. In the supplied implementation, this value is not referenced in the method body and is not explicitly forwarded to the argument builder or tool invocation. Consequently, the shown code does not establish any effect on audio analysis, result timing, or execution dependencies; do not assume that entering a value here schedules the analysis after another operation. No string-format requirements, selectable options, or minimum and maximum lengths are provided.

OpenKatana · Analyze audio Output Parameters:

result_json

The node’s single STRING output carries the tool response through a response-formatting function. Its name indicates a JSON response, but the supplied code does not show the formatter or tool wrapper, so the exact outer structure is not established. The underlying analyzer produces a structured report containing the analyzed duration, source offset, tempo in beats per minute, beat period, phase, tempo confidence, up to six tempo candidates, beat-grid fit information, beat times, likely downbeat times, and downbeat confidence. It also reports ordinary, strong, and low-frequency onset times, section-level information, detected silence, and loudness measurements. A downbeat is the likely first beat of a bar, while an onset is a sudden sound attack that does not necessarily coincide with a beat. Timing values are measured in seconds from the beginning of the analyzed window; add source_offset_s to obtain positions in the original recording. The tempo confidence is a relative score calculated from candidate scores, not a calibrated probability of correctness. The octave information compares half-speed and double-speed tempo interpretations and includes an ambiguity indicator. Section records contain start and end times, level labels of loud, mid, or quiet, level differences, and a matching beat index where one is found; these labels describe relative energy, not confirmed musical structures such as verses or choruses. Loudness information includes integrated loudness I in LUFS, loudness range LRA in LU, and true peak TP in dBTP, with unavailable parsed measurements represented as null. When a truthy fps value is supplied to the analyzer, the report additionally includes fps, beat_frames, downbeat_frames, and strong_onset_frames, calculated by rounding each window-relative time multiplied by the frame rate and clamping the result to zero or above.

OpenKatana · Analyze audio Usage Tips:

  • Use the tool’s registered argument specification to construct arguments. Do not add separate ComfyUI inputs named path, start, duration, fps, or beats_per_bar: they are not exposed by this node’s interface.
  • For a specific scene or musical passage, use the supported analysis-window settings through the tool’s argument schema. The underlying analyzer supports starting at an offset and limiting the duration, allowing you to focus on the passage you actually intend to synchronize.
  • Keep the timing reference consistent. If analysis begins 30 seconds into a recording, a reported beat at 2 seconds corresponds to 32 seconds in the original source. Apply source_offset_s when placing markers on a source-based timeline.
  • For frame-based animation or editing, supply your intended timeline frame rate if the tool schema exposes the analyzer’s fps setting. The generated frame indices are relative to the analyzed window, not automatically to the original recording’s timeline.
  • Set the analyzer’s beats_per_bar to match the music when that setting is available through the tool. Its default is 4; a different meter requires the appropriate value if you want the grouping of beats into bars to reflect the recording.
  • Check the half-speed and double-speed alternatives before committing to a visual rhythm. The analyzer flags an ambiguous half-speed interpretation when a matching half-tempo candidate has a score greater than 85% of the selected candidate’s score; this is a useful reason to audition both pacing choices.
  • Choose markers according to your creative goal: beats for regular movement, downbeats for bar-level changes, and strong onsets for pronounced accents. Low-frequency onsets can help you inspect bass-heavy attacks, but they are not guaranteed to represent kick drums exclusively.
  • Treat section labels as relative intensity guides. A section is labeled loud when its level is less than 3 dB below the highest section level, mid when it is less than 12 dB below that level but does not meet the loud threshold, and quiet otherwise. These labels do not indicate absolute playback loudness.
  • Use a passage with clear rhythmic activity if tempo detection fails or appears unreliable. The supplied tests confirm that a silent recording fails with a “Too few onsets” error rather than producing a usable tempo estimate.

OpenKatana · Analyze audio Common Errors and Solutions:

No audio stream could be decoded from [filename]

  • Explanation: This is the analyzer’s explicit error when FFmpeg returns a failure or produces no decoded audio samples. The decoder selects the first audio stream, so an inaccessible file, a file without audio, an unreadable recording, or an analysis window containing no decodable audio can cause this failure.
  • Solution: Confirm that the file exists and is readable in the environment running OpenKatana, check that it contains an audio track, and verify that the requested start position is within its playable duration. Try a known working audio file or re-export the recording if necessary. For a file with multiple audio tracks, ensure the intended content is available in the first audio stream.

Too few onsets

  • Explanation: The analyzer could not find enough sound attacks to continue its rhythm analysis. The supplied test explicitly confirms this error for a three-second silent recording. Very sparse audio or a window without clear rhythmic events may also be unsuitable, although the exact detection threshold is not shown.
  • Solution: Listen to the selected passage, move the analysis window away from silence or long fades, and include a longer stretch with clear musical attacks. For ambient or non-rhythmic recordings, avoid assuming that a reliable beat grid can be recovered.

unexpected inputs: [input names]

  • Explanation: The node explicitly raises this TypeError when additional execution fields are not included in its registered typed inputs. The exposed interface for this node consists only of project_id, arguments, and optional after.
  • Solution: Remove unsupported extra fields from custom API calls or workflow integrations. Supply analysis settings through arguments using the tool’s documented schema rather than attempting to create additional node inputs.

FFmpeg executable not found

  • Explanation: The exact message depends on your operating system, but a missing executable can produce a file-not-found error when the analyzer attempts to run ffmpeg. Both audio decoding and loudness measurement call this external program.
  • Solution: Install FFmpeg in the environment where ComfyUI and OpenKatana run, and make sure the ffmpeg command is available to that process. If you use a container or virtual environment, check availability there rather than only on your host computer, then restart the application if needed.

Argument validation or parsing failure

  • Explanation: The node processes arguments before calling the tool, but the supplied context does not show the parser, required tool fields, or exact validation messages. An incorrectly structured argument string or missing required tool information can therefore fail before audio analysis begins.
  • Solution: Compare your argument string with the registered specification for the analysis tool, checking its required fields, spelling, and value types. Do not assume that the underlying Python function signature alone defines the accepted tool-request format.

OpenKatana · Analyze audio Related Nodes

Go back to the extension to check out more related nodes.
OpenKatana
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

OpenKatana · Analyze audio