English README

tea_watch es una utilidad de terminal, escrita en Go con lipgloss, para monitorizar cambios en el sistema de ficheros en tiempo real. Chequea y cuenta modificaciones de archivos en el directorio actual.

• En Tiempo Real: Usa fsnotify para una detección de eventos eficiente y nativa.
• Interfaz Dinámica: Construida con Bubble Tea y Lipgloss, la interfaz se adapta al terminal.
• Contadores de Eventos: Visualiza y cuenta las modificaciones de archivos (creado, escrito, renombrado, ...)
• Navegación: Con las flechas del teclado o la rueda del ratón.
• Filtrado: Pulsa / para filtrar el listado por nombre de archivo.
• Resaltado: Los ficheros con cambios recientes se resaltan.
• Eventos atómicos: Los eventos efímeros (de guardado seguro,...) se cuentan al pie pero sus archivos no se muestran. Los ficheros borrados se ocultan tras un tiempo para mantener la vista limpia.

• Una Nerd Font instalada y configurada en tu terminal para visualizar correctamente los iconos.
• Si no usas Nerd Font, tea_watch puede funcionar en modo ASCII (flag --nerd-fonts=false).

Esta es la forma más fácil y rápida. Simplemente copia y pega esta línea en tu terminal. El script detectará tu sistema operativo, descargará la última versión, la instalará en ~/.local/bin, creará un archivo config.toml (en ~/.config/tea_watch) y creará el atajo de teclado (Alt+w) automáticamente.

curl -sSL https://raw.githubusercontent.com/gas/tea_watch/main/install.sh | bash

Cuando termine, recarga tu terminal con source ~/.bashrc (o ~/.zshrc) para que el atajo funcione.

Si tienes el entorno de Go instalado en tu máquina, puedes instalar tea_watch con un solo comando. El binario se instalará en tu directorio $GOPATH/bin.

go install github.com/gas/tea_watch@latest  

Puedes descargar el binario precompilado para tu sistema operativo desde la página de Releases.

1. Descarga el archivo correspondiente a tu sistema (ej. tea_watch-linux-amd64.tar.gz).
2. Descomprímelo.
3. Haz el fichero ejecutable: chmod +x tea_watch
4. (Opcional, recomendado) Mueve el fichero a un directorio en tu $PATH para poder ejecutarlo desde cualquier lugar: sudo mv tea_watch ~/.local/bin/
5. (Opcional, recomendado) Crea un binding con un atajo de teclado CTRL+

Simplemente ejecuta el comando en tu terminal:

# Monitorizar el directorio actual (usará la configuración de tu config.toml)
tea_watch

# Forzar el modo ASCII para esa ejecución (ignora el config.toml)
tea_watch --nerd-fonts=false

# Monitorizar un directorio específico
tea_watch /ruta/a/tu/directorio

Puedes traducir tea_watch a cualquier idioma.

1. Después de instalar la aplicación, busca el fichero de configuración que se ha creado en: ~/.config/tea_watch/config.toml Debería ser igual al config.example.toml de este repositorio.

2. Abre el fichero con un editor de texto. Verás una sección [strings] con todas las frases en inglés comentadas.

3. Descomenta las líneas y traduce el texto si quieres, Ejemplo en francés:

   [strings]
   monitoring    = "Surveillance"
   filter_prompt  = "Filtrer: "
   total_events   = "Événements"
   # ...etc.