Control Chromecast devices on your local network - discover, cast media, control playback, manage queues, and save/restore states
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Control Chromecast and Google Cast-enabled devices on your local network using
catt| Command | Description |
|---|---|
| Find all Chromecasts on network |
| Cast video/audio |
| Pause/resume |
| Stop playback |
| Current playback info |
| Set volume |
Use
-d <device># Find all devices catt scanSet 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.mp4Start 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 contentSeeking
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 seconds
catt 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 saveRestore saved state later
catt restore
catt 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 Speaker
catt scanCatt uses yt-dlp internally, supporting:
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.