v2.2.0

VantaEther v2.2.0 Release Notes

This release marks a significant evolution in VantaEther's capabilities, focusing on advanced stream discovery and powerful media processing. The engine is now smarter, more resilient, and more flexible than ever before.

---

🚀 New Features

1. Intelligent Stream Discovery Engine

The core detection logic has been supercharged with two new major features, allowing VantaEther to succeed where other tools fail.

• Content-Type Header Sniffing: The browser agent can now identify HLS/DASH manifests even when the URLs are obfuscated (e.g., no .m3u8 or .mpd extension). It intelligently inspects response headers to find the real stream type.
• JSON API Parsing: VantaEther now proactively scans network requests that look like internal API calls. It recursively searches the JSON response data to find hidden video links, quality levels, and metadata before they are even loaded into a web player.

2. Multi-Audio & Multi-Subtitle Merging

You now have full control over the language tracks in your downloads.

• The UI now allows for selecting multiple audio tracks and multiple subtitle files simultaneously.
• The merging engine has been completely overhauled to dynamically build complex ffmpeg commands, muxing all selected streams into a single MKV/MP4 file.
• Crucially, correct language metadata is applied to each audio and subtitle track, ensuring seamless playback and language selection in media players like VLC.

---

✨ Improvements & QoL

• --no-animation Flag: A new command-line flag has been added to skip the decorative startup animation for a faster launch experience.
• Revamped Documentation: The project's README.md has been completely rewritten to be more comprehensive, modern, and accurately reflect all the new powerful features.

---

Full Changelog: v2.1.1...v2.2.0

Installation / Update

# Update from GitHub
pip install -U git+https://github.com/ciwga/VantaEther.git

v2.1.1

VantaEther v2.1.1 - Minor Release

This minor release focuses on refining the "Dual Mode" logic, enhancing the Smart URL Display for better UX, and strengthening the cross-platform directory resolution system.

Improvements

• Smart URL Normalization: The TUI now intelligently analyzes and displays the last two segments of capture paths (e.g., .../folder/file.m3u8) instead of truncated domain roots. This provides immediate context for identifying specific media streams in high-traffic scenarios.
• Dynamic Server Configuration: Users can now explicitly define the --host and --port via CLI arguments. This allows VantaEther to bind to specific network interfaces (e.g., 0.0.0.0 for LAN access) or use alternative ports if the default 5005 is occupied.
• Real-time FFmpeg Progress: The merging process (Muxing) now features a dynamic progress bar. It utilizes regex parsing to capture total duration and current time directly from FFmpeg, providing accurate percentage updates and ETA during video/audio merging.

Installation / Update

# Update from GitHub
pip install -U git+https://github.com/ciwga/VantaEther.git

Full Changelog: v2.1...v2.1.1

v2.1

VantaEther v2.1 - Performance & Stability Release

This update focuses on hardening the application against memory leaks during long-running sessions and optimizing internal data structures for a lower resource footprint.

Core Optimizations

• Memory Efficient Data Models: The CapturedItem class has been migrated to use __slots__, significantly reducing memory overhead for high-volume captures by eliminating dynamic dictionary allocation.
• Auto-Pruning Mechanism: The CaptureManager now enforces a strict cap (2000 items) on stored media. Old entries are automatically rotated out to prevent infinite memory growth during extended usage.

Browser Agent v2.1

• Active Memory Guard: The UserScript now includes an intelligent garbage collection mechanism. It periodically prunes the processed URL history (sent Set) and caps the offline request queue to prevent browser memory exhaustion.
• Enhanced Connectivity: The connection health check logic (checkConnection) has been refined for more reliable server detection and queue flushing.

---

... and various improvements.

---

Installation

pip install vantaether-2.1.0-py3-none-any.whl

Full Changelog: v2.0...v2.1

v2.0

VantaEther v2.0 - Technical Release Notes

This version represents a complete architectural overhaul, transitioning from a monolithic structure to a modular, service-oriented system designed for performance, sustainability, and reliability.

Architectural Overhaul

• Service-Oriented Design: The core logic has been decoupled into specialized services such as DownloadManager, FileManager, PlaylistManager, and FormatSelector to ensure a clear separation of concerns.
• Enhanced Dependency Injection: A robust Dependency Injection structure has been implemented for the internal Flask server (VantaServer) and state management (CaptureManager) to improve testability and system isolation.
• Thread-Safe State Management: The new CaptureManager utilizes thread locks and events to manage concurrent stream captures from the browser without race conditions.

Advanced Sync Mode (Sniffer) v2.0

• Intelligent Backoff System: The UserScript now includes a connection manager featuring exponential backoff. Captured links are queued in the browser even if the server is offline and are automatically transmitted once the connection is established.
• SSE (Server-Sent Events) Integration: Inefficient frontend polling has been replaced with a real-time SSE stream; the UI updates instantly when media is captured.
• Enhanced Capture Logic: The capture logic has been improved with a more robust filtering system for HLS (m3u8), DASH (mpd), and external subtitles, excluding static assets.

Media Intelligence & Reporting

• ReportGenerator Service: A dedicated service has been added that generates comprehensive technical JSON reports, including codec details, bitrate, and resolution via ffprobe for every downloaded media item.
• MediaAnalyzer Engine: A new cross-platform analysis engine has been added to provide deep technical inspection of media streams before and after processing.

Core Improvements & New Features

• Improved Playlist Handling: Native Mode has been enhanced with the PlaylistManager, providing precise control over bulk downloads and YouTube playlist reconstruction.
• Intelligent Stream Merging: StreamMerger can now handle complex merging scenarios, including external subtitle embedding (MKV/MP4) and manual audio/video synchronization using FFmpeg.
• Cross-Platform Path Resolution: The new DirectoryResolver ensures reliable download operations by managing permission-aware paths across Windows, Linux, macOS, and Android (Termux).
• Localization (i18n): Full UI support for Turkish and English languages has been established through a centralized LanguageManager.

Code Quality & Security

• PEP8 & Type Safety: The entire codebase has been restructured with strict PEP8 compliance and full type annotations.
• Resource Management: Secure cleanup of temporary files, such as cookie files and partial downloads, has been ensured.
• Security Focus: Restricted file permissions (chmod 0600) have been applied to sensitive data like cookie files, and unnecessary log outputs have been suppressed to prevent data leakage.

---

Installation

pip install vantaether-2.0-py3-none-any.whl

Full Changelog: v1.0...v2.0

v1.0

Full Changelog: https://github.com/ciwga/VantaEther/commits/v1.0