Troubleshooting

Troubleshooting

Changes are not showing up in Explorer

This is the most common issue. You changed the icon or alias, but Windows Explorer still shows the old one.

Reason: Windows caches folder customizations aggressively.

Solutions:

1. Wait: Sometimes it takes a few seconds.
2. Refresh: Press F5 in the Explorer window.
3. Re-enter: Go up one level and enter the folder again.
4. Restart Explorer: In rare cases, you might need to restart the explorer.exe process via Task Manager.

"Path not found" error

• Ensure your Root Path in settings is correct and exists.
• If using Docker, ensure your volume mounts are correct.

Icons not displaying

• Check the path: If you used a relative path, ensure the relative relationship hasn't changed.
• File type: Ensure the target file is a valid .ico file. .png or .jpg files will not work directly as folder icons in Windows.
• Attributes: The folder must be Read-Only (System attribute works too, but Read-Only is standard for this trigger). The app handles this, but if you manually changed it back, the icon will vanish.

Docker Issues

• Linux Host: If you are running the Docker container on a Linux host (e.g., Synology NAS, Unraid), the application cannot execute the Windows attrib command.
  • Workaround: You might need to manually set the desktop.ini file to System/Hidden and the folder to Read-Only using Windows clients accessing the share, or use a script on the NAS that mimics this behavior (if the filesystem supports DOS attributes).