Custom Icons - User Guide

Custom Icons - User Guide#

This guide shows how to customize UVFlow’s icons by replacing them with your own. Let’s get started!

Overview#

UVFlow allows you to completely customize its interface by replacing any of the built-in icons with your own designs. The system automatically detects new icon files and updates the interface without requiring any code changes.

Quick Start#

1. Locate the Icons Directory#

Navigate to your UVFlow addon installation and find the icons directory:

UVFlow/
└── assets/
    └── icons/
        ├── tools/              # Tool icons (unwrap, pack, etc.)
        └── [other folders]     # Additional icon categories

Finding Your UVFlow Installation:

  • Windows: %APPDATA%\Blender Foundation\Blender\[version]\scripts\addons\uvflow\

  • macOS: ~/Library/Application Support/Blender/[version]/scripts/addons/uvflow/

  • Linux: ~/.config/blender/[version]/scripts/addons/uvflow/

2. Replace Icons#

Simply replace any icon file with your own design using the same filename:

Before:
assets/icons/tools/cut_uv.png

After:
assets/icons/tools/cut_uv.png  # Your custom icon, same name, name place!

NOTE: we recommend to backup the original icons before replacing them, in case you want to revert to the original ones.

3. Restart Blender#

Restart Blender to see your custom icons in the UVFlow interface.

Icon Requirements#

Supported File Formats#

  • PNG (recommended) - Best for icons with transparency

  • JPG/JPEG

Troubleshooting#

Icons Not Appearing#

Problem: Custom icons don’t show up in Blender Solutions:

  1. Check filename matches exactly (case-sensitive)

  2. Ensure file format is PNG or JPG

  3. Restart Blender completely

  4. Check file permissions (read access required)

Icons Look Blurry#

Problem: Icons appear blurry or pixelated Solutions:

  1. Use higher resolution source images

  2. Ensure proper scaling during export

  3. Use PNG format instead of JPG

  4. Check that image dimensions match requirements

Icons Too Dark/Light#

Problem: Icons don’t match Blender’s theme Solutions:

  1. Test icons in both dark and light Blender themes

  2. Adjust contrast and brightness

  3. Use colors that work well with gray backgrounds

  4. Consider adding subtle outlines for better visibility

Missing Icons#

Problem: Some icons disappeared after customization Solutions:

  1. Check that all original filenames are preserved

  2. Restore from backup if needed

  3. Ensure all required icons are present

  4. Check folder structure matches original

Sharing Custom Icon Sets#

Creating Icon Packs#

To share your custom icons with others:

  1. Package Your Icons:

    my_uvflow_icons/
├── README.md          # Installation instructions
├── preview.png        # Preview of your icon set
└── icons/
    ├── tools/
    ├── ui/
    └── status/

  2. Include Documentation:

Include these instructions with your icon pack:

# Installation Instructions

1. Download and extract the icon pack
2. Locate your UVFlow installation directory
3. Backup the original icons folder (recommended)
4. Copy the new icons folder to replace the original
5. Restart Blender
6. Enjoy your new custom icons!

Conclusion#

Customizing UVFlow’s icons is a great way to personalize your Blender experience and make the tools feel more like your own. Whether you’re creating a complete icon overhaul or just tweaking a few key icons, the system is designed to be flexible and user-friendly.

Happy customizing!

Contents