| Node | Inputs | Outputs | Description | | --- | --- | --- | --- | | Image > Base64ToImage | base64 (STRING) | IMAGE (IMAGE) | Decodes a base64 encoded image string into an image. | | Image > ImageToBase64 | image (IMAGE) | BASE64 (STRING) | Encodes an image into a base64 string (PNG). |

Notes

Base64ToImage expects a raw base64 string, without a data:image/...;base64, prefix. Any format Pillow can read is accepted. The image is always converted to RGB, so alpha channels are discarded.
ImageToBase64 encodes only the first image of the incoming batch. The output is a raw PNG base64 string with no data URI prefix.

Audio

| Node | Inputs | Outputs | Description | | --- | --- | --- | --- | | Audio > Base64ToAudio | base64 (STRING) | AUDIO (AUDIO) | Decodes a base64 encoded audio string into an audio. | | Audio > AudioToBase64 | audio (AUDIO), format (wav / flac / mp3 / opus) | BASE64 (STRING) | Encodes an audio into a base64 string in the selected format. |

Notes

Base64ToAudio expects a raw base64 string, without a data:audio/...;base64, prefix. Decoding is done with PyAV, so any audio format FFmpeg can read is accepted (WAV, FLAC, MP3, Ogg/Opus, AAC/M4A, etc.). Only the first audio stream is used, and the sample rate and channels are preserved.
AudioToBase64 encodes only the first audio of the incoming batch, with no data URI prefix. Samples are clamped to [-1, 1]. wav is 16-bit PCM, flac is lossless, mp3 keeps the input sample rate (which must be one MP3 supports, e.g. 16, 22.05, 44.1 or 48 kHz), and opus is an Ogg file resampled to 48 kHz.

Filesystem

| Node | Inputs | Outputs | Description | | --- | --- | --- | --- | | Filesystem > DeleteInputFile | filename (dropdown), passthrough (any, optional) | PASSTHROUGH (any) | Deletes a file from ComfyUI's input directory. |

Notes

DeleteInputFile offers a dropdown of every file in ComfyUI's input directory, including subdirectories (e.g. nested/image.png). The list is refreshed when the node definitions are reloaded (e.g. with the Refresh button). The filename is resolved relative to the input directory. Paths that resolve outside the input directory, including .. segments, absolute paths and symlinks pointing elsewhere, are rejected. An error is raised if the file does not exist or is a directory.
The optional passthrough accepts any type and is returned unchanged (None if nothing is connected). Use it to control execution order: connect the output of the node that reads the file (e.g. LoadImage) to delete the file only after it has been loaded, and chain PASSTHROUGH into downstream nodes that should only run once the file is gone.

Installation

ComfyUI Manager / Comfy Registry

Search for ComfyUI-SimpleUtils in ComfyUI Manager, or install it with the Comfy CLI:

comfy node install comfyui-simpleutils

Manual

Clone the repository into your ComfyUI custom_nodes directory and restart ComfyUI:

cd ComfyUI/custom_nodes
git clone https://github.com/moonstar-x-libs/ComfyUI-SimpleUtils.git

The only dependencies are av, numpy, pillow and torch, which ComfyUI already ships with.

Development

This project uses uv for dependency management and Poe the Poet as a task runner. The Python version is pinned in .python-version.

# Install the project along with the dev dependencies
uv sync --all-extras

# Install the pre-commit hooks (ruff + black)
uv run pre-commit install

Tasks

| Command | Description | | --- | --- | | uv run poe lint | Lint with Ruff. | | uv run poe lint-fix | Lint with Ruff and apply automatic fixes. | | uv run poe format | Check formatting with Black. | | uv run poe format-fix | Format the code with Black. | | uv run poe test | Run the test suite with pytest. | | uv run poe test-coverage-run | Run the test suite with coverage. | | uv run poe test-coverage-lcov | Generate an lcov.info coverage report. |

Project Structure

.
├── __init__.py              # ComfyUI entry point, exports the node mappings
├── src
│   ├── node_mappings.py     # Aggregates the mappings of every node group
│   ├── nodes
│   │   ├── audio            # Audio nodes and their mappings
│   │   ├── filesystem       # Filesystem nodes and their mappings
│   │   └── image            # Image nodes and their mappings
│   └── utils                # Shared helpers (e.g. tensor/audio <-> base64 conversion)
└── tests                    # pytest suite, mirroring the src layout

To add a new node, create its class under src/nodes/<group>/, register it in that group's NODE_CLASS_MAPPINGS and NODE_DISPLAY_NAME_MAPPINGS, and make sure the group's mappings are merged in src/node_mappings.py.

CI

GitHub Actions run linting, formatting checks and tests on every push and pull request to main, followed by a backwards compatibility check with node-diff. Publishing a release runs the same checks and then publishes the node to the Comfy Registry.

License

This project is licensed under the MIT License.