{"id":"linuxserver-tvheadend","name":"tvheadend","homepage":"https://hub.docker.com/r/linuxserver/tvheadend","repo_url":"https://hub.docker.com/r/linuxserver/tvheadend","category":"media","subcategories":[],"tags":["media","streaming","dvb","iptv","self-hosted","tv-tuner","home-lab"],"what_it_does":"tvheadend is a TV streaming and DVB/ATSC/ISDB-T receiver server that ingests broadcast/cable/satellite signals and re-distributes them to clients over network protocols (e.g., IPTV/streaming outputs) and provides a web interface for configuration and monitoring.","use_cases":["DIY/embedded home media streaming server for over-the-air/cable/satellite TV","Centralized transcoding/stream distribution to multiple clients within a LAN","Recording/tuning workflows by managing channels/multiplexes and stream outputs","Running a headend for DVB-T/T2/C/S/S2 and (depending on build) ATSC/ISDB-T sources"],"not_for":["Managed cloud TV platforms requiring vendor-hosted streaming","Environments needing strict enterprise-grade authentication/authorization out of the box via OAuth/SAML","Use cases that require a fully featured public REST/GraphQL API with stable contracts for automation (beyond its existing web/UI interfaces)"],"best_when":"You control the deployment environment (typically LAN), need a self-hosted TV headend/streaming server, and can manage configuration/admin access for the web UI.","avoid_when":"You need a modern API-first developer experience with documented endpoints, strong authn/authz defaults, and clear rate-limit/retry semantics for programmatic agent use.","alternatives":["Media servers/TV ingestion alternatives such as NextPVR/Emby/Jellyfin with TV tuner support (where applicable)","VDR (Video Disk Recorder) ecosystem","DVB/receiver-to-stream solutions like MythTV (where applicable)","Standalone streaming pipelines using ffmpeg with tuner capture (more DIY)"],"af_score":24.0,"security_score":43.2,"reliability_score":36.2,"package_type":"mcp_server","discovery_source":["docker_mcp"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:33:20.083898+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["HTTP basic/digest-style access (varies by configuration)","Web UI authentication/authorization as supported by the tvheadend web interface"],"oauth":false,"scopes":false,"notes":"tvheadend deployments are typically self-hosted and protected by network controls; auth details depend on configuration (not provided in the prompt data). No evidence of OAuth or fine-grained scopes in the provided material."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source/self-hosted; costs are infrastructure and operational overhead."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":24.0,"security_score":43.2,"reliability_score":36.2,"mcp_server_quality":0.0,"documentation_accuracy":20.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":45.0,"rate_limit_clarity":0.0,"tls_enforcement":60.0,"auth_strength":45.0,"scope_granularity":20.0,"dependency_hygiene":40.0,"secret_handling":50.0,"security_notes":"Security posture depends heavily on deployment (LAN-only vs exposed to the internet) and tvheadend configuration for web access. No evidence provided here for strong OAuth-based auth, fine-grained scopes, or documented security controls. Ensure TLS/reverse-proxy hardening, restrict admin access, and keep the software updated.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":50.0,"error_recovery":40.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["tvheadend is primarily a self-hosted service with a web UI; automation often requires scraping or interacting with server endpoints not standardized as an agent-friendly API","Operational changes may be stateful (tuner/channel configuration); re-running actions may not be idempotent without careful design","Auth behavior and available interfaces may vary by deployment/config/build, so agents need environment-specific assumptions"]}}