media-cli-local — Terminal Control for Your *arr Media Stack#

One bash script to manage your entire media automation stack. Search, add, download, and monitor movies and TV shows without touching a web UI.

Designed for setups where the agent and media services run on the same machine. If your *arr stack runs on a different host, see media-cli which includes SSH remote support.

Source: https://github.com/solomonneas/media-cli

Install: Clone the repo and copy the script to your PATH. Review it first.

bash

git clone https://github.com/solomonneas/media-cli.git
cd media-cli
cp media ~/bin/media && chmod +x ~/bin/media
media setup

Supported Services#

ServiceRequiredWhat It DoesSonarrYesTV show managementRadarrYesMovie managementProwlarrYesIndexer managementqBittorrentYesDownload monitoringBazarrOptionalSubtitlesJellyseerrOptionalUser requests + trendingTdarrOptionalTranscode monitoring

Setup#

The setup wizard asks for API URLs and keys, saves to ~/.config/media-cli/config (chmod 600). All connections are localhost only.

bash

media setup    # Interactive config wizard
media status   # Verify everything connects

Commands#

Movies#

bash

media movies search "Interstellar"    # Search online
media movies add "Interstellar"       # Add + start downloading
media movies list                     # Library with download status
media movies missing                  # Monitored without files
media movies remove "title"           # Remove (keeps files)

TV Shows#

bash

media shows search "Breaking Bad"     # Search online
media shows add "Breaking Bad"        # Add + search episodes
media shows list                      # Library with episode counts

Downloads#

bash

media downloads                       # All torrents by state
media downloads active                # Active with speed + ETA
media downloads pause <hash|all>
media downloads resume <hash|all>
media downloads remove <hash> [true]  # true = delete files too

Status & Monitoring#

bash

media status                          # Health + library counts + active downloads
media queue                           # Sonarr/Radarr download queues
media wanted                          # Missing episodes + movies
media calendar 14                     # Upcoming releases (next N days)
media history                         # Recent activity
media refresh                         # Trigger library rescan
media indexers                        # Prowlarr indexer status

Subtitles (Bazarr)#

bash

media subs                            # Wanted subtitles
media subs history                    # Recent subtitle downloads

Requests (Jellyseerr)#

bash

media requests                        # Pending user requests
media requests trending               # What's trending
media requests users                  # User list with request counts

Transcoding (Tdarr)#

bash

media tdarr                           # Status + active workers
media tdarr workers                   # Per-file progress: %, fps, ETA
media tdarr queue                     # Items queued for processing

AI Agent Integration#

Commands output clean, parseable text designed for AI agents:

text

"What shows am I missing episodes for?"  →  media wanted
"Add Succession"                         →  media shows add "Succession"
"What's downloading right now?"          →  media downloads active
"Pause all downloads"                    →  media downloads pause all

Works with OpenClaw, LangChain, Claude computer use, or any agent framework with shell execution.

Requirements#

• bash 4.0+
• curl
• python3 (standard library only, no pip)

Technical Details#

• Single bash script (~900 lines)
• All API calls go to localhost (no remote connections)
• Talks to *arr v3 APIs (Sonarr/Radarr), v1 (Prowlarr), v2 (qBittorrent WebUI)
• Python3 used strictly for JSON parsing (standard library)
• No telemetry, no analytics, no network calls except to your own services
• Config stored at ~/.config/media-cli/config with chmod 600