🟣 hyper-theme-distro: Temas de Distro Linux Dinámicos para Hyper Terminal

Autor: Ramiro Pastrano (Más información en ramiropastrano.com) Versión: 0.0.11 Licencia: MIT

✨ Resumen del Proyecto

hyper-theme-distro es un plugin avanzado para Hyper Terminal diseñado para proporcionar una experiencia de tema totalmente personalizable y dinámica, basada en la distribución Linux seleccionada por el usuario.

Este plugin resuelve problemas de temas al inyectar los estilos directamente en las capas de la terminal, lo que permite un control de color total sobre la cabecera y una carga de imágenes de fondo sin fallos de permisos.

🖼️ Características Principales

• Temas Dinámicos (YAML): Carga todas las configuraciones de color, sintaxis, opacidad y cursor desde archivos YAML externos (themes/distros.yml).
• Fondo de Imagen Dinámico: Cambia la imagen de fondo (ej., fedora.png, ubuntu.png, etc.) según el tema activo.
• Control de Cabecera: Sincroniza el color de la barra de título (header) con el tema seleccionado.
• Control de Contraste (ls): El color de los archivos resaltados se controla directamente desde el YAML (syntax.green) para evitar los colores neón y lograr un efecto sutil.

🚀 Novedades (Nuevas Versiones)

• Compatibilidad Multiplataforma: Ahora los fondos se visualizarán de manera nativa y sin importar si usas Windows, macOS o Linux, reparando los problemas que se tenían con las rutas relativas en CSS nativo e hiperterminal en sistemas que usan barras invertidas.
• Gran Colección de Nuevos Temas: Se integraron temas inspirados en Arcades retro, Distribuciones en tendencia y Sistemas Orientados a Servidores / Ciberseguridad, todos ellos acompañados de fondos públicos generados artísticamente con Inteligencia Artificial.

🖼️ Galería de Temas Destacados

Puedes activar estos (y otros) fondos configurando su nombre en tu ~/.hyper.js.

🐧 Linux Distros (Clásicos y Nuevos)

| Clásicos | Populares | Seguridad y Custom | | --- | --- | --- | | Fedora (fedora) | Arch Linux (arch) | Kali Linux (kali) | | Ubuntu (ubuntu) | Debian (debian) | Archcraft (archcraft) | | Manjaro (manjaro) | Fedora 2 (fedora2) | QuePasaLinux (quepasalinux) | | Ubuntu 2 (ubuntu2) | Manjaro 2 (manjaro2) | QuePasaLinux 2 (quepasalinux2) |

🎮 Arcade y Videojuegos

| Arcade Retro | Metal Slug | Supervivencia / Otros | | --- | --- | --- | | King of Fighters (kof) | Metal Slug (metalslug) | Left 4 Dead (left4dead) | | | Metal Slug Heroes (metalslugheroes) | |

☁️ Redes y Servidores

| Hypervisores | Firewalls | NAS | | --- | --- | --- | | Proxmox (proxmox) | OPNsense (opnsense) | OpenMediaVault (openmediavault) |

🦸‍♀️ Heroínas KOF

| Personajes KOF | Personajes KOF | | --- | --- | | Mai Shiranui (mai) | Athena Asamiya (athena) | | Blue Mary (mary) | Kula Diamond (kula) | | Angel (angel) | Vanessa (vanessa) |

👨‍💻 Lenguajes y Tecnologías de Código

| Backend & Frameworks | Servidores y DB | Fullstack Cyberpunk | | --- | --- | --- | | Python (python) | Nginx (nginx) | Fullstack (fullstack) | | Node.js (nodejs) | MongoDB (mongodb) | | | Svelte (svelte) | | |

🌸 Waifus Linux (Anime)

| Waifu Distros | Waifu Distros | | --- | --- | | Ubuntu Waifu (ubuntu_waifu) | Arch Waifu (arch_waifu) | | Debian Waifu (debian_waifu) | Fedora Waifu (fedora_waifu) |

Todo este roster increíble está totalmente adaptado con colores especializados para mantener tu código siempre visible y elegante.

🛠️ Instalación y Uso

1. Instalación (Método Recomendado)

Para instalar hyper-theme-distro desde el registro de npm, abre tu terminal (fuera de Hyper) y ejecuta:

hyper i hyper-theme-distro

2. Configuración en ~/.hyper.js

Una vez instalado, abre tu archivo de configuración de Hyper (~/.hyper.js) para activar y configurar el tema.

A. Habilitar el Plugin

Añade el plugin a la lista plugins:

// En tu archivo ~/.hyper.js

plugins: [
    'hyper-theme-distro', //ingresa el nombre de nuestro plugin
],

B. Seleccionar el Tema y Habilitar Control de Color

Usa la clave distros para seleccionar el tema deseado. Para asegurar que el color de la cabecera funcione, debes desactivar las decoraciones de ventana nativas.

// En tu archivo ~/.hyper.js

config: {
    // ...
    // SELECCIÓN DEL TEMA (Debe coincidir con una clave en distros.yml)
    distros: 'kali', 
    // Puedes usar una amplia variedad de opciones como:
    // "fedora", "ubuntu", "manjaro", "arch", "debian", "kof", "metalslug", "kali", "proxmox", entre muchos otros.
    // ...
}

🎨 Personalización de Temas (distros.yml)

El control de todo el aspecto visual de tu terminal reside en el archivo themes/distros.yml.

| Propiedad | Función | Valor Sugerido para Contraste | | :--- | :--- | :--- | | backgroundOpacity | Opacidad del área de comandos (0.0 a 1.0). | Controla cuánto se ve la imagen de fondo (ej., 0.35). | | unibody | Color sólido principal (define el fondo de la cabecera y pestañas). | Color de la barra de título. | | syntax.green | Color ANSI Green (controla el resaltado feo de ls). | Tono verde profundo y sutil (ej., #50A050). |

Ejemplo (manjaro):

manjaro:
  primary: '#0FDD6B'       
  secondary: '#FAFAFA'     
  unibody: '#1A3333'       
  
  backgroundOpacity: 0.35 
  cursorColor: '#50FA7B'
  
  syntax:
    red: '#FF6E67'
    green: '#50A050'       # Sutil, no neón.
    # ... (otros colores ANSI) ...

📜 Información de Licencia y Autoría

🖼️ Aviso sobre los Fondos de Pantalla e Imágenes

Algunos fondos de pantalla y activos artísticos utilizados en los temas (como las imágenes de los personajes de videojuegos) han sido recopilados de la web y de galerías públicas para mantener la fidelidad visual y retro, o bien fueron generados por IA a partir de inspiración pública. Todos los derechos de propiedad intelectual, marcas registradas y diseños de dichos personajes pertenecen a sus respectivos creadores originales y dueños (por ejemplo, SNK Corporation para los personajes de The King of Fighters). Estas imágenes se incluyen en este proyecto de código abierto únicamente con fines estéticos y decorativos de uso personal.

Aviso de Derechos de Autor (Autoría Dual)

Este software está basado en el código del proyecto hyper-pokemon (Klaudios Sinani).

Texto Oficial de la Licencia (MIT - Inglés)

El texto legal vinculante y oficial se encuentra en el archivo LICENSE. A continuación, se presenta la sección de derechos de autor incluida en dicho archivo:

Copyright (c) 2017-2024 Klaudios Sinani (Base Code Author)
Copyright (c) 2025 Ramiro Pastrano (Modifications and current version)

Aviso Legal y Traducción (Solo Referencia)

A continuación, se incluye la traducción al español del texto de la Licencia MIT. Esta traducción se proporciona únicamente con fines informativos y no es legalmente vinculante.

Licencia MIT (Traducción al Español)

Por la presente se concede permiso, de forma gratuita, a cualquier persona que obtenga una copia de este software y de los archivos de documentación asociados (el "Software"), para utilizar el Software sin restricciones, incluyendo sin limitación los derechos de usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender copias del Software, y para permitir a las personas a las que se les proporcione el Software hacerlo, sujeto a las siguientes condiciones:

El aviso de derechos de autor anterior y este aviso de permiso se incluirán en todas las copias o partes sustanciales del Software.

EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE LOS DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGUNA RECLAMACIÓN, DAÑOS U OTRAS RESPONSABILIDADES, YA SEA EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRO TIPO, QUE SURJAN DE, FUERA DE O EN CONEXIÓN CON EL SOFTWARE O EL USO U OTRAS NEGOCIACIONES EN EL SOFTWARE.

Para más información sobre este plugin y otros proyectos, visita ramiropastrano.com.