Clawshorts Pkg
/install clawshorts-pkg
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 \x3Ccommand>
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 \x3CIP> [NAME] |
First-time setup for a new device |
add \x3CIP> [NAME] |
Add another Fire TV |
connect \x3CIP> |
Connect ADB to device |
enable \x3CIP> / disable \x3CIP> |
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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clawshorts-pkg - After installation, invoke the skill by name or use
/clawshorts-pkg - Provide required inputs per the skill's parameter spec and get structured output
What is Clawshorts Pkg?
Block YouTube Shorts on Fire TV. Use when asked to check, manage, or configure YouTube Shorts limiting on Buck's Fire TV devices. Triggers on requests like "... It is an AI Agent Skill for Claude Code / OpenClaw, with 91 downloads so far.
How do I install Clawshorts Pkg?
Run "/install clawshorts-pkg" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Clawshorts Pkg free?
Yes, Clawshorts Pkg is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Clawshorts Pkg support?
Clawshorts Pkg is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Clawshorts Pkg?
It is built and maintained by cindulasai (@cindulasai); the current version is v1.0.4.