Back to appsSubmit
BrainRotGuard

BrainRotGuard

Docker app from UR-jay's Repository

Overview

YouTube approval system for kids. Your child searches YouTube via a kid-friendly web UI, you get a Telegram notification with thumbnail and details, tap Approve or Deny, and approved videos play via privacy-enhanced embeds. Includes channel allow/block lists, daily watch time limits, scheduled access windows, category labeling, and search history tracking. Pair with DNS blocking (Pi-hole/AdGuard) for full control.

Requirements

A Telegram Bot Token (create one via @BotFather) and your Telegram Chat ID.

Runtime arguments

Web UI
http://[IP]:[PORT:8080]
Network
bridge
Privileged
false

Template configuration

Web UI PortPorttcp

Port for the BrainRotGuard web interface.

Target
8080
Default
8080
DatabasePathrw

Stores the SQLite database (watch history, approvals, channel lists).

Target
/app/db
Default
/mnt/user/appdata/brainrotguard/db
Config File (optional)Pathro

Optional: mount a custom config.yaml for advanced settings. Leave empty to configure entirely via environment variables.

Target
/app/config.yaml
Telegram Bot TokenVariable

Bot token from @BotFather on Telegram.

Target
BRG_BOT_TOKEN
Telegram Admin Chat IDVariable

Your Telegram numeric chat ID. Send /start to @userinfobot to find it.

Target
BRG_ADMIN_CHAT_ID
PIN CodeVariable

Optional PIN to protect the web UI. Leave empty for no PIN.

Target
BRG_PIN
Base URLVariable

LAN URL for Telegram deep links (e.g. http://192.168.1.50:8080). Auto-detected if empty.

Target
BRG_BASE_URL
Daily Watch Limit (minutes)Variable

Daily screen time limit in minutes. 0 = unlimited.

Target
BRG_DAILY_LIMIT_MINUTES
Default
120
TimezoneVariable

Timezone for daily limit resets and scheduled access windows (e.g. America/Chicago, Europe/London).

Target
BRG_TIMEZONE
Default
America/New_York

Categories

Media App > VideoHome AutomationTools > Utilities

Links

TemplateSupportRegistryProject

Details

Repository
ghcr.io/ghjj123/brainrotguard:latest
Registry
https://github.com/GHJJ123/brainrotguard/pkgs/container/brainrotguard
Last Updated2026-05-31
First Seen2026-03-04

Run BrainRotGuard on Unraid.

BrainRotGuard is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS