Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
docs: streamline readmes and sync technical guides with codebase
Samir Hossains4c1228f076cb
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 7f202b9..98bde47 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -34,15 +34,15 @@ Short version:- `src/tui/app/`: The application object (`App`). `run.rs` holds the thin`handle_action` dispatcher that routes every `Action` to a `handle_*` method in its- module (`run.rs`, `requests.rs`, `search.rs`, `playback.rs`, `download.rs`,+ module (`run.rs`, `requests.rs`, `search.rs`, `playback.rs`, `download.rs`, `favorites.rs`,`navigation.rs`, `tv.rs`, `addons.rs`, `keyboard.rs`, `mouse.rs`, `system.rs`, `network.rs`).-- `src/tui/`: UI state, event loop plumbing, slash commands (`commands.rs`), screens, themes.-- `src/providers/`: HTTP clients for streaming sources (`moviebox`, `fourkhdhub`,+- `src/tui/`: UI state, event loop plumbing, slash commands (`commands.rs`), screens, themes, and widgets.+- `src/providers/`: HTTP clients for streaming sources (`moviebox`, `fourkhdhub`, `dramachi`,`bdix`), community HTTP addons (`addons/`), and Live TV playlists (`tv/`).- `src/service.rs`: Unified headless multi-provider client & engine.-- `src/download.rs`: Background media downloading.-- `src/cache.rs`: Local disk caching to minimize API calls.-+- `src/proxy.rs`: Local loopback HTTP proxy for authenticated CloudFront streams.+- `src/download.rs`: Background multi-segment media downloading.+- `src/cache.rs`: Local binary MessagePack disk caching.The app is message-driven. User input and background tasks produce `Action` values,handled by the dispatcher in `src/tui/app/run.rs`. When adding behavior, prefer adding anew `Action` variant over blocking the UI thread.diff --git a/README.md b/README.mdindex dacd731..3b2a4c7 100644--- a/README.md+++ b/README.md@@ -17,80 +17,64 @@## Features-- **On Demand Streaming**: Stream movies, TV series, anime, and Asian dramas across multiple native providers and community Stremio addons.-- **Live TV & IPTV**: Import custom M3U playlist URLs to search channels, browse categories, and stream live television.-- **Quality & Resolution Selection**: Choose preferred stream resolutions (`1080p`, `720p`, `480p`) directly from the details screen.-- **Hardware Accelerated Playback**: Plays directly in your preferred local media player with automatic authentication and cookie forwarding.-- **Multi Segment Downloader**: Download individual episodes or full seasons concurrently with HTTP range pause and resume support.-- **Automatic Subtitles**: Searches and synchronizes subtitles in your preferred language automatically.-- **Interactive Terminal UI**: Full keyboard and mouse support with vim navigation and command auto suggestions.-- **Visual Posters & Themes**: Renders cover art directly in your terminal, with 9 built-in themes and automatic light and dark detection.-- **Library & Progress Tracking**: Star favorites, track watch history, and resume playback where you left off.-- **Cross Platform & Private**: Runs natively on macOS, Linux, Windows, and Android (Termux) with zero telemetry or data collection.+- **Streaming:** Movies, TV series, anime, Asian dramas, and community Stremio addons across multiple native providers.+- **Live TV:** M3U playlist import with channel categories, EPG support, and search.+- **Resolution Picker:** Direct stream quality selection (`4K`, `1080p`, `720p`, `480p`, `Auto`) before playback.+- **Hardware Players:** Seamless launch in `mpv`, `VLC`, or `IINA` with custom auth header and cookie forwarding.+- **Batch Downloader:** Multi-segment concurrent downloader with HTTP range pause and resume for episodes and full seasons.+- **Subtitle Picker:** Multi-language subtitle tracks extracted and selectable via an interactive picker before playback or download.+- **Terminal UI:** Vim navigation, mouse interaction, slash command palette (`/help`, `/settings`), and 9 built-in themes.+- **Cover Art:** Native Kitty, Sixel, and iTerm2 poster rendering with automatic text fallback.+- **Resume & Library:** Home deck with continue-watching timestamps, watch history, and favorites stored strictly on local disk. Zero telemetry.## Prerequisites-### Supported Media Players--Requires at least one supported media player installed on your system:--- **Desktop (macOS, Linux, Windows):** [mpv](https://mpv.io/), [VLC](https://www.videolan.org/), or [IINA](https://iina.io/) *(macOS)*.-- **Android (Termux):** Any external video player ([VLC](https://play.google.com/store/apps/details?id=org.videolan.vlc), Just Player, or MX Player).--### Terminal Graphics (Posters)--Poster rendering automatically adapts to your terminal environment:--- **Graphics-capable terminals:** Displays high-resolution movie and series posters natively (Ghostty, Kitty, WezTerm, iTerm2, foot, and Windows Terminal v1.22+). Windows requires no third-party terminal; updating built-in Windows Terminal to v1.22+ via the Microsoft Store enables native poster rendering.-- **Standard terminals:** Displays clean, structured text placeholders (`No Art`) automatically.--### Optional Dependencies-- **`yt-dlp` & `ffmpeg`:** Required only when downloading DASH streams from the MovieBox provider. All other providers download directly through the built-in HTTP engine.+- **Media Player:** `mpv`, `VLC`, or `IINA` (macOS) / any external video player (Android).+- **Posters:** Terminal with Sixel, Kitty, or iTerm2 support (Ghostty, Kitty, WezTerm, iTerm2, foot, Windows Terminal v1.22+).+- **DASH Downloads:** `yt-dlp` and `ffmpeg` (required only for MovieBox DASH downloads).## Installation-### macOS and Linux+### macOS & Linux-Open Terminal and run:+If you have [Homebrew](https://brew.sh/) on macOS:```bash-curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash+brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui+brew install moviebox-tui```-Or via Homebrew (macOS):+> **Note:** If Homebrew prompts for tap verification on initial install, run `brew trust mesamirh/moviebox-tui`.++Direct install via Terminal (macOS & Linux, no package manager needed):```bash-brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui-brew install moviebox-tui+curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash```-> [!NOTE]-> If Homebrew prompts for tap verification on initial install, run `brew trust mesamirh/moviebox-tui`.### Windows-Via Scoop:+If you have [Scoop](https://scoop.sh/) (recommended):```powershellscoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tuiscoop install moviebox-tui```-Or automated PowerShell script:+Direct install via PowerShell (no package manager needed):```powershellirm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex```-### Android (Termux)+> **SmartScreen prompt:** If Windows displays *"Windows protected your PC"*, click **More info** → **Run anyway**.-Open Termux and run:+### Android (Termux)```bashpkg update && pkg install -y curl tar termux-tools termux-amcurl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bashtermux-setup-storage```-> [!IMPORTANT]-> Video playback on Android launches through your installed external media player (such as VLC, Just Player, or MX Player).+<details>-<summary><b>Cargo and Source Build</b></summary>+<summary><b>Cargo & Source Build</b></summary>-From crates.io:```bashcargo install moviebox-tui --locked```@@ -113,28 +97,16 @@ gh attestation verify <archive-file> -R mesamirh/MovieBox-Tui```</details>-<details>-<summary><b>Uninstallation</b></summary>--#### Automated Installer (macOS, Linux, Windows, Android)-Simply re-run your original install command (`curl ... | bash` or `irm ... | iex`). When MovieBox-TUI is already installed, the installer automatically detects it and displays an interactive menu:--```text-MovieBox-TUI is already installed.-What would you like to do?- 1) Reinstall / Update to latest version- 2) Uninstall- 3) Cancel-```--Enter `2` to completely remove MovieBox-TUI.+<details>+<summary><b>Uninstall</b></summary>-#### Package Managers+Re-run install command (`curl ... | bash` or `irm ... | iex`) and select `2) Uninstall`.+Or via package manager:```bash-brew uninstall moviebox-tui # Homebrew (macOS)-scoop uninstall moviebox-tui # Scoop (Windows)+brew uninstall moviebox-tui # Homebrew+scoop uninstall moviebox-tui # Scoopcargo uninstall moviebox-tui # Cargo```@@ -146,52 +118,48 @@ cargo uninstall moviebox-tui # Cargomoviebox-tui```-- Type any title to search, press `Enter` to play.-- Press `?` inside the TUI for shortcuts, or type `/settings` for preferences.+- Type to search, press `Enter` to play.+- Press `?` for shortcuts, or type `/settings` for preferences.## Documentation-Comprehensive guides and architectural references are available at [**mesamirh.github.io/MovieBox-Tui**](https://mesamirh.github.io/MovieBox-Tui/) or in the [`docs/`](docs/) directory:+Full documentation at [**mesamirh.github.io/MovieBox-Tui**](https://mesamirh.github.io/MovieBox-Tui/) or [`docs/`](docs/):| Guide | Description || :--- | :--- |-| [Keyboard & Controls](docs/controls.md) | Keybindings, vim navigation, search, and shortcuts |-| [Configuration](docs/config.md) | Settings, theme customization, and configuration options |-| [Content Providers](docs/providers.md) | Native scrapers (MovieBox, Dramachi, BDIX) and stream extractors |-| [Stremio Addons](docs/addons-mode.md) | Community addon installation, manifest URLs, and stream resolution |-| [Hardware Players](docs/players.md) | Player detection, launch options, and hardware acceleration |-| [Live TV & IPTV](docs/tv-mode.md) | M3U playlist import, channel search, and live streaming |-| [Batch Downloads](docs/downloads.md) | Multi segment HTTP range downloads with pause and resume |+| [Keyboard & Controls](docs/controls.md) | Keybindings, vim navigation, and shortcuts |+| [Configuration](docs/config.md) | Settings, themes, and environment variables |+| [Content Providers](docs/providers.md) | Native scrapers (MovieBox, 4KHDHub, Dramachi, BDIX) |+| [Stremio Addons](docs/addons-mode.md) | Community addon configuration and streaming |+| [Hardware Players](docs/players.md) | Player detection, launch options, and flags |+| [Live TV & IPTV](docs/tv-mode.md) | M3U playlist import and channel streaming |+| [Batch Downloads](docs/downloads.md) | HTTP range engine, pause, and resume |## Contributing-Contributions are welcome. Review [CONTRIBUTING.md](CONTRIBUTING.md) before submitting pull requests.--Report bugs or submit feature requests through [GitHub Issues](https://github.com/mesamirh/MovieBox-Tui/issues).+Review [CONTRIBUTING.md](CONTRIBUTING.md) before submitting pull requests. Report bugs via [GitHub Issues](https://github.com/mesamirh/MovieBox-Tui/issues).<details>-<summary><b>Optional Support</b></summary>+<summary><b>Support</b></summary><div id="optional-support" tabindex="-1"></div>-If you would like to support ongoing development directly:--| Network / Asset | Address |+| Asset | Address || :--- | :--- || **USDT (TRC20)** | `TL4yW73qmbKZpBWwbEFgjBpwVkPDFTkJgV` || **Bitcoin (BTC)** | `3MEAtqtRWrQBhnaMi3Zuf5nt2efNUS2LUQ` |-| **Ethereum / EVM** | `0x7ea20d5fa29d87f33195f5a3b211ff94038d794c` |+| **Ethereum (EVM)** | `0x7ea20d5fa29d87f33195f5a3b211ff94038d794c` || **Solana (SOL)** | `6ctm5WFv73MNywoCKAz3xK72yizSspHa72rFNygooU6` |</details>## Privacy-MovieBox-TUI contains zero telemetry, analytics, or user tracking. All search history, bookmarks, and configuration files remain strictly on your local filesystem.+Zero telemetry, analytics, or user tracking. History, favorites, and config remain local.## License-Licensed under either [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE).+Dual-licensed under [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE).## Disclaimer-This project does not host or store any media. It is an independent client for playing publicly available streams. Users are responsible for complying with the laws of their country.+MovieBox-TUI does not host or store media. It plays publicly available streams. Users must comply with local laws.diff --git a/README_BN.md b/README_BN.mdindex b87b875..866aa25 100644--- a/README_BN.md+++ b/README_BN.md@@ -17,67 +17,54 @@## মূল সুবিধাসমূহ-- **অন-ডিমান্ড স্ট্রিমিং**: একাধিক নেটিভ প্রোভাইডার এবং কমিউনিটি Stremio অ্যাড-অন থেকে মুভি, টিভি সিরিজ, অ্যানিমে ও এশিয়ান ড্রামা সরাসরি স্ট্রিম করুন।-- **লাইভ টিভি ও IPTV**: কাস্টম M3U প্লেলিস্ট URL ইমপোর্ট করে সহজে টিভি চ্যানেল সার্চ করুন, ক্যাটাগরি ব্রাউজ করুন এবং লাইভ টিভি উপভোগ করুন।-- **কোয়ালিটি ও রেজোলিউশন নির্বাচন**: ডিটেইলস স্ক্রিন থেকে সরাসরি নিজের পছন্দের স্ট্রিম রেজোলিউশন (`1080p`, `720p`, `480p`) বেছে নিন।-- **হার্ডওয়্যার অ্যাক্সিলারেটেড প্লেব্যাক**: স্বয়ংক্রিয় অথেনটিকেশন ও কুকি ফরওয়ার্ডিং সহ সরাসরি আপনার পছন্দের লোকাল মিডিয়া প্লেয়ারে ভিডিও চলবে।-- **মাল্টি-সেগমেন্ট ডাউনলোডার**: HTTP রেঞ্জ পজ ও রিজুম সাপোর্ট সহ একসাথে একাধিক সেগমেন্টে কোনো একটি পর্ব বা পুরো সিজন ডাউনলোড করুন।-- **স্বয়ংক্রিয় সাবটাইটেল**: আপনার পছন্দের ভাষার সাবটাইটেল নিজে থেকেই খুঁজে এনে স্বয়ংক্রিয়ভাবে প্লেয়ারে লোড করে।-- **ইন্টারঅ্যাক্টিভ টার্মিনাল UI**: vim নেভিগেশন ও কমান্ড অটো-সাজেশন সহ সম্পূর্ণ কীবোর্ড ও মাউস সাপোর্ট।-- **ভিজ্যুয়াল পোস্টার ও থিম**: ৯টি চমৎকার বিল্ট-ইন থিম এবং স্বয়ংক্রিয় লাইট/ডার্ক মোড সনাক্তকরণ সহ সরাসরি টার্মিনালে কালারফুল পোস্টার প্রদর্শিত হয়।-- **লাইব্রেরি ও প্রোগ্রেস ট্র্যাকিং**: পছন্দের শো স্টার মার্ক করুন, ওয়াচ হিস্ট্রি ট্র্যাক করুন এবং যেখান থেকে দেখা বন্ধ করেছিলেন সেখান থেকেই আবার শুরু করুন।-- **ক্রস-প্ল্যাটফর্ম ও প্রাইভেট**: কোনো প্রকার টেলিমেট্রি বা ডেটা সংগ্রহ ছাড়াই macOS, Linux, Windows এবং Android (Termux) এ নেটিভভাবে চলে।+- **স্ট্রিমিং:** একাধিক নেটিভ প্রোভাইডার এবং কমিউনিটি Stremio অ্যাড-অন থেকে মুভি, টিভি সিরিজ, অ্যানিমে ও এশিয়ান ড্রামা স্ট্রিম করুন।+- **লাইভ টিভি:** চ্যানেল ক্যাটাগরি, EPG সাপোর্ট এবং সার্চ সহ M3U প্লেলিস্ট ইমপোর্ট।+- **রেজোলিউশন পিকার:** প্লেব্যাকের আগে সরাসরি স্ট্রিম কোয়ালিটি (`4K`, `1080p`, `720p`, `480p`, `Auto`) নির্বাচন।+- **হার্ডওয়্যার প্লেয়ার:** কাস্টম অথেনটিকেশন হেডার ও কুকি ফরওয়ার্ডিং সহ সরাসরি `mpv`, `VLC`, বা `IINA`-তে প্লেব্যাক।+- **ব্যাচ ডাউনলোডার:** HTTP রেঞ্জ পজ ও রিজুম সাপোর্ট সহ একক পর্ব এবং পুরো সিজনের মাল্টি-সেগমেন্ট ডাউনলোড।+- **সাবটাইটেল পিকার:** প্লেব্যাক বা ডাউনলোডের আগে ইন্টারঅ্যাক্টিভ পিকারের মাধ্যমে একাধিক ভাষার সাবটাইটেল ট্র্যাক নির্বাচন।+- **টার্মিনাল UI:** Vim নেভিগেশন, মাউস ইন্টারঅ্যাকশন, স্ল্যাশ কমান্ড প্যালেট (`/help`, `/settings`), এবং ৯টি বিল্ট-ইন থিম।+- **কভার আর্ট:** স্বয়ংক্রিয় টেক্সট ফলব্যাক সহ নেটিভ Kitty, Sixel এবং iTerm2 পোস্টার রেন্ডারিং।+- **রিজুম ও লাইব্রেরি:** কন্টিনিউ-ওয়াচিং টাইমস্ট্যাম্প, ওয়াচ হিস্ট্রি এবং ফেভারিটস সম্পূর্ণ লোকাল ডিস্কে সংরক্ষিত থাকে। জিরো টেলিমেট্রি।## পূর্বশর্তসমূহ-### সাপোর্টেড মিডিয়া প্লেয়ার--আপনার সিস্টেমে নিচের যেকোনো একটি মিডিয়া প্লেয়ার ইনস্টল থাকা আবশ্যক:--- **ডেস্কটপ (macOS, Linux, Windows):** [mpv](https://mpv.io/), [VLC](https://www.videolan.org/), অথবা [IINA](https://iina.io/) *(macOS)*।-- **অ্যান্ড্রয়েড (Termux):** যেকোনো এক্সটার্নাল ভিডিও প্লেয়ার ([VLC](https://play.google.com/store/apps/details?id=org.videolan.vlc), Just Player, অথবা MX Player)।--### টার্মিনাল গ্রাফিক্স (পোস্টার)--পোস্টার প্রদর্শন আপনার টার্মিনাল পরিবেশের ওপর ভিত্তি করে স্বয়ংক্রিয়ভাবে মানিয়ে নেয়:--- **গ্রাফিক্স সাপোর্ট টার্মিনাল:** হাই-রেজোলিউশনের মুভি ও সিরিজ পোস্টার নেটিভভাবে দেখায়।-- **সাধারণ টার্মিনাল:** টেক্সট আকারে গোছানো প্লেসহোল্ডার স্বয়ংক্রিয়ভাবে দেখায়।--### ঐচ্ছিক ডিপেনডেন্সি--- **`yt-dlp` ও `ffmpeg`:** শুধুমাত্র MovieBox প্রোভাইডার থেকে DASH স্ট্রিম ডাউনলোডের জন্য প্রয়োজনীয়। বাকি সব প্রোভাইডার সরাসরি ইন-বিল্ট HTTP ইঞ্জিন দিয়ে ডাউনলোড হয়।+- **মিডিয়া প্লেয়ার:** `mpv`, `VLC`, বা `IINA` (macOS) / যেকোনো এক্সটার্নাল ভিডিও প্লেয়ার (Android)।+- **পোস্টার:** Sixel, Kitty বা iTerm2 সাপোর্টযুক্ত টার্মিনাল (Ghostty, Kitty, WezTerm, iTerm2, foot, Windows Terminal v1.22+)।+- **DASH ডাউনলোড:** `yt-dlp` এবং `ffmpeg` (শুধুমাত্র MovieBox DASH ডাউনলোডের জন্য প্রয়োজনীয়)।## ইনস্টলেশন### macOS ও Linux-টার্মিনাল ওপেন করে রান করুন:+আপনার সিস্টেমে [Homebrew](https://brew.sh/) থাকলে (macOS):```bash-curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash+brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui+brew install moviebox-tui```-অথবা Homebrew দিয়ে (macOS):+> **নোট:** প্রথমবার ইনস্টলের সময় Homebrew যদি ট্যাপ ভেরিফিকেশন চায়, তবে `brew trust mesamirh/moviebox-tui` রান করুন।++সরাসরি টার্মিনাল দিয়ে ইনস্টল (macOS ও Linux, কোনো প্যাকেজ ম্যানেজার লাগবে না):```bash-brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui-brew install moviebox-tui+curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash```-> [!NOTE]-> প্রথমবার ইনস্টলের সময় Homebrew যদি ট্যাপ ভেরিফিকেশন চায়, তবে `brew trust mesamirh/moviebox-tui` রান করুন।### Windows-Scoop এর মাধ্যমে:+আপনার সিস্টেমে [Scoop](https://scoop.sh/) থাকলে (সুপারিশকৃত):```powershellscoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tuiscoop install moviebox-tui```-অথবা অটোমেটেড PowerShell স্ক্রিপ্ট:+PowerShell স্ক্রিপ্ট দিয়ে সরাসরি ইনস্টল (কোনো প্যাকেজ ম্যানেজার লাগবে না):```powershellirm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex```+> **SmartScreen প্রম্পট:** Windows যদি *"Windows protected your PC"* দেখায়, তবে **More info** → **Run anyway** এ ক্লিক করুন।+### Android (Termux)Termux ওপেন করে রান করুন:@@ -117,27 +104,14 @@ gh attestation verify <archive-file> -R mesamirh/MovieBox-Tui</details><details>-<summary><b>আনইনস্টলেশন (Uninstallation)</b></summary>--#### অটোমেটেড ইনস্টলার (macOS, Linux, Windows, Android)--আপনার মূল ইনস্টলেশন কমান্ডটি (`curl ... | bash` অথবা `irm ... | iex`) পুনরায় রান করুন। MovieBox-TUI ইনস্টল করা থাকলে ইনস্টলার স্বয়ংক্রিয়ভাবে তা সনাক্ত করে একটি মেনু দেখাবে:--```text-MovieBox-TUI is already installed.-What would you like to do?- 1) Reinstall / Update to latest version- 2) Uninstall- 3) Cancel-```--MovieBox-TUI সম্পূর্ণ মুছে ফেলতে `2` চাপুন।+<summary><b>আনইনস্টল (Uninstall)</b></summary>-#### প্যাকেজ ম্যানেজার+ইনস্টল কমান্ডটি (`curl ... | bash` অথবা `irm ... | iex`) পুনরায় রান করে `2) Uninstall` নির্বাচন করুন।+অথবা প্যাকেজ ম্যানেজারের মাধ্যমে:```bash-brew uninstall moviebox-tui # Homebrew (macOS)-scoop uninstall moviebox-tui # Scoop (Windows)+brew uninstall moviebox-tui # Homebrew+scoop uninstall moviebox-tui # Scoopcargo uninstall moviebox-tui # Cargo```@@ -160,7 +134,7 @@ moviebox-tui| :--- | :--- || [কীবোর্ড ও কন্ট্রোলস](docs/controls.md) | কীবাইন্ডিং, vim নেভিগেশন, সার্চ এবং শর্টকাট || [কনফিগারেশন](docs/config.md) | সেটিংস, থিম কাস্টমাইজেশন এবং কনফিগারেশন অপশন |-| [কনটেন্ট প্রোভাইডার](docs/providers.md) | নেটিভ স্ক্র্যাপার (MovieBox, Dramachi, BDIX) এবং স্ট্রিম এক্সট্র্যাক্টর |+| [কনটেন্ট প্রোভাইডার](docs/providers.md) | নেটিভ স্ক্র্যাপার (MovieBox, 4KHDHub, Dramachi, BDIX) || [Stremio অ্যাড-অন](docs/addons-mode.md) | কমিউনিটি অ্যাড-অন ইনস্টলেশন, ম্যানিফেস্ট URL এবং স্ট্রিম রেজোলিউশন || [হার্ডওয়্যার প্লেয়ার](docs/players.md) | প্লেয়ার ডিটেকশন, লঞ্চ অপশন এবং হার্ডওয়্যার অ্যাক্সিলারেশন || [লাইভ টিভি ও IPTV](docs/tv-mode.md) | M3U প্লেলিস্ট ইমপোর্ট, চ্যানেল সার্চ এবং লাইভ স্ট্রিমিং |diff --git a/README_ES.md b/README_ES.mdindex a5c052c..2106959 100644--- a/README_ES.md+++ b/README_ES.md@@ -17,67 +17,54 @@## Características-- **Streaming bajo demanda**: Reproduce películas, series, anime y dramas asiáticos a través de múltiples proveedores nativos y complementos comunitarios de Stremio.-- **TV en vivo e IPTV**: Importa listas M3U personalizadas para buscar canales, explorar categorías y ver televisión en directo.-- **Selección de calidad y resolución**: Elige la resolución deseada (`1080p`, `720p`, `480p`) directamente en la pantalla de detalles.-- **Reproducción acelerada por hardware**: Se ejecuta directamente en tu reproductor multimedia local favorito con autenticación y envío automático de cookies.-- **Descargador multisegmento**: Descarga episodios individuales o temporadas completas en paralelo, con soporte para pausar y reanudar por rangos HTTP.-- **Subtítulos automáticos**: Busca y sincroniza subtítulos en tu idioma preferido de forma automática.-- **Interfaz de terminal interactiva**: Soporte completo para teclado y ratón, con navegación estilo vim y sugerencias automáticas de comandos.-- **Pósters visuales y temas**: Renderiza carátulas directamente en tu terminal, con 9 temas integrados y detección automática de modo claro y oscuro.-- **Biblioteca y seguimiento de progreso**: Marca favoritos, registra el historial de visualización y reanuda la reproducción exactamente donde la dejaste.-- **Multiplataforma y privado**: Funciona de forma nativa en macOS, Linux, Windows y Android (Termux) sin telemetría ni recopilación de datos.+- **Streaming:** Películas, series, anime, dramas asiáticos y complementos comunitarios de Stremio en múltiples proveedores nativos.+- **TV en vivo:** Importación de listas M3U con categorías de canales, soporte EPG y búsqueda.+- **Selector de resolución:** Selección directa de calidad de stream (`4K`, `1080p`, `720p`, `480p`, `Auto`) antes de reproducir.+- **Reproductores por hardware:** Inicio directo en `mpv`, `VLC` o `IINA` con reenvío de cabeceras de autenticación y cookies.+- **Descargador por lotes:** Descargador concurrente multisegmento con pausa y reanudación por rangos HTTP para episodios y temporadas completas.+- **Selector de subtítulos:** Pistas de subtítulos en múltiples idiomas extraídas y seleccionables mediante un selector interactivo antes de reproducir o descargar.+- **Interfaz de terminal:** Navegación Vim, soporte de ratón, paleta de comandos (`/help`, `/settings`) y 9 temas integrados.+- **Carátulas:** Renderizado nativo de pósters con Kitty, Sixel e iTerm2 con alternativa automática en texto.+- **Reanudación y biblioteca:** Marcas de tiempo de continuar viendo, historial y favoritos almacenados localmente en disco. Cero telemetría.## Requisitos previos-### Reproductores multimedia compatibles--Requiere tener instalado al menos un reproductor multimedia compatible en tu sistema:--- **Escritorio (macOS, Linux, Windows):** [mpv](https://mpv.io/), [VLC](https://www.videolan.org/), o [IINA](https://iina.io/) *(macOS)*.-- **Android (Termux):** Cualquier reproductor de video externo ([VLC](https://play.google.com/store/apps/details?id=org.videolan.vlc), Just Player, o MX Player).--### Gráficos en la terminal (Pósters)--La visualización de pósters se adapta automáticamente a tu terminal:--- **Terminales con soporte gráfico:** Muestra pósters de películas y series en alta resolución de forma nativa.-- **Terminales estándar:** Muestra marcadores de posición de texto limpios y estructurados.--### Dependencias opcionales--- **`yt-dlp` y `ffmpeg`:** Requeridos únicamente al descargar transmisiones DASH del proveedor MovieBox. El resto de proveedores descargan directamente a través del motor HTTP integrado.+- **Reproductor multimedia:** `mpv`, `VLC` o `IINA` (macOS) / cualquier reproductor de video externo (Android).+- **Pósters:** Terminal con soporte Sixel, Kitty o iTerm2 (Ghostty, Kitty, WezTerm, iTerm2, foot, Windows Terminal v1.22+).+- **Descargas DASH:** `yt-dlp` y `ffmpeg` (requeridos solo para descargas DASH de MovieBox).## Instalación### macOS y Linux-Abre la terminal y ejecuta:+Si tienes [Homebrew](https://brew.sh/) en macOS:```bash-curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash+brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui+brew install moviebox-tui```-O mediante Homebrew (macOS):+> **Nota:** Si Homebrew solicita verificación de tap en la instalación inicial, ejecuta `brew trust mesamirh/moviebox-tui`.++Instalación directa mediante Terminal (macOS y Linux, sin necesidad de gestor de paquetes):```bash-brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui-brew install moviebox-tui+curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash```-> [!NOTE]-> Si Homebrew solicita verificación de tap en la instalación inicial, ejecuta `brew trust mesamirh/moviebox-tui`.### Windows-A través de Scoop:+Si tienes [Scoop](https://scoop.sh/) (recomendado):```powershellscoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tuiscoop install moviebox-tui```-O mediante el script automatizado de PowerShell:+Instalación directa mediante PowerShell (sin necesidad de gestor de paquetes):```powershellirm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex```+> **Aviso de SmartScreen:** Si Windows muestra *"Windows protegió su PC"*, haz clic en **Más información** → **Ejecutar de todas formas**.+### Android (Termux)Abre Termux y ejecuta:@@ -117,27 +104,14 @@ gh attestation verify <archive-file> -R mesamirh/MovieBox-Tui</details><details>-<summary><b>Desinstalación</b></summary>--#### Instalador automatizado (macOS, Linux, Windows, Android)--Simplemente vuelve a ejecutar el comando de instalación original (`curl ... | bash` o `irm ... | iex`). Cuando MovieBox-TUI ya está instalado, el instalador lo detecta y muestra un menú interactivo:--```text-MovieBox-TUI is already installed.-What would you like to do?- 1) Reinstall / Update to latest version- 2) Uninstall- 3) Cancel-```--Introduce `2` para eliminar completamente MovieBox-TUI.+<summary><b>Desinstalar</b></summary>-#### Gestores de paquetes+Vuelve a ejecutar el comando de instalación (`curl ... | bash` o `irm ... | iex`) y selecciona `2) Uninstall`.+O mediante gestor de paquetes:```bash-brew uninstall moviebox-tui # Homebrew (macOS)-scoop uninstall moviebox-tui # Scoop (Windows)+brew uninstall moviebox-tui # Homebrew+scoop uninstall moviebox-tui # Scoopcargo uninstall moviebox-tui # Cargo```@@ -160,7 +134,7 @@ Las guías completas y referencias de arquitectura están disponibles en [**mesa| :--- | :--- || [Teclado y Controles](docs/controls.md) | Atajos de teclado, navegación vim, búsqueda y comandos || [Configuración](docs/config.md) | Opciones de configuración, personalización de temas y variables de entorno |-| [Proveedores de Contenido](docs/providers.md) | Scrapers nativos (MovieBox, Dramachi, BDIX) y extractores de stream |+| [Proveedores de Contenido](docs/providers.md) | Scrapers nativos (MovieBox, 4KHDHub, Dramachi, BDIX) || [Complementos de Stremio](docs/addons-mode.md) | Instalación de addons comunitarios, URLs de manifiestos y resolución de streams || [Reproductores Multimedia](docs/players.md) | Detección de reproductores, opciones de inicio y aceleración por hardware || [TV en vivo e IPTV](docs/tv-mode.md) | Importación de listas M3U, búsqueda de canales y streaming en vivo |diff --git a/README_HI.md b/README_HI.mdindex dd6172d..a7b5933 100644--- a/README_HI.md+++ b/README_HI.md@@ -17,67 +17,54 @@## खास फीचर्स-- **ऑन-डिमांड स्ट्रीमिंग**: कई नेटिव प्रोवाइडर्स और कम्युनिटी Stremio ऐड-ऑन्स से फिल्में, टीवी सीरीज, एनीमे और एशियन ड्रामा स्ट्रीम करें।-- **लाइव टीवी और IPTV**: चैनल्स सर्च करने, कैटेगरी ब्राउज करने और लाइव टेलीविजन स्ट्रीम करने के लिए कस्टम M3U प्लेलिस्ट URL इम्पोर्ट करें।-- **क्वालिटी और रेजोल्यूशन चयन**: डिटेल्स स्क्रीन से सीधे अपनी पसंदीदा स्ट्रीम रेजोल्यूशन (`1080p`, `720p`, `480p`) चुनें।-- **हार्डवेयर त्वरित प्लेबैक**: ऑटोमैटिक ऑथेंटिकेशन और कुकी फॉरवर्डिंग के साथ सीधे अपने पसंदीदा स्थानीय मीडिया प्लेयर में चलाएं।-- **मल्टी-सेगमेंट डाउनलोडर**: HTTP रेंज पॉज और रिज्यूम सपोर्ट के साथ व्यक्तिगत एपिसोड या पूरे सीजन एक साथ डाउनलोड करें।-- **ऑटोमैटिक सबटाइटल**: आपकी पसंदीदा भाषा में सबटाइटल अपने आप खोजकर सिंक्रोनाइज़ करता है।-- **इंटरैक्टिव टर्मिनल UI**: vim नेविगेशन और कमांड ऑटो-सजेशन के साथ फुल कीबोर्ड और माउस सपोर्ट।-- **विज़ुअल पोस्टर और थीम्स**: 9 इन-बिल्ट थीम्स और ऑटोमैटिक लाइट/डार्क डिटेक्शन के साथ सीधे टर्मिनल में कवर आर्ट रेंडर करता है।-- **लाइब्रेरी और प्रोग्रेस ट्रैकिंग**: पसंदीदा स्टार करें, वॉच हिस्ट्री ट्रैक करें और वहीं से शुरू करें जहां आपने छोड़ा था।-- **क्रॉस-प्लेटफॉर्म और प्राइवेट**: बिना किसी टेलीमेट्री या डेटा कलेक्शन के macOS, Linux, Windows और Android (Termux) पर नेटिव रूप से चलता है।+- **स्ट्रीमिंग:** कई नेटिव प्रोवाइडर्स और कम्युनिटी Stremio ऐड-ऑन्स से फिल्में, टीवी सीरीज, एनीमे और एशियन ड्रामा।+- **लाइव टीवी:** चैनल कैटेगरी, EPG सपोर्ट और सर्च के साथ M3U प्लेलिस्ट इम्पोर्ट।+- **रेजोल्यूशन पिकर:** प्लेबैक से पहले सीधे स्ट्रीम क्वालिटी (`4K`, `1080p`, `720p`, `480p`, `Auto`) का चयन।+- **हार्डवेयर प्लेयर्स:** कस्टम ऑथेंटिकेशन हेडर और कुकी फॉरवर्डिंग के साथ `mpv`, `VLC`, या `IINA` में सीधा लॉन्च।+- **बैच डाउनलोडर:** एपिसोड और पूरे सीजन के लिए HTTP रेंज पॉज और रिज्यूम के साथ मल्टी-सेगमेंट डाउनलोडर।+- **सबटाइटल पिकर:** प्लेबैक या डाउनलोड से पहले इंटरैक्टिव पिकर के माध्यम से बहु-भाषा सबटाइटल ट्रैक का चयन।+- **टर्मिनल UI:** Vim नेविगेशन, माउस इंटरैक्शन, स्लैश कमांड पैलेट (`/help`, `/settings`), और 9 इन-बिल्ट थीम्स।+- **कवर आर्ट:** ऑटोमैटिक टेक्स्ट फॉलबैक के साथ नेटिव Kitty, Sixel और iTerm2 पोस्टर रेंडरिंग।+- **रिज्यूम और लाइब्रेरी:** कंटिन्यू-वॉचिंग टाइमस्टैम्प, वॉच हिस्ट्री और फेवरेट्स स्थानीय डिस्क पर सुरक्षित। शून्य टेलीमेट्री।## पूर्व-आवश्यकताएं-### समर्थित मीडिया प्लेयर--आपके सिस्टम पर कम से कम एक समर्थित मीडिया प्लेयर इंस्टॉल होना आवश्यक है:--- **डेस्कटॉप (macOS, Linux, Windows):** [mpv](https://mpv.io/), [VLC](https://www.videolan.org/), या [IINA](https://iina.io/) *(macOS)*।-- **एंड्रॉइड (Termux):** कोई भी बाहरी वीडियो प्लेयर ([VLC](https://play.google.com/store/apps/details?id=org.videolan.vlc), Just Player, या MX Player)।--### टर्मिनल ग्राफिक्स (पोस्टर)--पोस्टर रेंडरिंग आपके टर्मिनल वातावरण के अनुसार अपने आप अनुकूलित हो जाती है:--- **ग्राफिक्स-सक्षम टर्मिनल:** हाई-रेजोल्यूशन मूवी और सीरीज पोस्टर नेटिव रूप से दिखाता है।-- **सामान्य टर्मिनल:** साफ और स्ट्रक्चर्ड टेक्स्ट प्लेसहोल्डर अपने आप दिखाता है।--### वैकल्पिक निर्भरताएं--- **`yt-dlp` और `ffmpeg`:** केवल MovieBox प्रोवाइडर से DASH स्ट्रीम्स डाउनलोड करने के लिए आवश्यक। बाकी सभी प्रोवाइडर्स सीधे इन-बिल्ट HTTP इंजन से डाउनलोड होते हैं।+- **मीडिया प्लेयर:** `mpv`, `VLC`, या `IINA` (macOS) / कोई भी बाहरी वीडियो प्लेयर (Android)।+- **पोस्टर:** Sixel, Kitty, या iTerm2 सपोर्ट वाला टर्मिनल (Ghostty, Kitty, WezTerm, iTerm2, foot, Windows Terminal v1.22+)।+- **DASH डाउनलोड:** `yt-dlp` और `ffmpeg` (केवल MovieBox DASH डाउनलोड के लिए आवश्यक)।## इंस्टॉलेशन### macOS और Linux-टर्मिनल खोलें और चलाएं:+यदि आपके पास macOS पर [Homebrew](https://brew.sh/) है:```bash-curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash+brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui+brew install moviebox-tui```-या Homebrew से (macOS):+> **नोट:** पहली बार इंस्टॉल करते समय यदि Homebrew वेरिफिकेशन मांगे, तो `brew trust mesamirh/moviebox-tui` चलाएं।++टर्मिनल से सीधे इंस्टॉल (macOS और Linux, किसी पैकेज मैनेजर की आवश्यकता नहीं):```bash-brew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui-brew install moviebox-tui+curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash```-> [!NOTE]-> यदि Homebrew पहली बार इंस्टॉल करते समय वेरिफिकेशन मांगे, तो `brew trust mesamirh/moviebox-tui` चलाएं।### Windows-Scoop से:+यदि आपके पास [Scoop](https://scoop.sh/) है (अनुशंसित):```powershellscoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tuiscoop install moviebox-tui```-या ऑटोमेटेड PowerShell स्क्रिप्ट से:+PowerShell स्क्रिप्ट से सीधे इंस्टॉल (किसी पैकेज मैनेजर की आवश्यकता नहीं):```powershellirm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex```+> **SmartScreen प्रॉम्ट:** यदि Windows *"Windows protected your PC"* दिखाता है, तो **More info** → **Run anyway** पर क्लिक करें।+### Android (Termux)Termux खोलें और चलाएं:@@ -117,27 +104,14 @@ gh attestation verify <archive-file> -R mesamirh/MovieBox-Tui</details><details>-<summary><b>अनइंस्टॉलेशन (Uninstallation)</b></summary>--#### ऑटोमेटेड इंस्टॉलर (macOS, Linux, Windows, Android)--बस अपना मूल इंस्टॉलेशन कमांड (`curl ... | bash` या `irm ... | iex`) फिर से चलाएं। जब MovieBox-TUI पहले से इंस्टॉल होता है, तो इंस्टॉलर इसे अपने आप पहचान लेता है और एक मेनू प्रदर्शित करता है:--```text-MovieBox-TUI is already installed.-What would you like to do?- 1) Reinstall / Update to latest version- 2) Uninstall- 3) Cancel-```--MovieBox-TUI को पूरी तरह हटाने के लिए `2` दर्ज करें।+<summary><b>अनइंस्टॉल (Uninstall)</b></summary>-#### पैकेज मैनेजर्स+इंस्टॉल कमांड (`curl ... | bash` या `irm ... | iex`) फिर से चलाएं और `2) Uninstall` चुनें।+या पैकेज मैनेजर से:```bash-brew uninstall moviebox-tui # Homebrew (macOS)-scoop uninstall moviebox-tui # Scoop (Windows)+brew uninstall moviebox-tui # Homebrew+scoop uninstall moviebox-tui # Scoopcargo uninstall moviebox-tui # Cargo```@@ -160,7 +134,7 @@ moviebox-tui| :--- | :--- || [कीबोर्ड और कंट्रोल्स](docs/controls.md) | कीबाइंडिंग्स, vim नेविगेशन, सर्च और शॉर्टकट्स || [कॉन्फ़िगरेशन](docs/config.md) | सेटिंग्स, थीम कस्टमाइज़ेशन और कॉन्फ़िगरेशन विकल्प |-| [कंटेंट प्रोवाइडर्स](docs/providers.md) | नेटिव स्क्रेपर्स (MovieBox, Dramachi, BDIX) और स्ट्रीम एक्सट्रैक्टर्स |+| [कंटेंट प्रोवाइडर्स](docs/providers.md) | नेटिव स्क्रेपर्स (MovieBox, 4KHDHub, Dramachi, BDIX) || [Stremio ऐड-ऑन्स](docs/addons-mode.md) | कम्युनिटी ऐड-ऑन इंस्टॉलेशन, मैनिफेस्ट URL और स्ट्रीम रेजोल्यूशन || [हार्डवेयर प्लेयर्स](docs/players.md) | प्लेयर डिटेक्शन, लॉन्च ऑप्शंस और हार्डवेयर एक्सेलेरेशन || [लाइव टीवी और IPTV](docs/tv-mode.md) | M3U प्लेलिस्ट इम्पोर्ट, चैनल सर्च और लाइव स्ट्रीमिंग |diff --git a/docs/README.md b/docs/README.mdindex ba8e583..3716226 100644--- a/docs/README.md+++ b/docs/README.md@@ -17,36 +17,21 @@## Features-- **On Demand Streaming**: Stream movies, TV series, anime, and Asian dramas across multiple native providers and community Stremio addons.-- **Live TV & IPTV**: Import custom M3U playlist URLs to search channels, browse categories, and stream live television.-- **Quality & Resolution Selection**: Choose preferred stream resolutions (`1080p`, `720p`, `480p`) directly from the details screen.-- **Hardware Accelerated Playback**: Plays directly in your preferred local media player with automatic authentication and cookie forwarding.-- **Multi Segment Downloader**: Download individual episodes or full seasons concurrently with HTTP range pause and resume support.-- **Automatic Subtitles**: Searches and synchronizes subtitles in your preferred language automatically.-- **Interactive Terminal UI**: Full keyboard and mouse support with vim navigation and command auto suggestions.-- **Visual Posters & Themes**: Renders cover art directly in your terminal, with 9 built-in themes and automatic light and dark detection.-- **Library & Progress Tracking**: Star favorites, track watch history, and resume playback where you left off.-- **Cross Platform & Private**: Runs natively on macOS, Linux, Windows, and Android (Termux) with zero telemetry or data collection.+- **Streaming:** Movies, TV series, anime, Asian dramas, and community Stremio addons across multiple native providers.+- **Live TV:** M3U playlist import with channel categories, EPG support, and search.+- **Resolution Picker:** Direct stream quality selection (`4K`, `1080p`, `720p`, `480p`, `Auto`) before playback.+- **Hardware Players:** Seamless launch in `mpv`, `VLC`, or `IINA` with custom auth header and cookie forwarding.+- **Batch Downloader:** Multi-segment concurrent downloader with HTTP range pause and resume for episodes and full seasons.+- **Subtitle Picker:** Multi-language subtitle tracks extracted and selectable via an interactive picker before playback or download.+- **Terminal UI:** Vim navigation, mouse interaction, slash command palette (`/help`, `/settings`), and 9 built-in themes.+- **Cover Art:** Native Kitty, Sixel, and iTerm2 poster rendering with automatic text fallback.+- **Resume & Library:** Home deck with continue-watching timestamps, watch history, and favorites stored strictly on local disk. Zero telemetry.## Prerequisites-### Supported Media Players--Requires at least one supported media player installed on your system:--- **Desktop (macOS, Linux, Windows):** [mpv](https://mpv.io/), [VLC](https://www.videolan.org/), or [IINA](https://iina.io/) *(macOS)*.-- **Android (Termux):** Any external video player ([VLC](https://play.google.com/store/apps/details?id=org.videolan.vlc), Just Player, or MX Player).--### Terminal Graphics (Posters)--Poster rendering automatically adapts to your terminal environment:--- **Graphics-capable terminals:** Displays high-resolution movie and series posters natively (Ghostty, Kitty, WezTerm, iTerm2, foot, and Windows Terminal v1.22+). Windows requires no third-party terminal; updating built-in Windows Terminal to v1.22+ via the Microsoft Store enables native poster rendering.-- **Standard terminals:** Displays clean, structured text placeholders (`No Art`) automatically.--### Optional Dependencies--- **`yt-dlp` & `ffmpeg`:** Required only when downloading DASH streams from the MovieBox provider. All other providers download directly through the built-in HTTP engine.+- **Media Player:** `mpv`, `VLC`, or `IINA` (macOS) / any external video player (Android).+- **Posters:** Terminal with Sixel, Kitty, or iTerm2 support (Ghostty, Kitty, WezTerm, iTerm2, foot, Windows Terminal v1.22+).+- **DASH Downloads:** `yt-dlp` and `ffmpeg` (required only for MovieBox DASH downloads).---## Documentation Directory Mapdiff --git a/docs/addons-mode.md b/docs/addons-mode.mdindex 27b4700..63c8e56 100644--- a/docs/addons-mode.md+++ b/docs/addons-mode.md@@ -27,5 +27,5 @@ The Addon Manager lets you add, enable, or remove addon manifests:## StorageInstalled addons are saved to `addons_config.json` in your configuration directory:-- **Linux / macOS**: `~/.config/moviebox-tui/addons_config.json`+- **Linux / macOS / Termux**: `~/.config/moviebox-tui/addons_config.json`- **Windows**: `%APPDATA%\MovieBox-Tui\addons_config.json`diff --git a/docs/architecture.md b/docs/architecture.mdindex 2a23bea..19092b5 100644--- a/docs/architecture.md+++ b/docs/architecture.md@@ -63,6 +63,7 @@ src/│ ├── models.rs # Provider traits (Provider, ReleaseProvider) & capabilities│ ├── moviebox/ # CloudFront signed requests, token generation, & scraper│ ├── fourkhdhub/ # 4K releases, HTML parser, & HubCloud mirror resolver+│ ├── dramachi/ # Asian dramas and series scraper│ ├── bdix/ # BDIX optical intranet scrapers (CircleFTP, DhakaFlix)│ │ └── common.rs # Centralized codec, resolution, & language heuristics│ ├── addons/ # Community Stremio HTTP addon manifest & stream aggregatordiff --git a/docs/cache.md b/docs/cache.mdindex d4d170f..b90b41f 100644--- a/docs/cache.md+++ b/docs/cache.md@@ -11,18 +11,19 @@ Override with the `MOVIEBOX_CACHE_DIR` environment variable.## Binary Cache Architecture-Cache files use a structured MessagePack envelope preceded by a 4-byte magic signature (`MBXC`):+Cache files use a structured MessagePack envelope preceded by a 4-byte magic signature (`MBC1`):```text-[ 0x4D 0x42 0x58 0x43 ] [ MessagePack Encoded Envelope ]+[ 0x4D 0x42 0x43 0x31 ] [ MessagePack Encoded Envelope ]```-The envelope stores the creation timestamp (`u64`) alongside the serialized payload. On read, if the timestamp exceeds the item's TTL, the cache is invalidated and refetched.+The envelope stores the expiration timestamp (`expires_at: u64`) alongside the serialized payload. On read, if the current time exceeds `expires_at` or the file age exceeds the TTL, the cache is invalidated and refetched.## Cache TTLs| Namespace | TTL | Description || :--- | :--- | :--- |+| `homepage` | 1 Hour | Trending, popular, and curated `/browse` feeds || `search` | 24 Hours | Search query results per provider || `details` | Dynamic (CloudFront TTL) | Subject details, cast, and signed streaming cookies (auto-adapts to upstream cookie expiration, min 1h, max 24h) || `streams` | Dynamic (Cookie Expiration) | Direct streaming and DASH manifest URLs (auto-adapts to `CloudFront-Policy` and `Edge-Cache-Cookie` expiration timestamp `:t=`, min 1m, max 2h) |diff --git a/docs/controls.md b/docs/controls.mdindex 4c5d405..7b2269a 100644--- a/docs/controls.md+++ b/docs/controls.md@@ -38,7 +38,7 @@ Press `?` anywhere inside the application to open the interactive help dialog.## Dialog & Modal Controls-All popups (Themes, Providers, Players, TV Manager, Addon Manager) share standard navigation:+All popups (Themes, Providers, Players, Resolution, Subtitles, TV Manager, Addon Manager) share standard navigation:- **`↑` / `↓` / `k` / `j`**: Navigate choices.- **`Home` / `End`**: Jump to first / last item.@@ -84,7 +84,7 @@ All popups (Themes, Providers, Players, TV Manager, Addon Manager) share standar- **`b`**: Copy Homebrew update command to clipboard.- **`s`**: Copy Scoop update command to clipboard.- **`o`**: Open GitHub release notes in default browser.-- **`Esc`**: Dismiss update prompt.+- **`Esc` / `q`**: Dismiss update prompt.## Slash CommandsType `/` in the search bar on the Home screen to trigger slash commands:diff --git a/docs/installation.md b/docs/installation.mdindex 8e2e46c..53770a8 100644--- a/docs/installation.md+++ b/docs/installation.md@@ -6,13 +6,9 @@ MovieBox-TUI is available across macOS, Linux, Windows, and Android (Termux).## macOS and Linux-Open Terminal and run:+### Homebrew (macOS)-```bash-curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash-```--Or via Homebrew (macOS):+If you have [Homebrew](https://brew.sh/):```bashbrew tap mesamirh/moviebox-tui https://github.com/mesamirh/MovieBox-Tui@@ -22,22 +18,36 @@ brew install moviebox-tui> [!NOTE]> If Homebrew prompts for tap verification on initial install, run `brew trust mesamirh/moviebox-tui`.+### Direct Terminal Script++No package manager required. Open Terminal and run:++```bash+curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash+```+---## Windows-### Scoop Package Manager+### Scoop Package Manager (Recommended)++If you have [Scoop](https://scoop.sh/):```powershellscoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tuiscoop install moviebox-tui```-### Automated PowerShell Script+### Direct PowerShell Script++No package manager required. Open **PowerShell** and run:```powershellirm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex```++> **SmartScreen prompt:** If Windows displays *"Windows protected your PC"*, click **More info** → **Run anyway**.---## Android (Termux)diff --git a/docs/known-issues.md b/docs/known-issues.mdindex 7b51f97..ddccce7 100644--- a/docs/known-issues.md+++ b/docs/known-issues.md@@ -9,9 +9,6 @@ Tracked here so future work and issue reports reference the same facts.route through the local detached HTTP loopback proxy (`src/proxy.rs`) for both VLC andAndroid Intent playback, streaming video chunks over localhost without requiring player-sidecookie support.-- **BDIX clients use nested `if let Ok` pyramids** in search handling; they work and- are logged, but are harder to read. Flattening is deferred (behavior-neutral refactor- with moderate churn).- **MovieBox request signing** hardcodes an API secret and spoofs a device identity in`crypto.rs`. This is inherent to the scraper; treat the module as one unit.- **Android intent playback** forwards `User-Agent`, `Referer`, and subtitles (`subtitles_location`/`subs`) when using `am` or `termux-am`. Chooser-based launches via `termux-open` open the raw video URL directly.@@ -19,15 +16,11 @@ Tracked here so future work and issue reports reference the same facts.## Environment-dependent- **4KHDHub mirrors rotate and can be expired on upstream hosts.** Direct streams are resolved concurrently across all available release mirrors using prioritized scoring (Cloudflare R2 / S3 / Seekable Streams → Storage → PixelDrain API → Google UserContent / Direct Attachments) and bounded concurrency (`select_ok` in chunks of 3). When all upstream mirrors for an older release are dead/expired (e.g. 404 or expired tokens), the resolver fails fast (<4.5s) and guides the user to select another release.-- **Termux playback needs the device confirmed** on each release: `termux-open` /- `am` availability and the Android chooser behavior. The historical- `rustls-platform-verifier` initialization panic reported for v0.1.12 is not in- the v0.1.13 dependency graph, but the upstream report remains open until a real- Termux launch is observed.+- **Termux playback depends on Android intent dispatchers**: Verify `termux-open` / `am` availability and the Android player chooser behavior on target devices.- **Windows 11 Smart App Control (SAC) restricts untrusted web downloads.** Unsigned binaries downloaded via web browsers are tagged with `ZoneId=3` (Mark of the Web), causing Windows 11 SAC to block launch without a standard "Run anyway" button. The official installer (`install.ps1`) strips this tag automatically using `Unblock-File`. For manual ZIP downloads, users must unblock via file properties or `Unblock-File moviebox-tui.exe`.## Verification-- Automated testing is enforced via `cargo test --all-features --locked` covering 447 unit and integration tests across 12 test suites (see [`docs/testing.md`](testing.md)). The count is updated when tests change; it does not replace real-player and real-device verification.+- Automated testing is enforced via `cargo test --all-features --locked` covering 510 unit and integration tests across 12 test suites (see [`docs/testing.md`](testing.md)). The count is updated when tests change; it does not replace real-player and real-device verification.- Static correctness is enforced by strict compiler type checking, the lint gate (`cargo clippy --all-targets --all-features --locked -- -D warnings`), formatting (`cargo fmt --check`), dependency vulnerability scanning (`cargo audit`), and packaging verification (`cargo package --locked`).- Runtime and platform-specific behavior (terminal resize, focus handling, external player launch, and Termux chooser) are verified through the release checklist in [`release-checklist.md`](release-checklist.md).diff --git a/docs/modules.md b/docs/modules.mdindex 3524229..f22cab4 100644--- a/docs/modules.md+++ b/docs/modules.md@@ -9,7 +9,7 @@ src/main.rs Entry point. Logging init, panic hook, raw mode, alternatescreen, TerminalGuard, App::new + App::run.lib.rs Crate root: declares pub mod cache/config/download/favorites/- history/logging/models/net/player/providers/service/tui/updater.+ history/logging/models/net/player/providers/proxy/service/tui/updater.cache.rs Disk cache: provider-namespaced directories, TTL expiry,atomic temp-file writes, payload validation, background purge.@@ -66,6 +66,7 @@ src/client.rs Search/details/stream resolution + preflight validation.hubcloud.rs Mirror resolver: fetch drive pages, extract playable links.parser.rs HTML parsing into typed CatalogItem/MediaDetails/Release.+ dramachi/ Asian dramas and series provider (client + parser).bdix/common.rs Shared BDIX resolution, audio language, and codec detection heuristics.circleftp/ BDIX CircleFTP provider (client + parser).diff --git a/docs/testing.md b/docs/testing.mdindex deaffbe..7902599 100644--- a/docs/testing.md+++ b/docs/testing.md@@ -4,7 +4,7 @@ This document describes the testing architecture, quality assurance procedures,## 1. Test Architecture-The test suite comprises **447 automated tests across 12 test suites** (320 unit tests in `src/lib.rs` and 127 integration tests across 10 focused suites in `tests/`), running fully offline by default without mocking or live network dependencies.+The test suite comprises **510 automated tests across 12 test suites** (381 unit tests in `src/lib.rs` and 129 integration tests across 10 focused suites in `tests/`), running fully offline by default without mocking or live network dependencies.The MovieBox-TUI test architecture follows a strict separation of concerns:```text@@ -73,10 +73,10 @@ cargo test --test tui_acceptance --all-features --lockedcargo test --test history_audit --all-features --locked```-Run the opt-in live-network acceptance test:+Run the opt-in live-network stream verification suite:```bash-MOVIEBOX_LIVE_TESTS=1 cargo test --test real_acceptance --all-features --locked -- --ignored+cargo test --test live_stream_verification --all-features --locked -- --ignored```---