Chihuahua 🐾

Monitor de archivos y carpetas en tiempo real, liviano y de facil configuracion con alertas directas en telegram

---

¿Qué es?

Una herramienta CLI que monitorea archivos y directorios en tiempo real. Detecta cambios automáticamente, lo guarda en un .log y lo reporta via a telegram. Sin dependencias externas — construido en Golang.

---

Características

• 📁 Monitoreo de múltiples archivos y directorios simultáneamente
• 📬 Logs y alertas automáticas a Telegram al detectar cambios
• ⚡ Concurrencia con goroutines (hilos de golang) — una por archivo
• 🪶 Bajo consumo de recursos
• 🔧 Sin dependencias externas
• 🖥️ Compatible con Windows, Linux y Android (Termux)

---

Instalación

Opción 1 — Binario precompilado

Descargá el binario correspondiente a tu sistema desde builds:

Sistema	Archivo
Windows	watchdog.exe
Linux	watchdog-linux
Android (Termux)	watchdog-termux

Linux / Termux — dar permisos de ejecución:

chmod +x watchdog-linux
./watchdog-linux

Windows:

watchdog.exe

---

Opción 2 — Usar desde el código fuente

Requiere tener Go1.25.4 instalado.

git clone https://github.com/mig-af/chihuahua.git
cd watchdog
go run main.go

Configuración

Editá el archivo watchdog.json dentro la carpeta /info en el mismo directorio del binario :

Si se usa la opcion 1 de instalacion, el binario precompilado, al iniciar este, se crea automáticamente los archivos necesarios

{
   "timezone":"America/Bogota",

   "user": {
      "active": false,
      "telegram_id": 123456,
      "telegram_token": "telegram-token"
   },
   "file": {
      "paths": [
         "/rutaAbsoluta/hacia/el/archivo.txt"
      ]
   },
   "dir": {
      "paths": [
         "/rutaAbsoluta/hacia/la/carpeta/"
      ]
   }
}

Campo	tipo	Descripción
timezone	string	Zona horaria
active	bool	true para activar notificaciones en telegram
telegram_id	int	Id numerico del usuario de telegram
telegram_token	string	Token del bot de telegram
paths	array	Lista de rutas de los archivos y carpetas a monitorear en formato string

---

Uso

Copiar las rutas de los archivos o directorios que se quiere monitorear, en el campo "path" del archivo watchdog.json

Para configurar el bot de telegram se necesita el token del bot y el id del usuario a quien le llegara las notificaciones, click aqui para ver como crear un bot en telegram y luego ejecutar los comandos :

./watchdog-linux (linux)
./watchdog-termux (android)

Uso en segundo plano linux

./watchdog-linux  > /dev/null 2>&1 &

Uso en segundo plano windows

Start-process .\watchdog.exe -WindowStyle hidden

El programa inicia el monitoreo, muestra en pantalla los archivos detectados y los almacena en el archivo /info/watchdog.log. Cualquier cambio genera una alerta en Telegram automáticamente con previa configuracion.

---

Compilar para otros sistemas

# Windows
GOOS=windows GOARCH=amd64 go build -o builds/watchdog.exe

# Linux
GOOS=linux GOARCH=amd64 go build -o builds/watchdog-linux

# Android (Termux)
GOOS=android GOARCH=arm64 go build -o builds/watchdog-termux

---