Afloy Audio Tools

Professional audio editing nodes for ComfyUI — trim, measure, and inspect audio without leaving your workflow.

   

Contents

• Installation
• Quick Start
• Nodes
  • Afloy Audio Trim
  • Afloy Audio Duration
  • Afloy Audio Info
• Requirements
• License

---

Installation

Important

This is a single package containing all 3 nodes. You install it once — all nodes appear automatically.

Option A — Download ZIP (easiest)

1. Download ZIP (or click the green button above).
2. Extract the archive — you'll get a folder afloy_audio_tools-main.
3. Move the whole folder into your ComfyUI custom_nodes directory.
4. Restart ComfyUI.

After installation your folder structure should look like this:

ComfyUI/
└── custom_nodes/
    └── afloy_audio_tools-main/  ← the folder you moved
        ├── __init__.py          ← all 3 nodes live here
        ├── web/
        │   └── trim_audio.js
        ├── docs/
        ├── LICENSE
        └── README.md

Option B — Git clone

cd ComfyUI/custom_nodes
git clone https://github.com/afloy011-spec/afloy_audio_tools.git "Afloy Audio Tools"

Restart ComfyUI.

Note

No extra pip packages needed — the nodes use numpy, Pillow, and torch that already ship with ComfyUI. After restart, find all three nodes under Add Node → audio → Afloy Audio Tools.

↑ Back to top

Quick Start

Tip

Use Afloy Audio Trim to trim audio directly inside your workflow.

1. Add an Afloy Audio Trim node and connect audio.
2. Drag start_sec / end_sec markers (or press Tab to switch, I / O to set from cursor).
3. Drag the white scrub cursor to seek; press Space to play / stop (does not re-fetch the file).
4. After you change the file in Load Audio, click Reload in the node toolbar or press F5.
5. Use + / - (or mouse wheel) to zoom, Shift + mouse wheel to scroll.

Widget Features

Feature	Details
Toolbar	Reload (F5), zoom, loop, play — controls stay above the waveform
Waveform	Filled-polygon, classic DAW look
Markers	Draggable start / end with zero-crossing snap
Scrub Cursor	Click to place, drag to seek
Playback	From cursor position, constrained to selection
Region Drag	Grab inside selection to move both markers
Zoom	Up to 50× via + / - buttons or mouse wheel
Scroll	Horizontal with Shift + mouse wheel
Loop	In-node playback with loop toggle
Tooltip	Hover to see time under cursor

Keyboard Shortcuts

Key	Action
F5	Reload waveform from disk (after changing file in Load Audio)
Space	Play / Stop
Shift + ← →	Nudge active marker by 1 s
Tab	Switch active marker (start / end)
I	Set start marker to cursor position
O	Set end marker to cursor position

↑ Back to top

---

Nodes

Note

All three nodes appear under audio → Afloy Audio Tools in the Add Node menu.

Afloy Audio Trim

Interactive audio trimmer with a DAW-style waveform widget.

Inputs

Name	Type	Description
audio	AUDIO	Source audio signal
start_sec	FLOAT	Trim start (seconds)
end_sec	FLOAT	Trim end (-1 = end of file)

Outputs

Name	Type	Description
audio	AUDIO	Trimmed audio segment
waveform_preview	IMAGE	Static waveform image
duration_sec	FLOAT	Segment length in seconds
timecode	STRING	MM:SS.ms timecode

---

Afloy Audio Duration

Returns audio length in multiple formats — useful for syncing with video or animation frames.

Inputs

Name	Type	Description
audio	AUDIO	Source audio signal
fps	FLOAT	Frames per second (default 24)

Outputs

Name	Type	Description
duration_sec	FLOAT	Duration in seconds
duration_sec_int	INT	Rounded duration
frames	INT	Frame count at given FPS
timecode	STRING	MM:SS.ms
sample_rate	INT	Sample rate (Hz)
channels	INT	Mono / Stereo

---

Afloy Audio Info

Diagnostic node — outputs audio metadata as individual values and a human-readable summary.

Inputs

Name	Type	Description
audio	AUDIO	Source audio signal

Outputs

Name	Type	Description
sample_rate	INT	Sample rate in Hz
channels	INT	Number of channels
total_samples	INT	Total sample count
duration_sec	FLOAT	Duration in seconds
info	STRING	Human-readable summary

↑ Back to top

---

Requirements

• ComfyUI — any recent version
• Python — 3.10+
• Extra pip packages — none

License

This project is licensed under the MIT License.