@officebeats/matrix-iptv-cli 3.0.1 → 3.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/CHANGES.md +121 -121
  2. package/LICENSE +21 -0
  3. package/README.md +193 -191
  4. package/about.md +31 -31
  5. package/bin/cli.js +31 -31
  6. package/index.html +128 -90
  7. package/package.json +26 -26
  8. package/scripts/install-binary.js +96 -83
  9. package/scripts/proxy_server.js +68 -0
  10. package/test_config.json +85 -85
package/CHANGES.md CHANGED
@@ -1,121 +1,121 @@
1
- # IPTV App Changes Summary
2
-
3
- ## Date: 2025-12-21
4
-
5
- ### Changes Implemented
6
-
7
- #### ✅ 1. Renamed "ARCHIVE_DATA" to "MOVIE_DATA"
8
-
9
- **Files Modified:**
10
- - `src/ui.rs`
11
-
12
- **Changes:**
13
- - **Line 167-169**: Changed header tab from `ARCHIVE_ACCESS` to `MOVIE_ACCESS`
14
- - **Line 799-801**: Changed VOD streams pane title from `ARCHIVE_DATA` to `MOVIE_DATA`
15
-
16
- **Rationale:** Better reflects the content type (movies/VOD) instead of generic "archive" terminology.
17
-
18
- ---
19
-
20
- #### ✅ 2. Added "All Movies" Category for VOD
21
-
22
- **Files Modified:**
23
- - `src/main.rs`
24
-
25
- **Changes:**
26
- - **Line 237-253**: Injected "All Movies" category at index 0 of VOD categories list
27
- - Category ID: "ALL"
28
- - Category Name: "All Movies"
29
- - Similar to how "All Channels" works for live TV
30
-
31
- **Rationale:** Allows users to browse all VOD content across all categories without having to select individual categories.
32
-
33
- ---
34
-
35
- #### ✅ 3. Implemented "All Movies" Stream Loading
36
-
37
- **Files Modified:**
38
- - `src/main.rs`
39
-
40
- **Changes:**
41
- - **Line 1362-1403**: Modified VOD stream loading logic to handle "ALL" category
42
- - When "ALL" category is selected, calls `client.get_vod_streams_all().await`
43
- - Otherwise, calls `client.get_vod_streams(&cat_id).await` for specific category
44
- - Properly formatted with consistent indentation and error handling
45
-
46
- **Code Structure:**
47
- ```rust
48
- tokio::spawn(async move {
49
- // Handle "All Movies" category
50
- if cat_id == "ALL" {
51
- match client.get_vod_streams_all().await {
52
- Ok(streams) => { /* Load all streams */ }
53
- Err(e) => { /* Handle error */ }
54
- }
55
- } else {
56
- match client.get_vod_streams(&cat_id).await {
57
- Ok(streams) => { /* Load category streams */ }
58
- Err(e) => { /* Handle error */ }
59
- }
60
- }
61
- });
62
- ```
63
-
64
- ---
65
-
66
- ### Performance Considerations
67
-
68
- **Existing Optimizations:**
69
- - Windowed rendering is already implemented in `src/ui.rs` (lines 608-702)
70
- - Only visible items are parsed and rendered, not the entire list
71
- - This should provide good scrolling performance even with large datasets
72
-
73
- **Potential Performance Issues:**
74
- 1. Network latency when loading large "All Movies" list
75
- 2. Parsing overhead in `parse_movie()` and `parse_stream()` functions
76
- 3. The windowed rendering uses a half-window buffer which should be optimal
77
-
78
- **Recommendation:**
79
- - Monitor performance with real-world data
80
- - If issues persist, consider:
81
- - Caching parsed results
82
- - Implementing lazy loading/pagination
83
- - Optimizing the parsing functions
84
-
85
- ---
86
-
87
- ### Testing
88
-
89
- **Status:** ✅ App compiles and runs successfully
90
-
91
- **Test Command:**
92
- ```bash
93
- cargo run --bin matrix-iptv
94
- ```
95
-
96
- **Expected Behavior:**
97
- 1. Navigate to VOD section (press 'v' from live channels)
98
- 2. "All Movies" should appear as the first category
99
- 3. Selecting "All Movies" should load all VOD streams across all categories
100
- 4. Header should show "MOVIE_ACCESS" instead of "ARCHIVE_ACCESS"
101
- 5. Stream list should show "MOVIE_DATA" instead of "ARCHIVE_DATA"
102
-
103
- ---
104
-
105
- ### Files Created During Implementation
106
-
107
- - `fix_vod.py` - Python script used to fix malformed code
108
- - `fix_main.ps1` - PowerShell script (not used in final solution)
109
- - `update_vod.ps1` - PowerShell script (not used in final solution)
110
- - `vod_all_movies.patch` - Patch file (reference only)
111
-
112
- **Note:** These helper files can be deleted after verification.
113
-
114
- ---
115
-
116
- ### Next Steps
117
-
118
- 1. ✅ Test with actual IPTV playlist to verify "All Movies" functionality
119
- 2. Monitor scrolling performance with large datasets
120
- 3. Consider adding loading indicators for "All Movies" (can take longer)
121
- 4. Optional: Add a count indicator showing total movies in "All Movies" category
1
+ # IPTV App Changes Summary
2
+
3
+ ## Date: 2025-12-21
4
+
5
+ ### Changes Implemented
6
+
7
+ #### ✅ 1. Renamed "ARCHIVE_DATA" to "MOVIE_DATA"
8
+
9
+ **Files Modified:**
10
+ - `src/ui.rs`
11
+
12
+ **Changes:**
13
+ - **Line 167-169**: Changed header tab from `ARCHIVE_ACCESS` to `MOVIE_ACCESS`
14
+ - **Line 799-801**: Changed VOD streams pane title from `ARCHIVE_DATA` to `MOVIE_DATA`
15
+
16
+ **Rationale:** Better reflects the content type (movies/VOD) instead of generic "archive" terminology.
17
+
18
+ ---
19
+
20
+ #### ✅ 2. Added "All Movies" Category for VOD
21
+
22
+ **Files Modified:**
23
+ - `src/main.rs`
24
+
25
+ **Changes:**
26
+ - **Line 237-253**: Injected "All Movies" category at index 0 of VOD categories list
27
+ - Category ID: "ALL"
28
+ - Category Name: "All Movies"
29
+ - Similar to how "All Channels" works for live TV
30
+
31
+ **Rationale:** Allows users to browse all VOD content across all categories without having to select individual categories.
32
+
33
+ ---
34
+
35
+ #### ✅ 3. Implemented "All Movies" Stream Loading
36
+
37
+ **Files Modified:**
38
+ - `src/main.rs`
39
+
40
+ **Changes:**
41
+ - **Line 1362-1403**: Modified VOD stream loading logic to handle "ALL" category
42
+ - When "ALL" category is selected, calls `client.get_vod_streams_all().await`
43
+ - Otherwise, calls `client.get_vod_streams(&cat_id).await` for specific category
44
+ - Properly formatted with consistent indentation and error handling
45
+
46
+ **Code Structure:**
47
+ ```rust
48
+ tokio::spawn(async move {
49
+ // Handle "All Movies" category
50
+ if cat_id == "ALL" {
51
+ match client.get_vod_streams_all().await {
52
+ Ok(streams) => { /* Load all streams */ }
53
+ Err(e) => { /* Handle error */ }
54
+ }
55
+ } else {
56
+ match client.get_vod_streams(&cat_id).await {
57
+ Ok(streams) => { /* Load category streams */ }
58
+ Err(e) => { /* Handle error */ }
59
+ }
60
+ }
61
+ });
62
+ ```
63
+
64
+ ---
65
+
66
+ ### Performance Considerations
67
+
68
+ **Existing Optimizations:**
69
+ - Windowed rendering is already implemented in `src/ui.rs` (lines 608-702)
70
+ - Only visible items are parsed and rendered, not the entire list
71
+ - This should provide good scrolling performance even with large datasets
72
+
73
+ **Potential Performance Issues:**
74
+ 1. Network latency when loading large "All Movies" list
75
+ 2. Parsing overhead in `parse_movie()` and `parse_stream()` functions
76
+ 3. The windowed rendering uses a half-window buffer which should be optimal
77
+
78
+ **Recommendation:**
79
+ - Monitor performance with real-world data
80
+ - If issues persist, consider:
81
+ - Caching parsed results
82
+ - Implementing lazy loading/pagination
83
+ - Optimizing the parsing functions
84
+
85
+ ---
86
+
87
+ ### Testing
88
+
89
+ **Status:** ✅ App compiles and runs successfully
90
+
91
+ **Test Command:**
92
+ ```bash
93
+ cargo run --bin matrix-iptv
94
+ ```
95
+
96
+ **Expected Behavior:**
97
+ 1. Navigate to VOD section (press 'v' from live channels)
98
+ 2. "All Movies" should appear as the first category
99
+ 3. Selecting "All Movies" should load all VOD streams across all categories
100
+ 4. Header should show "MOVIE_ACCESS" instead of "ARCHIVE_ACCESS"
101
+ 5. Stream list should show "MOVIE_DATA" instead of "ARCHIVE_DATA"
102
+
103
+ ---
104
+
105
+ ### Files Created During Implementation
106
+
107
+ - `fix_vod.py` - Python script used to fix malformed code
108
+ - `fix_main.ps1` - PowerShell script (not used in final solution)
109
+ - `update_vod.ps1` - PowerShell script (not used in final solution)
110
+ - `vod_all_movies.patch` - Patch file (reference only)
111
+
112
+ **Note:** These helper files can be deleted after verification.
113
+
114
+ ---
115
+
116
+ ### Next Steps
117
+
118
+ 1. ✅ Test with actual IPTV playlist to verify "All Movies" functionality
119
+ 2. Monitor scrolling performance with large datasets
120
+ 3. Consider adding loading indicators for "All Movies" (can take longer)
121
+ 4. Optional: Add a count indicator showing total movies in "All Movies" category
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 Matrix IPTV CLI Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,191 +1,193 @@
1
- # 🟢 Matrix IPTV CLI
2
-
3
- ![Matrix IPTV CLI Hero](./assets/hero.png)
4
-
5
- **// THE_PREMIUM_TERMINAL_IPTV_DECODER //**
6
-
7
- Matrix IPTV CLI is a blazing fast, keyboard-driven interface for browsing Live TV, Movies, and Series. Inspired by the Matrix and built with Rust, it's designed to be the ultimate premium TUI (Terminal User Interface) for IPTV power users.
8
-
9
- This project is being actively optimized by **Ernesto "Beats"** with a primary focus on **Live TV and Sports** performance, ensuring zero-latency navigation and professional-grade video clarity.
10
-
11
- ---
12
-
13
- ## 📸 Gallery
14
-
15
- <p align="center">
16
- <img src="./assets/playlists.png" width="45%" />
17
- <img src="./assets/pill.png" width="45%" />
18
- <br />
19
- <img src="./assets/live.png" width="90%" />
20
- </p>
21
-
22
- ---
23
-
24
- ## 🚀 Instant Installation
25
-
26
- **Prerequisites:** Matrix IPTV CLI requires **MPV Player** (for video) and **Node.js** (for the CLI).
27
-
28
- #### **Don't have MPV Player?**
29
-
30
- - **Windows:** `winget install info.mpv.mpv`
31
- - **Mac:** `brew install mpv`
32
- - **Linux:** `sudo apt install mpv`
33
-
34
- #### **Don't have Node.js?**
35
-
36
- - **Windows:** `winget install OpenJS.NodeJS`
37
- - **Mac:** `brew install node`
38
- - **Linux:** `sudo apt install nodejs npm`
39
-
40
- ### **Global NPM Install (Recommended)**
41
-
42
- If you have Node.js installed, this is the easiest way to stay updated:
43
-
44
- ```bash
45
- npm install -g @officebeats/matrix-iptv-cli
46
- ```
47
-
48
- ### **One-Click Scripts**
49
-
50
- Alternatively, use these platform-specific one-liners:
51
-
52
- #### **Windows**
53
-
54
- ```powershell
55
- powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/officebeats/matrix-iptv/main/install.ps1 | iex"
56
- ```
57
-
58
- #### **Mac & Linux**
59
-
60
- ```bash
61
- curl -sSL https://raw.githubusercontent.com/officebeats/matrix-iptv/main/install.sh -o install_matrix.sh && bash install_matrix.sh && rm install_matrix.sh
62
- ```
63
-
64
- ---
65
-
66
- ## 🎬 How to Run
67
-
68
- Simply open any terminal and type:
69
-
70
- ```bash
71
- matrix-iptv
72
- ```
73
-
74
- ---
75
-
76
- ## ✨ Features
77
-
78
- - **USA Mode**: Strictly optimized for **Strong 8K**, **Mega OTT**, and **TRex**. Hides international clutter and cleans channel names instantly.
79
- - **⚡ Instant Response**: Built in Rust for maximum performance. Navigate tens of thousands of channels with zero lag.
80
- - **📡 Xtream API Native**: Strictly optimized for **Xtream API** providers (support for M3U is not planned at this time).
81
- - **🏟️ Sports & Live Focused**: Layout and performance tuned specifically for the most demanding live events.
82
- - **📁 "All" Content Navigation**: Browse everything at once with "All Channels" and "All Movies" views.
83
- - **🎬 Full Series Support**: Dedicated multi-column view for Series, Seasons, and Episodes.
84
- - **📟 Infinite Screensaver**: High-performance Matrix rain screensaver (find it in Settings).
85
- - **📡 Secure**: Uses Private DNS-over-HTTPS (DoH) for connecting to your provider.
86
- - **📽️ Headless Playback**: Integrated borderless fullscreen mode for a cinematic experience without window distractions.
87
-
88
- ---
89
-
90
- ## 🏎️ Optimized Providers
91
-
92
- > **⚠️ Disclaimer:** This is an experimental feature strictly targeting the top 3 most widely available playlists on platforms like **z2u** and **g2g**. Please do not request support or additions for other playlists at this time.
93
-
94
- > **💻 OS Compatibility:** Development and testing are done primarily on **Windows**. Mac and Linux variants are provided as-is and may contain platform-specific bugs. If you encounter an issue, please report it with **screenshots and a detailed description** so I can "vibe code" a fix. As a Product Manager, I rely on clear visual and descriptive data to troubleshoot!
95
-
96
- Matrix IPTV CLI is refined for high-density, high-quality playlists, including:
97
-
98
- - **Strong 8K**: Custom filtering logic to remove international clutter (AR|, etc.) and maximize US sports visibility.
99
- - **Mega OTT**: Optimized category parsing and rapid metadata loading.
100
- - **TRex IPTV**: Enhanced sport category prioritization and fast channel tuning.
101
-
102
- ---
103
-
104
- ## USA Mode
105
-
106
- The **USA Mode** is a powerful filtering and cleaning engine strictly optimized for **Strong 8K**, **Mega OTT**, and **TRex IPTV** playlists.
107
-
108
- #### **How to use:**
109
-
110
- 1. Press the **`x`** key to open **Settings**.
111
- 2. Navigate to **USA Mode**.
112
- 3. Press **`Enter`** to toggle it On/Off.
113
- 4. Press **`Esc`** to return and apply the filtering instantly.
114
-
115
- - **Strict Geo-Filtering**: Automatically hides international categories (UK, AR, etc.) in these optimized playlists to keep your list clean.
116
- - **Clean Channel Names**: Removes redundant tags like `US |`, `USA |`, and `FHD |` from channel names, leaving you with just the name of the network.
117
- - **Smart Filtering**: Prioritizes American sports and local networks (NFL, NBA, ESPN) for an effortless viewing experience.
118
-
119
- ---
120
-
121
- ## 📽️ MPV Enhancements
122
-
123
- We leverage advanced **MPV** flags to ensure professional-level video quality even on lower-end hardware:
124
-
125
- - **Headless Fullscreen**: Launches directly into borderless fullscreen (`--no-border`, `--fs`) for a professional, TV-like experience.
126
- - **Advanced Anti-Aliasing**: Uses `spline36` scaling, providing superior edge smoothing and diagonal line clarity on any machine.
127
- - **Oversample Upscaling**: High-quality temporal upscaling that sharpens images while reducing movement flickering (Temporal AA).
128
- - **Motion Smoothing**: High-performance `display-resample` interpolation for fluid sports playback at native refresh rates.
129
- - **Hardware Acceleration**: Automatic `hwdec=auto-safe` with modern Windows `d3d11-flip` presentation for zero-copy GPU decoding.
130
- - **Anti-Ringing Filter**: Eliminates halos around sharp edges and logos for a cleaner, high-end look.
131
-
132
- ---
133
-
134
- ## ⌨️ Common Controls
135
-
136
- | Key | Action |
137
- | :---------------------- | :--------------------------------------------------------- |
138
- | **`Enter`** | **Play Channel / Select Category** |
139
- | **`Esc` / `Backspace`** | **Go Back** |
140
- | **`f`** | **Favorite** (Add/Remove current item from Favorites) |
141
- | **`/`** | **Search** (Filters results instantly) |
142
- | **`j` / `↓`** | Move Down |
143
- | **`k` / `↑`** | Move Up |
144
- | **`x`** | **Settings** (Update your playlist or turn on Screensaver) |
145
- | **`q`** | **Quit** |
146
-
147
- ---
148
-
149
- ## 🛠️ Prerequisites
150
-
151
- The installation scripts will attempt to install these for you:
152
-
153
- - **MPV Player**: [mpv.io](https://mpv.io)
154
- - **Rust Compiler**: [rustup.rs](https://rustup.rs) (Only required for manual builds)
155
-
156
- ---
157
-
158
- > **⚠️ Disclaimer:** Matrix IPTV CLI and its creator, are **not affiliated** with z2u, g2g, or any IPTV provider. We do not sell or distribute content. All transactions on these platforms are at your own risk. This guide is for informational purposes only (experimental "USA Mode" testing).
159
-
160
- <details>
161
- <summary><strong>🛒 Where to Buy Playlists (Click to Expand)</strong></summary>
162
-
163
- <br>
164
-
165
- The experimental "USA Mode" is optimized for **Strong 8K**, **TRex**, and **Mega OTT** playlists. These are typically sourced from third-party marketplaces:
166
-
167
- - **Platforms**: **z2u.com** or **g2g.com**
168
- - **Search Terms**: "Strong 8k IPTV", "Trex IPTV", "Mega OTT"
169
- - **Duration**: Usually sold in **1-month**, **6-month**, or **1-year** increments.
170
-
171
- ### ✅ Buying Tips
172
-
173
- 1. **Check Ratings**: Always choose a seller with a **high rating (98%+)** and a high sales count. These are 2-sided marketplaces, so reputation is everything.
174
- 2. **Safe Payment**: Use strictly secure payment methods like **Google Pay** or **Apple Pay** directly through your device. Avoid direct bank transfers or obscure payment links.
175
-
176
- </details>
177
-
178
- ---
179
-
180
- ## ⚡ Community & Support
181
-
182
- Built and optimized with ❤️ by **Ernesto "Beats"** with the help of google antigravity and vibe coding during his PTO vacation time.
183
-
184
- [![Twitter](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/officebeats)
185
- [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/users/317887730703138826)
186
-
187
- ---
188
-
189
- ## 📜 License
190
-
191
- MIT // [ProductMG.com](https://www.productmg.com)
1
+ # 🟢 Matrix IPTV CLI
2
+
3
+ ![Matrix IPTV CLI Hero](./assets/hero.png)
4
+
5
+ **// THE_PREMIUM_TERMINAL_IPTV_DECODER //**
6
+
7
+ Matrix IPTV CLI is a blazing fast, keyboard-driven interface for browsing Live TV, Movies, and Series. Inspired by the Matrix and built with Rust, it's designed to be the ultimate premium TUI (Terminal User Interface) for IPTV power users.
8
+
9
+ This project is being actively optimized by **Ernesto "Beats"** with a primary focus on **Live TV and Sports** performance, ensuring zero-latency navigation and professional-grade video clarity.
10
+
11
+ ---
12
+
13
+ ## 📸 Gallery
14
+
15
+ <p align="center">
16
+ <img src="./assets/playlists.png" width="45%" />
17
+ <img src="./assets/pill.png" width="45%" />
18
+ <br />
19
+ <img src="./assets/live.png" width="90%" />
20
+ </p>
21
+
22
+ ---
23
+
24
+ ## 🚀 Instant Installation
25
+
26
+ **Prerequisites:** Matrix IPTV CLI requires **MPV Player** (for video) and **Node.js** (for the CLI).
27
+
28
+ #### **Don't have MPV Player?**
29
+
30
+ - **Windows:** `winget install mpv`
31
+ - **Mac:** `brew install mpv`
32
+ - **Linux:** `sudo apt install mpv`
33
+
34
+ #### **Don't have Node.js?**
35
+
36
+ - **Windows:** `winget install OpenJS.NodeJS`
37
+ - **Mac:** `brew install node`
38
+ - **Linux:** `sudo apt install nodejs npm`
39
+
40
+ ### **Global NPM Install (Recommended)**
41
+
42
+ If you have Node.js installed, this is the easiest way to stay updated:
43
+
44
+ ```bash
45
+ npm install -g @officebeats/matrix-iptv-cli
46
+ ```
47
+
48
+ ### **One-Click Scripts**
49
+
50
+ Alternatively, use these platform-specific one-liners:
51
+
52
+ #### **Windows**
53
+
54
+ ```powershell
55
+ powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/officebeats/matrix-iptv/main/install.ps1 | iex"
56
+ ```
57
+
58
+ #### **Mac & Linux**
59
+
60
+ ```bash
61
+ curl -sSL https://raw.githubusercontent.com/officebeats/matrix-iptv/main/install.sh -o install_matrix.sh && bash install_matrix.sh && rm install_matrix.sh
62
+ ```
63
+
64
+ ---
65
+
66
+ ## 🎬 How to Run
67
+
68
+ The app will **auto-launch** instantly after installation! 🚀
69
+
70
+ For future sessions, simply open any terminal and type:
71
+
72
+ ```bash
73
+ matrix-iptv
74
+ ```
75
+
76
+ ---
77
+
78
+ ## ✨ Features
79
+
80
+ - **🛡️ Playlist Modes**:
81
+ - **'Merica Mode**: Filters for US/UK/Canada content, removes international clutter from **Strong 8K**, **Mega OTT**, & **TRex**. Renames "Football" to "Soccer".
82
+ - **Sports Mode**: Prioritizes live sports events and adds league icons (NBA, NFL, MLB, NHL) for rapid identification.
83
+ - **⚡ Instant Response**: Built in Rust for maximum performance. Navigate tens of thousands of channels with zero lag.
84
+ - **📡 Xtream API Native**: Strictly optimized for **Xtream API** providers (support for M3U is not planned at this time).
85
+ - **🔎 Global Search**: Press **`Alt`+`Space`** (or `/`) to search across Live TV, Movies, and Series content instantly.
86
+ - **📁 Unified Navigation**: "All" views for Channels, Movies, and Series allow for rapid browsing without digging into categories.
87
+ - **🎬 Full Series Support**: dedicated browsing for TV Shows with Season/Episode hierarchy and tracking.
88
+ - **🎞️ VOD Experience**: Browse movies with rich metadata and instant playback.
89
+ - **📟 Matrix Rain Screensaver**: A high-performance, authentic digital rain screensaver that activates when idle.
90
+ - **🔒 Secure**: Uses Private DNS-over-HTTPS (DoH) for secure provider connection.
91
+ - **👁️ Headless Playback**: Integrated borderless fullscreen mode for a cinematic experience.
92
+
93
+ ---
94
+
95
+ ## 🛡️ Playlist Modes
96
+
97
+ Matrix IPTV CLI features advanced preprocessing engines called **Playlist Modes**. These filters run _before_ content reaches your screen to optimize the experience.
98
+
99
+ #### **'Merica Mode 🇺🇸**
100
+
101
+ Strictly optimized for **Strong 8K**, **Mega OTT**, and **TRex IPTV** playlists.
102
+
103
+ - **Geo-Filtering**: Hides international categories (AR, FR, DE, etc.) to focus on English-speaking content.
104
+ - **Name Cleaning**: Intelligent renaming (e.g., removes `US |`, `USA |`, `FHD`) for cleaner lists.
105
+ - **Sports Renaming**: Renames "American Football" to "Football" and "Football" to "Soccer".
106
+
107
+ #### **Sports Mode 🏟️**
108
+
109
+ Designed for the game day power user.
110
+
111
+ - **League Icons**: Automatically detects and prefixes league names with icons (🏀 NBA, 🏈 NFL, ⚾ MLB, 🏒 NHL).
112
+ - **Category Sorting**: Hoists sports categories to the top of the list for quick access.
113
+
114
+ To change modes:
115
+
116
+ 1. Press **`m`** (or Go to Settings > Playlist Mode).
117
+ 2. Select your desired mode.
118
+ 3. Press **`Enter`**. The app will reload your playlist with the new optimizations.
119
+
120
+ ---
121
+
122
+ ## 📽️ MPV Enhancements
123
+
124
+ We leverage advanced **MPV** flags to ensure professional-level video quality even on lower-end hardware:
125
+
126
+ - **Headless Fullscreen**: Launches directly into borderless fullscreen (`--no-border`, `--fs`) for a professional, TV-like experience.
127
+ - **Advanced Anti-Aliasing**: Uses `spline36` scaling, providing superior edge smoothing.
128
+ - **Oversample Upscaling**: High-quality temporal upscaling that sharpens images.
129
+ - **Motion Smoothing**: High-performance `display-resample` interpolation for fluid sports playback.
130
+ - **Hardware Acceleration**: Automatic `hwdec=auto-safe` with modern Windows `d3d11-flip` presentation.
131
+
132
+ ---
133
+
134
+ ## ⌨️ Common Controls
135
+
136
+ | Key | Action |
137
+ | :---------------------- | :------------------------------------ |
138
+ | **`Enter`** | **Play Channel / Select / Confirm** |
139
+ | **`Esc` / `Backspace`** | **Go Back / Cancel** |
140
+ | **`/`** | **Search** (Filters current view) |
141
+ | **`Alt` + `Space`** | **Global Search** (Search everything) |
142
+ | **`j` / `↓`** | Move Down |
143
+ | **`k` / `↑`** | Move Up |
144
+ | **`m`** | **Playlist Mode** (Quick Switch) |
145
+ | **`x`** | **Settings** |
146
+ | **`r`** | **Refresh Playlist** |
147
+ | **`q`** | **Quit** |
148
+
149
+ ---
150
+
151
+ ## 🛠️ Prerequisites
152
+
153
+ The installation scripts will attempt to install these for you:
154
+
155
+ - **MPV Player**: [mpv.io](https://mpv.io)
156
+ - **Rust Compiler**: [rustup.rs](https://rustup.rs) (Only required for manual builds)
157
+
158
+ ---
159
+
160
+ > **⚠️ Disclaimer:** Matrix IPTV CLI and its creator, are **not affiliated** with z2u, g2g, or any IPTV provider. We do not sell or distribute content. All transactions on these platforms are at your own risk. This guide is for informational purposes only (experimental "USA Mode" testing).
161
+
162
+ <details>
163
+ <summary><strong>🛒 Where to Buy Playlists (Click to Expand)</strong></summary>
164
+
165
+ <br>
166
+
167
+ The experimental "USA Mode" is optimized for **Strong 8K**, **TRex**, and **Mega OTT** playlists. These are typically sourced from third-party marketplaces:
168
+
169
+ - **Platforms**: **z2u.com** or **g2g.com**
170
+ - **Search Terms**: "Strong 8k IPTV", "Trex IPTV", "Mega OTT"
171
+ - **Duration**: Usually sold in **1-month**, **6-month**, or **1-year** increments.
172
+
173
+ ### ✅ Buying Tips
174
+
175
+ 1. **Check Ratings**: Always choose a seller with a **high rating (98%+)** and a high sales count. These are 2-sided marketplaces, so reputation is everything.
176
+ 2. **Safe Payment**: Use strictly secure payment methods like **Google Pay** or **Apple Pay** directly through your device. Avoid direct bank transfers or obscure payment links.
177
+
178
+ </details>
179
+
180
+ ---
181
+
182
+ ## ⚡ Community & Support
183
+
184
+ Built and optimized with ❤️ by **Ernesto "Beats"** with the help of google antigravity and vibe coding during his PTO vacation time.
185
+
186
+ [![Twitter](https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://x.com/officebeats)
187
+ [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/users/317887730703138826)
188
+
189
+ ---
190
+
191
+ ## 📜 License
192
+
193
+ MIT // [ProductMG.com](https://www.productmg.com)