[Ultima Versão] Ulanzi IconResizer Plugin

darkdomi

@Ulanzi, segue a versão 1.0.3 - Refatorado o motor do Gemini para melhores resultados, atualizado a identidade visual do plugin, segue material marketing para atualização no MarketPlace.

1. # Ulanzi IconResizer - Versão 1.0.3
   
2. 
   
3. O **Ulanzi IconResizer** é um estúdio de customização completo e automatizado para o **Ulanzi Deck**. Ele permite criar, redimensionar e otimizar ícones de altíssima qualidade diretamente na interface do seu Ulanzi Studio, sem necessidade de softwares externos.
   
4. 
   
5. O plugin conta com suporte total ao formato **Padrão (196x196)** e ao formato widescreen exclusivo do **Relógio (458x196)**.
   
6. 
   
7. ---
   
8. 
   
9. ## Ferramentas Inclusas
   
10. 
    
11. O pacote registra 7 ações independentes no seu Ulanzi Studio:
    
12. 
    
13. ### 1. Resizer Icons (Arraste e Solte)
    
14. Redimensionador local com otimização inteligente.
    
15. - Arraste múltiplos arquivos locais (PNG, JPG, GIF) de uma só vez para processamento em lote.
    
16. - Motor de otimização de GIFs via WebAssembly (Gifsicle) que comprime animações pesadas para o limite do hardware (295KB) preservando a fluidez.
    
17. 
    
18. ### 2. Search Icons (Biblioteca de Ícones SVG)
    
19. Buscador online focado em atalhos, logos de softwares e estilo minimalista.
    
20. - Pesquise milhares de ícones vetoriais diretamente do banco de dados do Iconify.
    
21. - *Color Pickers* integrados para alterar instantaneamente a cor principal do ícone e a cor de fundo da tecla.
    
22. - Controle preciso de escala (zoom) para enquadrar o logotipo.
    
23. 
    
24. ### 3. Search Images (Galeria de Imagens e Texturas)
    
25. Buscador fotográfico para ilustrar botões com imagens reais.
    
26. - Integração direta e sem limitações de API com o acervo público da *Wikimedia Commons*.
    
27. - Corte inteligente nativo (`object-fit: contain` / letterboxing) que enquadra perfeitamente fotografias de qualquer tamanho dentro das margens exigidas pelo deck sem distorcê-las.
    
28. 
    
29. ### 4. IconText Generate (Gerador de Texto Avançado)
    
30. Estúdio de design embutido para criação de ícones baseados em texto.
    
31. - Crie ícones digitando livremente rótulos e comandos.
    
32. - Biblioteca embutida com as 16 fontes mais populares de interface (como *Roboto*, *Bebas Neue*, *Montserrat*, *Pacifico* e *Audiowide*).
    
33. - Suporte a **Sombra (Drop Shadow)** ajustável e aplicação de **Molduras (Bordas)**.
    
34. - Possibilidade de criar e misturar **Gradientes Lineares** tanto na cor do Fundo quanto na cor do Texto (inclui uma barra com presets rápidos de combinações modernas).
    
35. 
    
36. ### 5. Animated Generator (Efeitos Animados)
    
37. Criador de fundos dinâmicos e letreiros para dar vida ao deck.
    
38. - Motor de animação que gera GIFs proceduralmente com base em texto e ícones escolhidos.
    
39. - Suporte a 7 efeitos premium nativos: **Pulse, Spin, Marquee, Blink, Rainbow, Shake e Bounce**.
    
40. - Possibilidade de ajustar a velocidade de reprodução para cada animação.
    
41. 
    
42. ### 6. AI Generator (Inteligência Artificial)
    
43. Uma experiência de criação imersiva assistida por IA.
    
44. - Painel conversacional interativo para guiar a criação do seu ícone de acordo com o botão escolhido (Padrão ou Relógio).
    
45. - Integração com **Google Gemini** para geração de imagens por prompt (Requer API Key configurada no painel).
    
46. - Integração com o banco gratuito **Pixabay** para baixar e adaptar fotos e texturas incríveis de altíssima qualidade direto para o Deck.
    
47. 
    
48. ### 7. Batch Pack (Pacote em Massa)
    
49. Uma ferramenta poderosa para padronizar layouts inteiros com alguns cliques.
    
50. - Permite construir múltiplos botões de uma só vez mantendo uma estética unificada.
    
51. - Adicione ícones (Emojis ou SVGs), nomes, defina uma paleta global de Background, Fontes e Gradientes.
    
52. - Ao clicar em "Gerar", todos os ícones da sua lista são renderizados simultaneamente e guardados na galeria, prontos para uso em massa!
    
53. 
    
54. ---
    
55. 
    
56. ## Como Instalar e Usar
    
57. 
    
58. 1. Copie a pasta `com.ulanzi.iconresizer.ulanziPlugin` para o diretório de plugins do seu Ulanzi Deck de acordo com o seu sistema operacional:
    
59.    - **Windows:** `%APPDATA%\Ulanzi\UlanziDeck\Plugins\`
    
60.    - **macOS:** `~/Library/Application Support/Ulanzi/UlanziDeck/Plugins/`
    
61. 2. Feche completamente o software **Ulanzi Studio** e abra-o novamente.
    
62. 3. Na lista lateral de ações do Ulanzi Studio, procure pela seção **Ulanzi IconResizer**.
    
63. 4. Arraste qualquer uma das 7 ferramentas para uma tecla virtual do seu Deck.
    
64. 
    
65. ---
    
66. 
    
67. ## Funcionalidades Globais
    
68. - **Multi-idioma Nativo:** A interface detecta automaticamente o idioma do seu sistema e está 100% traduzida para os 9 idiomas oficiais suportados pelo Ulanzi (Português, Chinês Simplificado/Tradicional, Japonês, Coreano, Francês, Alemão, Espanhol e Inglês).
    
69. - **Suporte Multiplataforma:** Arquitetura inteligente garantindo pleno funcionamento tanto no **Windows** quanto no **Mac OS**, ajustando automaticamente as rotas nativas de gravação da galeria em cada sistema operacional.
    
70. - **Renderização Perfeita:** Todo o redimensionamento visual ocorre através da Canvas API do HTML5, garantindo ícones sempre centralizados e nítidos.
    
71. 
    
72. ---
    
73. 
    
74. ## Onde os arquivos físicos são salvos?
    
75. Caso queira acessar ou fazer backup de todos os ícones gerados pela ferramenta, eles são inseridos automaticamente na galeria oficial do Ulanzi Studio nestes caminhos:
    
76. 
    
77. ### No Windows:
    
78. - **Ícones Quadrados:** `%APPDATA%\Ulanzi\UlanziDeck\Icons\IconResizer\`
    
79. - **Ícones de Relógio:** `%APPDATA%\Ulanzi\UlanziDeck\Icons\IconResizerClock\`
    
80. 
    
81. ### No macOS:
    
82. - **Ícones Quadrados:** `~/Library/Application Support/Ulanzi/UlanziDeck/Icons/IconResizer/`
    
83. - **Ícones de Relógio:** `~/Library/Application Support/Ulanzi/UlanziDeck/Icons/IconResizerClock/`
    
84. 
    
85. ---
    
86. *Desenvolvido por Jean Almeida*

复制代码

Ulanzi

🎉 官方致谢：感谢 @Jean Almeida 为 Ulanzi Deck 开发 IconResizer 插件！

尊敬的社区伙伴们，
我们非常欣喜地看到，又一位杰出的开发者 @Jean Almeida 为 Ulanzi Deck（D200 / D200H/D200X）生态带来了实用的新工具——Ulanzi IconResizer！
这款插件直击用户在自定义图标时最常遇到的痛点：尺寸适配与批量优化。它不仅支持一键将图片/GIF转换为设备所要求的精确分辨率（标准模式 196x196、时钟模式 458x196），更贴心地实现了 GIF 自动压缩至 300KB 以下，确保动画图标在设备上流畅运行而不占用过多存储。

Ulanzi 在此向 Jean Almeida 表示最诚挚的感谢！我们将持续关注并支持优秀的第三方开发者，也欢迎更多朋友加入 Ulanzi Studio插件生态，共同为全球创作者打造更高效、更个性化的桌面体验。

darkdomi

Ulanzi 发表于 2026-5-12 12:26
🎉 官方致谢：感谢 @Jean Almeida 为 Ulanzi Deck 开发 IconResizer 插件！

尊敬的社区伙伴们，

I sincerely thank you for being helpful and receiving this recognition. I recently acquired my first StreamDeck, and it stemmed from a real need to have something practical for customizing the deck. I want to acquire more materials from Ulanzi; it's simply amazing. It has been fulfilling my daily needs, bringing practicality and performance to my work. Thank you, @Ulanzi. I welcome suggestions for product improvements, and I am honored to have this plugin available in the official store so that other users can enjoy it and have an indescribable experience.

Ulanzi

darkdomi 发表于 2026-5-13 01:03
I sincerely thank you for being helpful and receiving this recognition. I recently acquired my firs ...

Hello, we’re glad this app has been helpful to you. Your submission has been sent, and once it passes testing and review, it will be listed in the app store. We’ll notify you when that happens.

Ulanzi

darkdomi 发表于 2026-5-12 12:08

Hello, this plugin has been tested and verified, and it works great. However, after switching languages in the Ulanzi Studio app and restarting the app, the translations within the plugin remain in Portuguese. Please look into this. If this is a bug, please release an updated version so we can launch it on the Marketplace.
Thank you.

darkdomi

Sorry for the delay in responding, I received the feedback and corrected the error, and I've implemented more tools to add value to the plugin.

Ulanzi

darkdomi 发表于 2026-6-2 11:13
Sorry for the delay in responding, I received the feedback and corrected the error, and I've impleme ...

Hello, I’ve tested the new version, and the features are powerful and impressive.
Please note the following points:
1. If a new version is released, such as V1.0.2, the version number within the plugin must also be updated. The version number should be incremented with each change so that the app store can detect the update and provide notifications.
2. Once the features are stable, please evaluate whether Mac support is feasible. We’ve conducted preliminary testing on Mac, and basic operations work normally, though the generated images are not being saved.

Ulanzi

Hello,
We’ve conducted smoke testing on version V1.0.3, and it works perfectly with Mac OS. We’re blown away by the new features—they’re amazing.
We’ve identified a few usability issues that we can address in future updates.

1. Regarding the “Resizer Icons” feature, we found that on one Windows laptop with a 4K resolution, the preview appeared normal when creating a Clock icon, but the actual saved image did not fill the button. On other computers with 1080p screens, it worked normally.



2. “Search Icon ” Feature
Search results vary by language. For example, searching for “Apple” in English returns results, but searching for “사과” in Korean yields no results.



3. “Search Image ” Feature
3.1 When searching for “lion” online within mainland China, images do not appear in the search results, but “Search Icon ” works normally.

3.2 In the global network environment, some thumbnails in the search results appear abnormal, whereas those in “Search Icon” display normally.


4. The “Batch Pack” feature returns no results for the Chinese term “足球,” but does return results for the English term “football.”

darkdomi

Ulanzi 发表于 2026-6-4 16:40
Hello,
We’ve conducted smoke testing on version V1.0.3, and it works perfectly with Mac OS. We’re  ...

Obrigado pelo feedback, irei fazer os ajustes nescessários, e estarei postando a atualização.

darkdomi

Ulanzi 发表于 2026-6-4 16:40
Hello,
We’ve conducted smoke testing on version V1.0.3, and it works perfectly with Mac OS. We’re  ...

Olá, equipe Ulanzi,

Obrigado pelo retorno detalhado. Resolvi todos os pontos levantados, além de uma rodada de melhorias e adequação. A versão 1.0.4 está finalizada, testada e pronta para publicação.

Repositório: https://github.com/JEAN-ALMEIDA-CZO/Ulanzi-IconResizer-Plugin

Problemas que vocês reportaram — corrigidos:

Busca não retornava resultados para termos fora do inglês (ex.: "football" em chinês): agora toda busca traduz automaticamente o termo para inglês antes de consultar a API. Funciona em Search Icons, Search Images, Batch Pack e no Image Bank da IA — qualquer idioma digitado → resultados corretos. Entrada em inglês é preservada.
Search Images quebrada / miniaturas anormais na China continental: as miniaturas e os downloads agora passam por um proxy global de imagens (com fallback direto), então os resultados carregam de forma confiável na China, Coreia e outras redes restritas. Search Icons continua funcionando normalmente.
Notebook Windows 4K — Resizer Icons / Clock não preenchia o botão: o pipeline de exportação foi reconstruído para ser independente de DPI (baseado no retângulo real do quadro do cropper renderizado). Os ícones salvos agora preenchem o botão corretamente em 1080p e 4K.
Melhorias adicionais na 1.0.4:

Interface modernizada e acessível em todos os painéis (rótulos claros, chips de dica, "duplo clique para ajustar" e orientação de arrastar/zoom), traduzida nos 9 idiomas.
Pré-visualização ao vivo em tempo real para fontes, tamanhos, cores, efeitos e enquadramento; o cropper agora corresponde exatamente ao resultado salvo (WYSIWYG).
IconText Generate: 16 fontes e 16 temas de cor; Animated Generator: 15 efeitos e 16 presets.
O toast ao pressionar a tecla agora exibe o nome do plugin no idioma do usuário.
Estados de carregamento exibem um indicador animado de "pensando".
Conformidade / multiplataforma:

Suporte completo ao macOS confirmado — caminhos adaptados por plataforma (os.platform() + path.join), sem paths fixos, sem binários nativos (única dependência em JS puro).
Artefatos de desenvolvimento removidos; o log de debug agora vem desligado por padrão.
Adicionados LICENSE (MIT) e THIRD-PARTY-LICENSES.md creditando todas as bibliotecas e serviços usados.
Os 9 arquivos de idioma e o manifest foram validados.
O plugin está com a Versão 1.0.4 no manifest e pronto para a atualização no Marketplace quando vocês quiserem.

Qualquer coisa fico a disposição! Muito Obrigado.