chrippa/livestreamer
Livestreamer
Livestreamer is a command-line stream extractor and modular streaming client designed to resolve hidden media source URLs from online services. It functions as a media pipeline utility that extracts direct media URLs and binary data for local saving, specialized processing, or routing into external media players.
The project uses a plugin-based system with custom heuristic logic to extend service support and override default capabilities. It includes a network proxy router to bypass regional blocks and network restrictions through configurable HTTP and HTTPS proxies, and manages authentication tokens and cookies to access subscription-only or premium content.
The tool supports the extraction of both live video and video-on-demand content, which can be routed via standard input piping, written to the file system, or served over HTTP as a stream proxy. It also provides utilities for stream metadata inspection and programmatic retrieval of raw binary stream data.
Features
- Video Stream Extraction - Resolves hidden media source URLs and extracts raw binary data from online streaming platforms.
- External Media Player Integration - Forwards extracted media streams to external players via stdin, named pipes, or HTTP for non-browser playback.
- External Video Playback - Redirects extracted media streams to third-party local players to avoid using web browsers.
- Media Processing Pipelines - Implements a programmatic pipeline for routing binary stream data to files or external processing tools.
- Multi-Platform Video Extraction - Extracts recorded video-on-demand streams from a wide variety of supported online platforms.
- Live Stream Extraction - Retrieves direct stream URLs from live broadcasts for redirection into external media players.
- Stream Source Resolution - Uses predefined patterns and plugins to resolve the actual media source URL from service responses.
- Programmatic Stream Data Access - Provides a programmatic interface to fetch video stream information and raw binary data for custom media playback.
- Stream Extractors - Functions as a command-line tool to isolate direct media stream URLs for external playback.
- Video Streaming Clients - Provides a modular, plugin-based client for extracting live video streams from diverse platforms.
- Subscription Content Authentication - Uses credentials and tokens to access subscription-only or premium media content from supported services.
- Directory-Based Plugin Loading - Automatically discovers and loads standalone plugin files from specified directories to extend functionality.
- Extraction Plugins - Employs a modular plugin system to define platform-specific heuristics for extracting hidden media URLs.
- Modular Plugin Architectures - Implements a modular architecture that allows new streaming services to be added via custom plugins.
- Binary Stream Interfaces - Exposes extracted stream data as binary file-like objects for incremental reading and storage.
- Incremental Data Streaming - Reads raw media data incrementally using file-like objects for memory-efficient processing.
- Session Persistence - Maintains session states and authentication data locally to ensure continuity across multiple stream extractions.
- Stdin Pipe Writers - Streams raw binary video data directly to external processes via standard input piping.
- Local Media Stream Hosting - Serves extracted stream data over a local HTTP server to enable playback on external devices.
- Stream Metadata Inspection - Provides capabilities to retrieve internal stream parameters and direct source URLs for analysis.
- Media Stream Proxies - Serves extracted video data over HTTP to enable playback on external devices without a local player.
- Proxy Request Routers - Routes outgoing requests through proxies to bypass regional blocks and network restrictions.
- HTTP Request Customization - Allows modifying HTTP request headers and certificates to bypass regional locks and manage authentication.
- Traffic Routing Proxies - Directs network traffic through intermediary servers to bypass regional content restrictions.
- Proxy Routing - Routes network requests through configurable HTTP and HTTPS proxies to bypass regional content restrictions.
- Regional Restriction Bypasses - Bypasses geographic restrictions and network blocks using configurable proxy routing and custom headers.
- Standard Stream Piping - Streams raw binary video data directly to external processes via standard input piping.
- Streaming Protocols - Provides direct access to media streams via specific protocol URL formats.
- Session-Cookie Persistences - Persists cookies and authentication headers across sessions to maintain access to restricted streams.
- Audio and Subtitle Tools - Command-line utility to extract streams for media players.
- Streaming and Recording - Command-line tool to stream video from multiple platforms.
