Read tags from source audio:
MiniMaxAudioTagReader helps you preserve an existing track’s identifying information when creating a new audio export, such as an enhanced or mastered version. It reads metadata including title, artist, album, year, track, genre, comment, and composer, and can extract embedded cover artwork for reuse. This saves you from manually re-entering release information and helps keep your finished audio consistent with the original. You can also supply explicit metadata corrections while retaining the other information read from the file. The node does not invent missing metadata or process the sound itself; it prepares metadata and artwork for a subsequent export step.
Read tags from source audio Input Parameters:
audio_file
Required audio-file selection, with type COMBO[STRING]. This identifies the existing audio file from which the node reads metadata and, when requested, embedded artwork. Its options consist of an initial selection placeholder followed by the files returned by the toolkit’s audio-file inventory; the interface also enables audio upload. The default is the selection placeholder represented in the source as SELECT_AUDIO; its displayed wording is not provided. There are no numerical minimum or maximum values. You must select an actual file accessible to the ComfyUI installation, rather than supply a path that exists only on another computer. The node resolves the selection through ComfyUI’s file-path system and checks that the file exists before reading it.
copy_cover_art
Optional BOOLEAN setting with a default of True and two options: True and False. When enabled, the node attempts to extract embedded cover artwork into the system’s temporary directory and returns its file path for use during export. When disabled, artwork extraction is skipped and the artwork path is an empty string, while metadata reading continues normally. Enable this when you want the new export to carry the original artwork; disable it when you only need text metadata. Enabling it does not guarantee an artwork path, because extraction must actually return a file for that to happen. Numerical minimum and maximum values do not apply.
overrides_json
Optional STRING input for supplying metadata values as a JSON object, for example {"title":"Revised Title","artist":"Example Artist"}. It is configured as a connection-only input through forceInput=True; no widget default is declared, and the execution method uses an empty string when nothing is supplied. There are no declared length limits or numerical minimum and maximum values. A valid JSON object is converted into text-valued entries, with entries whose string representations are blank or whitespace-only excluded. These entries are applied after reading the source metadata, so they replace matching existing fields and can also add fields. This is important because the supplied help text says source tags win, but the actual implementation does the opposite: explicit overrides win. Empty input, malformed JSON, or valid JSON that is not an object is silently ignored, leaving the source metadata unchanged. Use text values and field names recognized by your downstream metadata writer; this node does not validate override keys against the standard metadata fields.
Read tags from source audio Output Parameters:
audio_tags_json
A STRING containing the resulting metadata as a JSON object. It combines tags read from the selected file with any accepted overrides, with overrides taking precedence for matching keys. This is the metadata payload to connect to the audio_tags_json input of Save Audio Smart Prefix. Missing source information is not invented; only information returned by the metadata reader or supplied through overrides is included. If neither source tags nor accepted overrides provide any entries, the serialized result is an empty JSON object, {}. Non-ASCII characters are preserved directly in the JSON text, which helps retain artist names and titles written in different languages. This output contains metadata, not audio samples.
cover_image_path
A STRING containing the path returned by the artwork extraction step, or an empty string when artwork copying is disabled or extraction produces no path. The extraction destination is the system’s temporary directory. Connect this output to the cover_image_path input of Save Audio Smart Prefix when you want to reuse the extracted cover. It is a file reference rather than image pixels or a ComfyUI IMAGE object, so downstream steps must be able to access the referenced file. An empty value means this node is not supplying artwork; it does not prevent the text metadata output from being useful.
tag_report_json
A STRING containing a JSON report that helps you inspect the result. The report includes schema, set to music_source_tags_v1; source_file, identifying the selected source by its basename; fields_found, an alphabetically sorted list of keys in the final metadata; fields_missing, an alphabetically sorted list of standard fields absent from that metadata according to the toolkit’s field-alias definitions; overridden, an alphabetically sorted list of accepted override keys; and cover_art, a Boolean indicating whether a nonempty artwork path was returned. Because the report is built after overrides are applied, fields_found describes the final metadata rather than only what was embedded in the original file. Likewise, overridden can include newly added fields, not just replacements. The report is useful for checking completeness, but it does not confirm that a later export successfully embedded the metadata.
Read tags from source audio Usage Tips:
- Connect
audio_tags_jsonandcover_image_pathto the matching inputs on Save Audio Smart Prefix. Keep your audio-processing connections separate, because this node reads metadata and artwork rather than processing or forwarding sound. - Leave
copy_cover_artenabled when preserving the original release presentation matters. Disable it when you only need text tags or intend to supply different artwork elsewhere in your workflow. - Use
overrides_jsonfor targeted corrections, such as{"title":"Final Mix"}, instead of recreating every metadata field. Matching source fields are replaced, while unrelated fields remain intact. - Use a valid JSON object with double-quoted field names and text values. Blank or whitespace-only values are discarded, so an override such as
{"artist":""}does not clear an existing artist tag. - Inspect
tag_report_jsonbefore exporting important work. Checkfields_foundandfields_missingfor metadata completeness,overriddenfor accepted corrections, andcover_artfor whether artwork is being supplied. - Select or upload a file available to the machine running ComfyUI. If you replace that file in place, the node uses its modification time and size as its change signature, helping ComfyUI detect changed source files.
- Use extracted artwork promptly in the same workflow. Because it is saved in a temporary directory, retain a separate copy if you need the artwork beyond temporary-file cleanup.
Read tags from source audio Common Errors and Solutions:
Read audio tags: select the audio file to read the tags from.
- Explanation: No usable audio selection was supplied, or the selection is still the initial placeholder. The node stops before reading metadata.
- Solution: Choose an actual audio file in
audio_file, or upload one through the available audio-upload control, then run the workflow again.
Read audio tags: audio file not found: [filename]
- Explanation: The selected file does not exist at the location resolved by ComfyUI. The actual message includes the source filename instead of
[filename]. This can happen if the file was moved, deleted, or is unavailable on the machine running ComfyUI. - Solution: Upload the file again or select an existing file from the current inventory. Confirm that it is accessible on the ComfyUI machine, not only on your local computer.
Overrides are ignored without an error message
- Explanation: This is a silent behavior rather than an explicit exception. Malformed JSON, a JSON value that is not an object, and blank input are ignored. Individual entries with blank or whitespace-only string values are also excluded.
- Solution: Supply a JSON object such as
{"title":"Corrected Title"}, using double quotes and no trailing comma. Checkoverriddenintag_report_jsonto confirm which keys were accepted.
Source metadata is replaced unexpectedly
- Explanation: The implementation applies overrides after reading the file, so accepted override values replace matching source values. The supplied help text describing overrides as gap-filling only does not match this behavior.
- Solution: Disconnect or empty
overrides_jsonto preserve the metadata returned from the source. If you only want to fill missing fields, inspect the report first and supply overrides only for those missing fields.
cover_image_path is empty
- Explanation: An empty artwork path is not necessarily an error. It is the expected result when
copy_cover_artis disabled, and it can also occur when artwork extraction returns no path. The provided code does not specify the extraction helper’s format support or detailed failure behavior. - Solution: Enable
copy_cover_artand confirm that the selected audio file contains embedded cover artwork, rather than only having a separate image beside it. Checkcover_artin the report; if no artwork is returned, provide artwork separately in your export workflow.
Metadata fields are missing or audio_tags_json is an empty object
- Explanation: This is a result condition rather than a defined error message. The node does not generate missing information, so a file with no readable metadata and no accepted overrides can produce
{}. A filename alone is not used here to invent a title or artist. - Solution: Review
fields_missingin the report and add known information through a validoverrides_jsonobject, or add metadata to the original file using a tag editor and run the workflow again.
Artwork was extracted, but the downstream export cannot find it
- Explanation: The artwork output refers to a temporary file, not a permanently stored image. If that file is removed before export, the path may no longer be usable. The provided node does not define a specific error message for this downstream situation.
- Solution: Re-execute the reader so extraction runs again, then export while the temporary file is available. If you need to keep the artwork for later work, save a separate permanent copy.
Metadata reading or cover extraction raises another exception
- Explanation: The node calls separate metadata-reading and artwork-extraction helpers without catching their exceptions in the shown method. Their implementations and exact error messages are not supplied, so specific format, dependency, or file-access errors cannot be confirmed from this source.
- Solution: Read the full error in ComfyUI’s execution log, confirm that the file is accessible and opens normally, and try another known-good audio file. If the failure occurs only with artwork enabled, disable
copy_cover_artto check whether the problem is isolated to extraction.
