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 > FunUI > FunUI Load Media

ComfyUI Node: FunUI Load Media

Class Name

FunUILoadMedia

Category
FunUI/Media
Author
digital-garbage (Account age: 1276days)
Extension
FunUI
Latest Updated
2026-11-03
Github Stars
0.02K

How to Install FunUI

Install this extension via the ComfyUI Manager by searching for FunUI
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter FunUI 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

FunUI Load Media Description

Loads images, videos, and audio from FunUI’s Media bin into ComfyUI with frame controls.

FunUI Load Media:

FunUILoadMedia connects files selected in FunUI’s Media bin to your ComfyUI workflow, allowing you to work with pictures, videos, and audio through a single media-loading node. It retrieves files from FunUI’s media library rather than asking you to enter a file path. For video-based work, it can quickly read just the first frame when you only need a reference picture, or load the video sequence and its soundtrack when motion and sound are needed. Standard full-video loading converts the sequence to 24 frames per second, while optional preparation settings let you configure frame selection, sizing, and cropping. It can also create a plain grey stand-in when no file is selected, helping text-only workflows establish an image size or frame count without requiring reference media.

FunUI Load Media Input Parameters:

media_id

A required STRING identifying a file in FunUI’s media library, with a default value of an empty string, "". FunUI normally supplies this identifier from your Media bin selection before the workflow runs; it is not a file name or filesystem path that you need to type manually. The node removes surrounding whitespace and checks that the identifier refers to a library entry classified as an image, video, or audio file. A missing or deleted entry causes an error. An empty identifier is accepted only when both blank_width and blank_height are greater than zero, in which case the node creates a grey stand-in instead of loading a file. No minimum length, maximum length, or fixed list of string options is specified.

blank_width

An optional INT controlling the width, in pixels, of the grey stand-in created when no media is selected. The default is 0, the minimum is 0, and the maximum is 16384. Both this value and blank_height must be greater than zero for the stand-in to be created; leaving either dimension at 0 means an empty media selection will produce an error. This setting has no effect when a nonempty media_id is supplied, including when that identifier is invalid. Use it to establish the intended image dimensions for a workflow that starts without a reference file, while keeping in mind that larger dimensions require more memory.

blank_height

An optional INT controlling the height, in pixels, of the grey stand-in created when no media is selected. The default is 0, the minimum is 0, and the maximum is 16384. It works together with blank_width: both dimensions must be positive before the node can create a replacement picture. For example, a width of 1024 and a height of 576 create a landscape stand-in at that resolution. This setting does not resize selected media and does not replace a missing library entry when a nonempty identifier is provided.

blank_frames

An optional INT specifying how many repeated grey frames to create when no media is selected and valid blank dimensions are provided. The default is 0, the minimum is 0, and the maximum is 100000. Values of 0 or 1 both produce one frame; values greater than 1 create a sequence containing that many identical grey frames. The single-picture result remains one image regardless of this setting. This parameter does not change the length of selected videos and does not depend on full being enabled. Increasing the frame count increases memory use, especially at large blank dimensions.

full

An optional BOOLEAN with a default of False and options False or True. For a video, False reads only its first frame and supplies a silent audio placeholder, avoiding the cost of decoding the entire clip. Setting it to True loads the video sequence and available soundtrack; with an empty prepare setting, the sequence is converted to 24 frames per second while keeping its decoded dimensions. Nonempty preparation settings are applied only when this option is enabled for a video. This switch does not prevent a selected audio file from being loaded, and it does not turn a still picture into a multi-frame sequence.

prepare

An optional STRING containing video-preparation settings as JSON, with a default of an empty string, ""; no string-length limits are specified. It is used only for video files when full is True, and whitespace-only text is treated as empty. Supported keys listed by the node are fps, skip_first, cut_last, every_nth, frame_cap, width, height, fit, crop_left, crop_right, crop_top, crop_bottom, and multiple_of. These settings control video preparation, including frame rate, frame selection, size, and cropping; fit accepts crop, pad, or stretch, and the directional crop settings are percentages. The supplied source does not specify individual defaults, numeric limits, or units for every preparation key. For example, {"fps": 24, "width": 512, "height": 512, "fit": "pad"} requests a 24-fps preparation at a square target size using padding. Leaving this input empty loads the full sequence at 24 fps without changing its size. Prepared loading also cuts available audio to the time interval returned by video preparation. Invalid JSON or preparation that leaves no usable frames can cause an error; use a JSON object with double-quoted keys.

FunUI Load Media Output Parameters:

image

An IMAGE containing one picture: the loaded still image, the first decoded frame of a video, or the first prepared frame when video preparation is enabled. This is the result to use when your workflow needs a reference picture or a source of image dimensions rather than a motion sequence. When the node creates a blank stand-in, this output contains one grey picture at your requested dimensions. For an audio-only file, it contains a 64-by-64 grey placeholder rather than visual content from the sound. Images are represented as a batch with dimensions ordered as image count, height, width, and color channels; the grey placeholders use three color channels with a value of 0.5.

frames

An IMAGE containing a sequence of frames, represented as an image batch rather than an encoded video file. For a video with full enabled and no preparation settings, it contains frames selected at 24 fps; existing source frames are repeated or skipped as needed, rather than new in-between images being generated. With preparation enabled, it contains the prepared sequence. When full is disabled for a video, it contains only the first frame, and a loaded still image likewise produces a one-image batch. For a blank stand-in, it contains the requested number of repeated grey frames, with a minimum of one. An audio-only file produces a single 64-by-64 grey placeholder. Connect this output to a workflow that accepts image batches for video processing, and ensure any downstream frame-rate setting matches your intended playback rate.

audio

An AUDIO containing the decoded sound from an audio file or, when full is enabled for a video, its available soundtrack. Prepared video loading cuts available audio to the time interval returned by preparation. If sound is unavailable or not requested, such as when loading a still image, reading only a video’s first frame, or generating a blank stand-in, this output supplies a silent placeholder. That placeholder contains a waveform of shape (1, 1, 1) at a sample rate of 44100 Hz: it is a single silent sample, not a silent track matching the video’s duration. The AUDIO value contains waveform data and a sample rate for downstream audio processing; the placeholder’s 44100 Hz rate does not imply that all loaded audio is converted to that rate.

FunUI Load Media Usage Tips:

  • Select your file in FunUI’s Media bin instead of entering a file path into media_id. If a previously selected file has been removed, select another library item before running the workflow.
  • Keep full set to False when you only need a video’s first frame as a reference picture. This avoids decoding the whole clip and is particularly helpful with long videos.
  • Enable full when you need motion frames or a video soundtrack. With prepare left empty, configure downstream video playback or encoding for 24 fps to match the frame sequence produced by this node.
  • Use prepare only with full enabled for video. Start with a small JSON object such as {"fps": 24, "width": 512, "height": 512, "fit": "pad"}, then add other supported settings as needed.
  • To start without reference media, leave media_id empty and set both blank dimensions above zero. For example, blank_width of 512, blank_height of 512, and blank_frames of 16 produce one grey reference picture and a batch of 16 grey frames.
  • Keep blank sizes and frame counts modest while testing. Their allowed maximum values are interface limits, not a guarantee that your machine can hold the resulting image batch in memory.
  • For audio-only workflows, use audio and ignore the picture outputs: their grey placeholders do not represent an album cover, waveform image, or visualization.
  • Do not treat the silent placeholder as a duration-matched soundtrack. If your workflow requires silence lasting as long as a video, create that audio separately downstream.

FunUI Load Media Common Errors and Solutions:

FunUI Load Media: nothing is picked for this input. Choose a file in the Media bin.

  • Explanation: The media identifier is empty or contains only whitespace, and both blank dimensions have not been set to positive values.
  • Solution: Select a file in the Media bin. For an intentional no-reference workflow, leave the selection empty and set both blank_width and blank_height above zero; setting only blank_frames is not sufficient.

FunUI Load Media: media '…' is not in the library any more -- it may have been deleted. Pick another.

  • Explanation: The supplied identifier no longer resolves to a library entry and its associated path. This can happen after media is removed or when an incorrect identifier is supplied.
  • Solution: Select an existing file in the Media bin or upload the file again and select the new entry. Blank dimensions do not override an invalid nonempty identifier.

FunUI Load Media: '…' is …, which is not a picture, a video or sound.

  • Explanation: The library entry is not classified as image, video, or audio, so the node cannot handle it as supported media.
  • Solution: Select a picture, video, or audio entry. If your intended media was classified as another file type, check that the file is valid and upload a supported version.

FunUI Load Media: could not read '…'.

  • Explanation: The node could not obtain usable content from the selected file. For audio, decoding returned no usable sound or raised an error; for image or full-video loading, no usable image frames may have been returned.
  • Solution: Check whether the file opens in an image viewer or media player. Try uploading a fresh copy, or re-export the media into a format your installation can decode.

FunUI Load Media: could not read '…' (…).

  • Explanation: Reading or preparing the file raised an underlying decoding or processing exception. The text in parentheses provides the available technical detail, which may help identify damaged content or a decoding problem.
  • Solution: Read the parenthesized detail, test the file outside FunUI, and try a fresh upload or re-export. For video, try full=False to check whether its first frame can be read, then test full=True with an empty prepare value to distinguish basic loading problems from preparation problems.

FunUI Load Media: '…' cannot be prepared (…).

  • Explanation: Video preparation raised a value or type error. The source specifically identifies malformed JSON and a cut that leaves no usable content as possible causes.
  • Solution: Check that prepare is valid JSON with double-quoted keys and no trailing commas. Start by leaving it empty, then add settings gradually. If you use trimming or frame-selection settings, make them less restrictive so that at least one usable frame remains.

Memory allocation failure while loading or creating frames

  • Explanation: This is a possible runtime failure rather than a custom error message defined by the node. Full-video loading or a large blank frame batch can require more memory than your system has available.
  • Solution: Use full=False when a reference picture is enough. Reduce blank dimensions or blank_frames for generated stand-ins. For full-video work, use a shorter source clip or preparation settings that reduce the requested size or frame count.

FunUI Load Media Related Nodes

Go back to the extension to check out more related nodes.
FunUI
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.

FunUI Load Media