iawia002/annie
Annie
Annie is a command-line video downloader and web video extraction library written in Go. It functions as a concurrent media downloader designed to fetch video files and playlists from websites via URLs.
The tool distinguishes itself through a proxy-aware network layer that supports SOCKS5 and HTTP proxies to bypass regional content restrictions. It also incorporates session cookie integration and referrer spoofing to facilitate the download of authenticated or age-gated content.
The project provides capabilities for bulk media acquisition, including batch downloading from text files and extracting resources from playlists. It manages data transfer via multi-threaded acceleration and supports interrupted transfer resumption using byte-range headers. Additionally, it can export resource metadata in JSON format and allows for customization of local output file paths.
Features
- Media Resource Extractors - Provides a library for extracting video stream URLs and technical metadata from various web resources.
- Video Downloaders - Fetches video files from websites using specific URLs or unique stream identifiers via a command-line interface.
- Bulk Media Acquisition - Downloads entire playlists or lists of video URLs from a text file for offline archival.
- Media Downloaders - Retrieves multiple media files sequentially from a list of URLs or a text file.
- Web Resource Extraction - Extracts and saves video files from websites to a local device.
- Playlist Content Retrievers - Retrieves all videos within a playlist by specifying a target range of items to save locally.
- Traffic Routing Proxies - Directs network requests through intermediary HTTP or SOCKS5 proxies to bypass regional access restrictions.
- Proxy-Aware Clients - Routes outgoing HTTP and SOCKS5 traffic through external servers to bypass regional access restrictions.
- Segmented Downloaders - Downloads different parts of a single file concurrently across multiple threads to maximize throughput.
- Concurrent Downloaders - Utilizes multi-threaded segmented transfers to optimize network throughput for high-speed media downloading.
- Regional Access Bypassing - Uses SOCKS5 or HTTP proxies to bypass geographic restrictions and download region-locked content.
- Site-Specific Extractors - Maps specific URL patterns to dedicated extractor logic to parse video source links from different websites.
- Restricted Content Downloaders - Uses session cookies and referrers to download age-gated or restricted content from private accounts.
- Resource Metadata Extractors - Extracts and prints technical resource metadata of videos in JSON format.
- Media Metadata JSONs - Parses website source data into structured JSON formats to retrieve stream URLs and metadata.
- Video Metadata Extractors - Retrieves technical information and resource details from web videos in JSON format.
- Download Resumption - Implements interrupted transfer resumption using byte-range headers and temporary session files.
- Download Resumption Managers - Continues interrupted downloads from the last saved point using a temporary session file.
- Concurrent Download Streams - Uses multi-threaded acceleration to download different parts of a single video concurrently for increased throughput.
- Cookie Management - Supports the injection of session cookies to access restricted or age-gated video content.
- Media Download Tools - Fast and clean command-line video downloader.
- Media Downloaders - Fast and simple video downloader for various streaming platforms.
- General Productivity Tools - High-performance video downloader.
