Skip to content

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.md
index 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 a
new `Action` variant over blocking the UI thread.
diff --git a/README.md b/README.md
index 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):
```powershell
scoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tui
scoop install moviebox-tui
```
-Or automated PowerShell script:
+Direct install via PowerShell (no package manager needed):
```powershell
irm 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)
```bash
pkg update && pkg install -y curl tar termux-tools termux-am
curl -fsSL https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.sh | bash
termux-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:
```bash
cargo 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 # Scoop
cargo uninstall moviebox-tui # Cargo
```
@@ -146,52 +118,48 @@ cargo uninstall moviebox-tui # Cargo
moviebox-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.md
index 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/) থাকলে (সুপারিশকৃত):
```powershell
scoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tui
scoop install moviebox-tui
```
-অথবা অটোমেটেড PowerShell স্ক্রিপ্ট:
+PowerShell স্ক্রিপ্ট দিয়ে সরাসরি ইনস্টল (কোনো প্যাকেজ ম্যানেজার লাগবে না):
```powershell
irm 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 # Scoop
cargo 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.md
index 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):
```powershell
scoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tui
scoop install moviebox-tui
```
-O mediante el script automatizado de PowerShell:
+Instalación directa mediante PowerShell (sin necesidad de gestor de paquetes):
```powershell
irm 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 # Scoop
cargo 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.md
index 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/) है (अनुशंसित):
```powershell
scoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tui
scoop install moviebox-tui
```
-या ऑटोमेटेड PowerShell स्क्रिप्ट से:
+PowerShell स्क्रिप्ट से सीधे इंस्टॉल (किसी पैकेज मैनेजर की आवश्यकता नहीं):
```powershell
irm 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 # Scoop
cargo 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.md
index 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 Map
diff --git a/docs/addons-mode.md b/docs/addons-mode.md
index 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:
## Storage
Installed 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.md
index 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 aggregator
diff --git a/docs/cache.md b/docs/cache.md
index 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.md
index 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 Commands
Type `/` in the search bar on the Home screen to trigger slash commands:
diff --git a/docs/installation.md b/docs/installation.md
index 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/):
```bash
brew 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/):
```powershell
scoop bucket add moviebox https://github.com/mesamirh/MovieBox-Tui
scoop install moviebox-tui
```
-### Automated PowerShell Script
+### Direct PowerShell Script
+
+No package manager required. Open **PowerShell** and run:
```powershell
irm 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.md
index 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 and
Android Intent playback, streaming video chunks over localhost without requiring player-side
cookie 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.md
index 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, alternate
screen, 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.md
index 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 --locked
cargo 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
```
---