brainrotguard
Sistema de control parental para YouTube que permite a los padres aprobar o denegar videos desde Telegram mientras los niños navegan por una PWA en tablets. Elimina el algoritmo de recomendaciones y ofrece gestión granular por categorías, canales y horarios.
Ficha actualizada 24 sept 2026, 19:42 · upstream 24 sept 2026, 19:16 · release v1.31.2
Qué es brainrotguard
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
BrainRotGuard es una solución de control parental auto-alojada para YouTube que permite a los padres supervisar y aprobar contenido antes de que sea reproducido. El sistema funciona mediante una arquitectura cliente-servidor donde el dispositivo del niño accede a una PWA web simple para buscar videos, mientras que los padres reciben notificaciones en Telegram con opciones de aprobación o denegación instantánea.
La aplicación utiliza Next.js para la interfaz frontend y FastAPI con Python para el backend, comunicándose con yt-dlp para obtener metadatos sin necesidad de claves de API. Los datos se almacenan en una base de datos SQLite local, garantizando que no haya información enviada a servicios externos. El sistema soporta Docker y ofrece plantillas para Unraid, facilitando la implementación en entornos domésticos.
Las características clave incluyen gestión multi-perfil con PINs individuales, listas de canales permitidos/bloqueados, límites de tiempo diarios diferenciados entre contenido educativo y entretenimiento, y programación horaria flexible. También cuenta con filtros por palabras en títulos, control de YouTube Shorts y una interfaz oscura optimizada para tablets.
- Control parental granular: padres aprueban/denegan videos específicos desde Telegram mientras el niño navega libremente
- Eliminación del algoritmo: evita recomendaciones automáticas, autoplay y contenido no solicitado en la interfaz
- Gestión por categorías: límites de tiempo separados para contenido educativo vs entretenimiento con etiquetas visuales
- Bloqueo selectivo de canales: listas blancas/negras para permitir o bloquear creadores específicos permanentemente
- Programación horaria avanzada: ventanas de acceso diferenciadas por días de la semana (ej. fin de semana relajado)
- Auditoría de actividad: registro detallado de búsquedas, reproducciones y tiempo consumido por categoría
- 100% auto-alojado sin servicios en la nube ni suscripciones externas
- No requiere API key de YouTube gracias a yt-dlp para metadatos
- Bot Telegram con botones approve/deny nativos para aprobación instantánea
- Soporte multi-perfil con PINs individuales, historial y presupuestos por niño
- Base de datos SQLite local sin telemetría ni envío de datos externos
- Contenedor Docker que ejecuta como usuario no root (mejores prácticas de seguridad)
- Requiere que el dispositivo del niño esté en la misma red local para acceder a la PWA
- No bloquea YouTube directamente: necesita bloqueo adicional vía Family Link o Screen Time
- Configuración manual obligatoria de token del bot y chat ID antes del despliegue
- Dependencia de Telegram Cloud para notificaciones (requiere conexión activa)
- Interfaz web requiere navegador en el dispositivo del niño (no app nativa)
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue recomendado con Docker Compose. Editar .env con token del bot y chat ID antes de iniciar. Configurar bloqueo del dispositivo (Family Link/Screen Time) para evitar acceso directo a YouTube. Usar imagen precompilada ghcr.io/ghjj123/brainrotguard:latest para amd64/arm64 sin build step. Verificar que el puerto 8080 esté disponible en el servidor.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.