chromecast-controlControl Chromecast devices on your local network - discover, cast media, control playback, manage queues, and save/restore states
Install via ClawdBot CLI:
clawdbot install morozRed/chromecast-controlInstall via pip/uv:
Install via pip/uvRequires:
Control Chromecast and Google Cast-enabled devices on your local network using catt (Cast All The Things).
| Command | Description |
|---------|-------------|
| catt scan | Find all Chromecasts on network |
| catt cast | Cast video/audio |
| catt pause / play | Pause/resume |
| catt stop | Stop playback |
| catt status | Current playback info |
| catt volume <0-100> | Set volume |
Use -d to target a specific device by name or IP.
# Find all devices
catt scan
# Set a default device (saves to config)
catt -d "Living Room TV" set_default
# Create an alias for easier access
catt -d 192.168.1.163 set_alias tv
# Remove alias or default
catt -d tv del_alias
catt del_default# Cast from URL (YouTube, Vimeo, and hundreds of yt-dlp supported sites)
catt cast "https://www.youtube.com/watch?v=VIDEO_ID"
# Cast local file
catt cast ./video.mp4
# Cast a website (displays webpage on TV)
catt cast_site "https://example.com"# Cast with subtitles
catt cast -s ./subtitles.srt ./video.mp4
# Start at specific timestamp
catt cast -t 01:30:00 "https://youtube.com/watch?v=VIDEO_ID"
# Play random item from playlist
catt cast -r "https://youtube.com/playlist?list=PLAYLIST_ID"
# Play only video (ignore playlist in URL)
catt cast -n "https://youtube.com/watch?v=VIDEO_ID&list=PLAYLIST_ID"
# Disable automatic subtitle loading
catt cast --no-subs ./video.mp4
# Pass yt-dlp options (e.g., select format)
catt cast -y format=best "https://youtube.com/watch?v=VIDEO_ID"
# Block until playback ends (useful for scripts)
catt cast -b "https://example.com/video.mp4"catt play # Resume playback
catt pause # Pause playback
catt play_toggle # Toggle play/pause
catt stop # Stop playback completely
catt skip # Skip to end of content
# Seeking
catt seek 300 # Jump to 5 minutes (seconds)
catt seek 01:30:00 # Jump to 1h 30m (HH:MM:SS)
catt ffwd 30 # Fast forward 30 seconds
catt rewind 30 # Rewind 30 secondscatt volume 50 # Set volume to 50%
catt volumeup 10 # Increase by 10
catt volumedown 10 # Decrease by 10
catt volumemute on # Mute
catt volumemute off # Unmute# Add video to end of queue
catt add "https://youtube.com/watch?v=VIDEO_ID"
# Add video to play next
catt add -n "https://youtube.com/watch?v=VIDEO_ID"
# Remove video from queue
catt remove "https://youtube.com/watch?v=VIDEO_ID"
# Clear entire queue
catt clear# Save current state (position, volume, what's playing)
catt save
# Restore saved state later
catt restorecatt status # Brief: time, volume, mute status
catt info # Full: title, URL, player state, media type, etc.Config file: ~/.config/catt/catt.cfg
[options]
device = Living Room TV
[aliases]
tv = Living Room TV
bedroom = Bedroom Speakercatt scan failsCatt uses yt-dlp internally, supporting:
Generated Mar 1, 2026
Users can stream videos, music, and websites from various online platforms or local files to their Chromecast-enabled TVs or speakers. This is ideal for personal media consumption, such as watching YouTube videos, playing music playlists, or displaying web content on a larger screen during gatherings.
Businesses can use this skill to cast websites, images, or videos to Chromecast devices for digital signage in retail stores, offices, or events. It allows for easy control of playback, queuing content, and managing displays without specialized hardware, enhancing visual communication and advertising efforts.
Integrate Chromecast control into home automation systems to manage media playback based on routines or triggers. For example, automatically casting morning news or music to specific rooms, adjusting volume with voice commands, or saving and restoring playback states for seamless entertainment experiences across devices.
Developers and content creators can use this skill to test media playback on Chromecast devices from various sources, including local files and online URLs. It supports advanced features like subtitles, timestamps, and yt-dlp options, making it useful for quality assurance, demo presentations, or streaming setup verification.
Educators and trainers can cast educational videos, websites, or presentations to Chromecast devices in classrooms or training rooms. Features like queue management, playback control, and state saving facilitate interactive lessons, allowing for easy content switching and resuming sessions without disruption.
Offer a basic version of the skill for free with core casting and control features, then charge for premium capabilities such as advanced queue management, multi-device synchronization, or cloud-based state saving. Revenue can come from subscription fees or one-time purchases for enhanced functionality.
License the skill to businesses for integration into their products, such as smart home systems, digital signage platforms, or enterprise presentation tools. Provide custom development support and API access, generating revenue through licensing fees, maintenance contracts, and tailored solutions for specific industry needs.
Develop a user-friendly app or interface around the skill that includes advertising, such as promoted media sources or sponsored content recommendations. Monetize through ad revenue while offering the core functionality for free, targeting casual users who value convenience over advanced features.
π¬ Integration Tip
Ensure the host system has 'catt' installed via pip/uv and that network settings allow mDNS and necessary ports for local file casting to avoid connectivity issues.
Terminal Spotify playback/search via spogo (preferred) or spotify_player.
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Download videos from YouTube, Bilibili, Twitter, and thousands of other sites using yt-dlp. Use when the user provides a video URL and wants to download it, extract audio (MP3), download subtitles, or select video quality. Triggers on phrases like "δΈθ½½θ§ι’", "download video", "yt-dlp", "YouTube", "Bη«", "ζι³", "ζει³ι’", "extract audio".
Search and add movies to Radarr. Supports collections, search-on-add option.
Control Spotify playback on macOS. Play/pause, skip tracks, control volume, play artists/albums/playlists. Use when a user asks to play music, control Spotify, change songs, or adjust Spotify volume.
Search and add TV shows to Sonarr. Supports monitor options, search-on-add.