ClawShorts#

YouTube Shorts limiter for Fire TV. Monitors watch time per device and auto-blocks when daily limit is reached.

Invocation#

Primary entry point:

bash

~/.openclaw/workspace/skills/clawshorts/scripts/clawshorts.sh <command>

Commands#

CommandWhen to usestatusCheck today's usage, remaining quota, daemon healthreset [IP]Reset today's counter (all devices or specific IP)startStart the daemon if not runningstopStop the daemonhistory [days]Show watch history (default 30 days)logs [N]Show last N daemon log lines (default 50)listList all configured devicessetup <IP> [NAME]First-time setup for a new deviceadd <IP> [NAME]Add another Fire TVconnect <IP>Connect ADB to deviceenable <IP> / disable <IP>Enable/disable a device

Detection Logic#

• Poll interval: 3 seconds via ADB
• Shorts: ~45% screen width (portrait aspect)
• Regular video: ~100% screen width
• Home/browse: no video active
• Only actual Shorts playback counts toward limit

Data Locations#

• Device config + history: ~/.clawshorts/clawshorts.db (SQLite)
• Daemon log: ~/.clawshorts/daemon.log
• LaunchAgent: ~/Library/LaunchAgents/com.fink.clawshorts.plist

Requirements#

• adb (Android platform tools)
• Python 3
• Fire TV with ADB debugging enabled
• shorts symlink at /opt/homebrew/bin/shorts