🐍 Guía Oficial: scorch-ascii CLI (Velgrynd Edition)
RESUMEN DE LA HERRAMIENTA
scorch-asciies una herramienta CLI en Python desarrollada para Ryukami Labs. Permite convertir cualquier imagen (PNG, JPG, WEBP, SVG) en arte ASCII coloreado con la paleta de Velgrynd (#E63946,#9B1B30,#4DA3FF,#F4D35E) de forma 100% local y offline, sin dependencias de servicios externos.
🚀 Instalación y Acceso Global
El script se encuentra instalado globalmente en tu sistema en:
~/.local/bin/scorch-ascii
Y el código fuente se conserva en:
03_Conocimiento/Web Dev & Herramientas/Scorch Design System/04_Scripts/scorch-ascii.py
Puedes invocarlo desde cualquier carpeta de tu terminal simplemente escribiendo:
scorch-ascii --help⚙️ Opciones y Parámetros
| Parámetro | Alias | Valores | Descripción |
|---|---|---|---|
image | — | Ruta del archivo | Imagen de origen (obligatorio). |
--width | -w | Número entero (ej. 50, 80) | Ancho en columnas de texto (por defecto: 60). |
--format | -f | ansi, html, markdown, text | Formato de salida (por defecto: ansi). |
--palette | -p | velgrynd, truecolor, mono | Paleta de color (por defecto: velgrynd). |
--ramp | -r | standard, detailed, blocks | Densidad y juego de caracteres ASCII. |
--invert | -i | Flag | Invierte la luminosidad (ideal para logos sobre fondo blanco). |
--output | -o | Ruta de archivo | Guarda el resultado en un archivo en vez de imprimirlo. |
📋 Ejemplos Prácticos de Uso
1. Ver en Terminal a Todo Color (TrueColor ANSI)
Convierte el banner oficial y muéstralo directamente en tu terminal:
scorch-ascii ~/Documentos/a/scorch-dragon-banner.jpg -w 652. Generar Bloque HTML Listo para tu Web (Astro / Next.js / HTML)
Genera el bloque <pre class="ascii-art"> con estilos inline de Velgrynd y guárdalo en un archivo HTML:
scorch-ascii mi-logo.png -w 50 -f html -o logo-ascii.htmlEl archivo generado solo tienes que copiarlo y pegarlo en cualquier componente web.
3. Generar Bloque para Notas de Obsidian (Markdown)
Convierte una imagen a caracteres estándar para pegarla en tus notas:
scorch-ascii captura.png -w 45 -f markdown -o diagrama-ascii.md4. Usar la Rampa de Bloques Sólidos (░▒▓█)
Para un aspecto más denso y pixelado tipo GameBoy / CRT:
scorch-ascii mi-logo.png -w 55 -r blocks5. Invertir Fondos Claros
Si la imagen tiene fondo blanco y quieres que el fondo quede limpio en una terminal oscura:
scorch-ascii logo-fondo-blanco.png -w 50 -i🎨 Lógica de Mapeo Cromático de Velgrynd
El algoritmo analiza cada píxel y lo traduce a tu paleta:
- Luminosidad > 210 (Luz alta / Reflejos):
#F4D35E(Oro Dragón). - Luminosidad 150 - 210 (Cuerpo / Fuego):
#E63946(Rojo Carmesí Scorch).- Si el píxel tiene predominio azul:
#4DA3FF(Cian Eléctrico de bigotes).
- Si el píxel tiene predominio azul:
- Luminosidad 80 - 150 (Sombra de escamas):
#9B1B30(Rojo Sangre Oscuro). - Luminosidad < 80: Espacio vacío o fondo de terminal
#0B0F17.