# Afloy Audio Tools Professional audio editing nodes for [ComfyUI](https://github.com/comfyanonymous/ComfyUI) — trim, measure, and inspect audio without leaving your workflow. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE) [![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org) [![ComfyUI](https://img.shields.io/badge/ComfyUI-compatible-8A2BE2?style=flat-square)](https://github.com/comfyanonymous/ComfyUI) ![Afloy Audio Trim — interactive waveform](docs/trim_audio_preview.png)

## Contents - [Installation](#installation) - [Quick Start](#quick-start) - [Nodes](#nodes) - [Afloy Audio Trim](#afloy-audio-trim) - [Afloy Audio Duration](#afloy-audio-duration) - [Afloy Audio Info](#afloy-audio-info) - [Requirements](#requirements) - [License](#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**](https://github.com/afloy011-spec/afloy_audio_tools/archive/refs/heads/main.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 ```bash 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**.

## 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](LICENSE).

Name	Type	Description
sample_rate	INT	—
channels	INT	—
total_samples	INT	—
duration_sec	FLOAT	—
info	STRING	—

Afloy Audio Info

Inputs (1)

Outputs (5)