Browser Download:
The BrowserDownload node is designed to facilitate the seamless downloading of images directly to your local machine through your web browser. This node is particularly beneficial for users operating in remote or headless environments, where direct access to the file system might be limited or cumbersome. By automatically triggering a browser download, it ensures that the images you generate or process are conveniently saved to your local Downloads folder, eliminating the need for manual file transfers. This functionality is especially useful for AI artists who work with ComfyUI setups remotely and need an efficient way to retrieve their generated content without navigating complex file systems.
Browser Download Input Parameters:
images
This parameter represents the images you wish to download. It is a required input and serves as the primary content that the node will process and save to your local machine. The images are expected to be in a format compatible with the node's processing capabilities.
filename_prefix
The filename_prefix is a string parameter that allows you to specify a prefix for the filenames of the downloaded images. It supports ComfyUI format strings, such as %date:yyyy-MM-dd%, enabling dynamic and organized naming conventions. The default value is "download", and this parameter helps in categorizing and identifying files easily once downloaded.
format
This optional parameter lets you choose the image format for the downloaded files. Available options include "png", "jpg", and "webp", with "png" being the default. Selecting "jpg" or "webp" can result in smaller file sizes, which may be preferable for faster downloads, especially when dealing with large batches of images.
quality
The quality parameter is an integer that determines the quality of the downloaded images when using the "jpg" or "webp" formats. It ranges from 1 to 100, with a default value of 95. This parameter is ignored for "png" format images. Adjusting the quality can help balance between image fidelity and file size, depending on your needs.
Browser Download Output Parameters:
ui
The ui output parameter is a dictionary that includes the results of the download operation. It contains the images that were processed and a flag indicating that the browser download was triggered. This output is crucial for confirming that the node has successfully executed its function and that the images are ready for local access.
Browser Download Usage Tips:
- To ensure your images are well-organized upon download, make use of the
filename_prefixparameter with dynamic format strings to automatically include dates or other identifiers in your filenames. - If you are working with a large number of images and need to download them quickly, consider using the "jpg" or "webp" formats with a lower quality setting to reduce file sizes and speed up the download process.
Browser Download Common Errors and Solutions:
"Failed to trigger browser download"
- Explanation: This error may occur if there is an issue with the browser's ability to initiate a download, possibly due to browser settings or permissions.
- Solution: Ensure that your browser settings allow automatic downloads from the site you are using. You may need to adjust your browser's security or permissions settings to enable this feature.
"Invalid image format specified"
- Explanation: This error indicates that the format specified in the
formatparameter is not supported or incorrectly entered. - Solution: Double-check the
formatparameter to ensure it is set to one of the supported options: "png", "jpg", or "webp". Correct any typos or unsupported format entries.
