iconos 🎨

Générateur d'icônes CLI et serveur MCP pour extensions, web, PWA et mobile.

Installation

Homebrew (macOS/Linux)

brew install raucheacho/tap/iconos

Scoop (Windows)

scoop bucket add raucheacho https://github.com/raucheacho/scoop-bucket
scoop install iconos

Go install

go install github.com/raucheacho/iconos@latest

Build from source

git clone https://github.com/raucheacho/iconos.git
cd iconos
go build -o iconos .

Utilisation

Commande de base

iconos input.png

Génère dans icons/ :

• icon16.png (16x16)
• icon32.png (32x32)
• icon48.png (48x48)
• icon128.png (128x128)

Avec favicons

iconos input.png --favicon

Génère en plus :

• favicon-16x16.png
• favicon-32x32.png
• favicon-48x48.png
• favicon.ico (multi-résolutions)

Options

Option	Description	Défaut
--sizes, -s	Tailles personnalisées	16,32,48,128
--out, -o	Répertoire de sortie	icons
--prefix, -p	Préfixe des fichiers	icon
--format, -f	Format (png, jpg)	png
--preset	Preset de tailles	-
--favicon	Générer les favicons	false
--no-ratio	Forcer le carré exact	false
--bg	Couleur de fond	transparent
--html	Générer favicon.html	false
--manifest	Générer manifest.json	false

Presets disponibles

Preset	Tailles
chrome-extension	16, 32, 48, 128
web	16, 32, 48, 64, 128, 256
pwa	192, 512
favicon	16, 32, 48

Exemples

# Preset Chrome Extension
iconos logo.png --preset chrome-extension

# Preset PWA avec manifest
iconos logo.png --preset pwa --manifest

# Tailles personnalisées
iconos logo.png --sizes 64,128,256,512

# Forcer le carré (sans conserver le ratio)
iconos logo.png --no-ratio

# Fond blanc au lieu de transparent
iconos logo.png --bg "#ffffff"

# Tout générer
iconos logo.png --favicon --html --manifest --preset web

Conservation du ratio

Par défaut, iconos conserve le ratio d'aspect de l'image source :

• L'image est redimensionnée pour tenir dans le carré cible
• Les zones vides sont remplies par un fond transparent (ou la couleur --bg)

Avec --no-ratio, l'image est étirée pour remplir exactement le carré.

Support SVG

Pour convertir des SVG en PNG, installez resvg :

# macOS
brew install resvg

# Conversion
resvg input.svg input.png
iconos input.png

Serveur MCP (Model Context Protocol)

iconos peut fonctionner comme serveur MCP pour permettre aux LLM (Claude, Kiro, etc.) de générer des icônes.

Configuration

Obtenez la configuration prête à copier :

iconos serve --print-config

Résultat :

{
  "mcpServers": {
    "iconos": {
      "command": "/chemin/vers/iconos",
      "args": ["serve"]
    }
  }
}

Ajoutez cette configuration dans votre client MCP (Kiro, Claude Desktop, etc.).

Tools exposés

Tool	Description
generate_icons	Génère des icônes redimensionnées
generate_favicons	Génère des favicons PNG + ICO multi-résolutions
list_presets	Liste les presets de tailles disponibles

Exemple d'utilisation par un LLM

"Génère des icônes PWA pour logo.png"
→ Appelle generate_icons avec preset: "pwa"

"Crée les favicons pour mon site"
→ Appelle generate_favicons avec html: true

Licence

MIT