# brainrotguard

> Self-hosted YouTube approval system: kids request videos on a web UI, parents approve/deny via Telegram. No algorithmic recommendations, no ads, full parental control.

- **Category:** Home Server
- **Licence:** MIT
- **Latest version:** v1.33.0
- **Open source:** oss
- **Languages:** Python, HTML
- **Platforms:** Docker, Docker Compose, Python, Unraid
- **Tags:** SQLite, Pwa, Youtube, Yt Dlp, Docker, Python, Fastapi, Telegram bot, Self Hosted, Parental controls, Screen Time, Kids Safety

## Description

BrainRotGuard lets parents control what their children watch on YouTube. Kids search for videos on a tablet web page and send requests. Parents get a Telegram notification showing the video details and tap Approve or Deny. Approved videos play right away on the child's device. The software uses yt-dlp to fetch YouTube data without an API key and embeds videos from youtube-nocookie.com. It supports multiple child profiles, each with a PIN, separate watch history, and time budgets. Content can be labeled as educational or entertainment with different daily limits. Viewing schedules can be set per day of the week. Channels can be allowlisted for automatic approval or blocked entirely. Word filters hide videos with specific terms in the title. A Telegram bot provides a setup wizard and commands for managing everything. The app runs in Docker with pre-built images for amd64 and arm64, or directly with Python 3.11+. All data lives in one SQLite file. It is MIT licensed and has an Unraid template.

## Links

- [Homepage](https://github.com/GHJJ123/brainrotguard)
- [Docker](ghcr.io/ghjj123/brainrotguard)
- [Setup Guide](https://github.com/GHJJ123/brainrotguard/blob/main/docs/setup.md)
- [Configuration Reference](https://github.com/GHJJ123/brainrotguard/blob/main/docs/configuration.md)
- [Telegram Commands](https://github.com/GHJJ123/brainrotguard/blob/main/docs/telegram-commands.md)
- [Troubleshooting](https://github.com/GHJJ123/brainrotguard/blob/main/docs/troubleshooting.md)
- [Architecture](https://github.com/GHJJ123/brainrotguard/blob/main/docs/architecture.md)
- [Design Decisions](https://github.com/GHJJ123/brainrotguard/blob/main/docs/design-decisions.md)
- [Running Without Docker](https://github.com/GHJJ123/brainrotguard/blob/main/docs/running-without-docker.md)
- [Locale Guide](https://github.com/GHJJ123/brainrotguard/blob/main/i18n/locales/README.md)
- [GitHub Repository](https://github.com/GHJJ123/brainrotguard)

---
Source: https://selfhost.directory/project/brainrotguard