MediaFX icon

MediaFX

Process videos, audio, and media files with FFmpeg

Actions15

Overview

The node provides media processing capabilities focused on video, audio, images, subtitles, transitions, and fonts using FFmpeg. Specifically, for the Font Management resource with the List Fonts operation, it retrieves a list of available fonts filtered by type and optionally includes detailed font information.

This node is beneficial when you need to dynamically access and manage fonts within media workflows, such as adding subtitles or text overlays with specific fonts in video editing automation.

Practical example:

  • Automatically retrieve all user-uploaded fonts to present them as options in a subsequent subtitle addition step.
  • Filter and list only Korean fonts to ensure correct typography in localized video content.

Properties

Name Meaning
Filter Options A collection of filters to narrow down the fonts listed:
- Font Type Select which font types to include in the list: All Fonts, Korean Fonts, Global Fonts, User Fonts, Fallback Fonts
- Include Details Boolean flag to include detailed font information (such as description) in the output

Output

The output JSON contains:

  • success: Always true if the operation completes successfully.
  • operation: The name of the operation performed (list).
  • data: An object mapping font keys to font metadata objects. Each font metadata object includes:
    • name: The display name of the font.
    • type: The font type (e.g., "korean", "user").
    • description: Optional descriptive text about the font (if available).

If the "Include Details" option is enabled, more detailed information about each font may be included.

No binary data output is produced by this operation.

Example output snippet:

{
  "success": true,
  "operation": "list",
  "data": {
    "noto-sans-kr": {
      "name": "Noto Sans KR",
      "type": "korean",
      "description": "A Korean font"
    },
    "open-sans": {
      "name": "Open Sans",
      "type": "global",
      "description": "A global sans-serif font"
    }
  }
}

Dependencies

  • The node relies on internal utility functions to fetch available fonts from the system or user uploads.
  • No external API keys or credentials are required for listing fonts.
  • Requires access to the file system where fonts are stored.
  • FFmpeg is used for other media operations but not directly for listing fonts.

Troubleshooting

  • No fonts returned: Ensure that fonts are installed or uploaded correctly in the environment where the node runs.
  • Invalid filter value: Using an unsupported font type filter will result in an empty list; verify the filter options.
  • Permission errors: The node needs read access to font directories; lack of permissions can cause failures.
  • Unexpected errors: If the node throws errors related to font retrieval, check the underlying font utility functions and file system integrity.

Links and References

Discussion