Repolode
homeport

homeport/termshot

Una CLI que ejecuta un comando de terminal y convierte su salida ANSI en color en una captura PNG con aspecto de ventana.

Estrellas
976
Forks
42
Issues abiertos
37
Último commit
el mes pasado

¿Qué es?

termshot ejecuta un comando en una pseudo terminal, captura su salida con los códigos ANSI de color y formato incluidos, y la convierte en una imagen con aspecto de ventana de terminal. A diferencia de las herramientas que aplican resaltado de sintaxis al texto pegado, procesa los códigos de escape que emite el propio comando, así que la salida de herramientas como ls, figlet o lolcat conserva sus colores originales.

Su uso es sencillo: antepone termshot a cualquier comando y, de forma predeterminada, genera out.png. Las opciones permiten controlar el aspecto (decoración de ventana, sombra, margen, relleno, ajuste de columnas y si se muestra el comando), la salida (ruta del archivo o portapapeles del sistema en las plataformas compatibles) y el contenido (abrir la salida capturada en $EDITOR para eliminar líneas confidenciales). También puede ejecutar una shell interactiva completa y tomar una captura de la sesión cuando se cierre.

El proyecto aún está en desarrollo. Analiza muchas secuencias ANSI, pero es posible que algunos tipos de salida y los comandos que reinician la posición del cursor no se representen correctamente.

Funciones clave

  • 01Representa los códigos ANSI reales de color y formato, en lugar de aplicar resaltado de sintaxis.
  • 02Añade una ventana con estilo de terminal y decoración, sombra, margen y relleno opcionales.
  • 03Permite editar la salida capturada en $EDITOR antes de generar la imagen.
  • 04Puede tomar una captura de una sesión completa de shell interactiva.
  • 05Se puede instalar con Homebrew o mediante binarios precompilados para macOS y Linux.

Casos de uso

  • Crear capturas de la salida de una CLI para publicaciones de blog, documentación o notas de versión.
  • Compartir la salida de comandos en redes sociales o chats, tras eliminar primero las líneas confidenciales.
  • Mostrar herramientas coloridas como figlet o lolcat con su estilo original.

Inicio rápido

  1. 1

    Instálalo con Homebrew en macOS o Linux

    brew install homeport/tap/termshot
  2. 2

    Añade termshot al principio de cualquier comando para generar out.png

    termshot ls -a

Antes de usarlo

  • El README indica que el proyecto aún está en desarrollo y que algunas secuencias ANSI o comandos que restablecen el cursor podrían no mostrarse correctamente.

Temas

Preguntas frecuentes

¿Qué es termshot?
Una CLI que ejecuta un comando de terminal y convierte su salida ANSI en color en una captura PNG con aspecto de ventana. termshot ejecuta un comando en una pseudo terminal, captura su salida con los códigos ANSI de color y formato incluidos, y la convierte en una imagen con aspecto de ventana de terminal. A diferencia de las herramientas que aplican resaltado de sintaxis al texto pegado, procesa los códigos de escape que emite el propio comando, así que la salida de herramientas como ls, figlet o lolcat conserva sus colores originales.
¿termshot es gratuito? ¿Qué licencia tiene?
termshot es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿termshot sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de termshot fue el 15 sept 2026.
¿Para qué puedo usar termshot?
Crear capturas de la salida de una CLI para publicaciones de blog, documentación o notas de versión. Compartir la salida de comandos en redes sociales o chats, tras eliminar primero las líneas confidenciales. Mostrar herramientas coloridas como figlet o lolcat con su estilo original.
¿Cómo se instala termshot?
Instálalo con Homebrew en macOS o Linux: brew install homeport/tap/termshot Añade termshot al principio de cualquier comando para generar out.png: termshot ls -a
¿Dónde consigo termshot?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/homeport/termshot

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados