selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
brainrotguard logo

Self-host brainrotguard

v1.33.0

YouTube approval system for kids via Telegram

ReleaseOpen SourceMIT
Updated10 hours ago
LanguagePython
Setup difficultyModerate
MobilePWA
ThemeDark mode
Stars
396
Port
8080 (web UI)
Docker
ghcr.io/ghjj123/brainrotguard
Install with Docker
BrainRotGuard on desktop, tablet, and phone — homepage, search, watch, and activity views

What is brainrotguard?

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.

Should you self-host brainrotguard?

brainrotguard scores 49/100 on selfhost.directory (how scoring works) and ranks #10 of 22 in Home Server. It has 396 GitHub stars.

It shipped 12 stable releases in the past year. The latest, v1.33.0, came out on 29 September 2026. New versions land roughly every 4 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is CasaOS (76/100, 37 389 stars). It scores higher overall, so compare the two before you pick. See brainrotguard vs CasaOS side by side.

Features

  • Channel allow/block lists
  • Daily screen time limits
  • Educational vs entertainment categories
  • Guided setup wizard
  • Multi-child profiles
  • PIN lock for web UI
  • Scheduled viewing hours
  • Search History
  • Search-off mode
  • Telegram-based approval workflow
  • Update Notifications
  • Watch activity log
  • Word filters
  • YouTube Shorts control

brainrotguard README

How to install brainrotguard

Install brainrotguard with Docker

Docker
Environment variables
BRG_BOT_TOKEN, BRG_ADMIN_CHAT_ID, BRG_PIN, BRG_BASE_URL, BRG_TELEGRAM_API_URL

docker pull ghcr.io/ghjj123/brainrotguard:latest

Then use docker-compose.example.yml with the pre-built image

No build step; supports amd64 and arm64 (Raspberry Pi, Unraid)

brainrotguard releases & version history

More in Home Server

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…