ClawShorts
YouTube Shorts limiter for Fire TV. Monitors watch time per device and auto-blocks when daily limit is reached.
Invocation
Primary entry point:
~/.openclaw/workspace/skills/clawshorts/scripts/clawshorts.sh <command>
Commands
| Command | When to use |
|---|---|
status |
Check today's usage, remaining quota, daemon health |
reset [IP] |
Reset today's counter (all devices or specific IP) |
start |
Start the daemon if not running |
stop |
Stop the daemon |
history [days] |
Show watch history (default 30 days) |
logs [N] |
Show last N daemon log lines (default 50) |
list |
List all configured devices |
setup <IP> [NAME] |
First-time setup for a new device |
add <IP> [NAME] |
Add another Fire TV |
connect <IP> |
Connect ADB to device |
enable <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
shortssymlink at/opt/homebrew/bin/shorts