ani-cli-arabic 2.1.0__tar.gz → 2.1.2__tar.gz

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 (52) hide show
  1. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/PKG-INFO +55 -57
  2. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/README.md +54 -56
  3. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/PKG-INFO +55 -57
  4. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/SOURCES.txt +2 -1
  5. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/api.py +79 -38
  6. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/app.py +7 -7
  7. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/changelog.py +6 -0
  8. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/monitoring.py +37 -3
  9. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/ui.py +5 -0
  10. ani_cli_arabic-2.1.2/src/updater.py +359 -0
  11. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/version.py +1 -1
  12. ani_cli_arabic-2.1.2/tests/test_updater.py +104 -0
  13. ani_cli_arabic-2.1.0/src/updater.py +0 -279
  14. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/LICENSE +0 -0
  15. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/dependency_links.txt +0 -0
  16. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/entry_points.txt +0 -0
  17. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/requires.txt +0 -0
  18. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/top_level.txt +0 -0
  19. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/pyproject.toml +0 -0
  20. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/setup.cfg +0 -0
  21. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/__init__.py +0 -0
  22. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/__main__.py +0 -0
  23. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/broadcast.py +0 -0
  24. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/broadcast_popup.py +0 -0
  25. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/cli.py +0 -0
  26. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/config.py +0 -0
  27. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/deps.py +0 -0
  28. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/discord_rpc.py +0 -0
  29. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/downloader.py +0 -0
  30. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/favorites.py +0 -0
  31. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/history.py +0 -0
  32. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/logger.py +0 -0
  33. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/models.py +0 -0
  34. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/player.py +0 -0
  35. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/__init__.py +0 -0
  36. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/anime3rb.py +0 -0
  37. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/anime_slayer.py +0 -0
  38. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/animeify.py +0 -0
  39. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/base.py +0 -0
  40. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/hianime.py +0 -0
  41. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/manager.py +0 -0
  42. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/stardima.py +0 -0
  43. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/stardima_catalog.json +0 -0
  44. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/stardima_client.py +0 -0
  45. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/settings.py +0 -0
  46. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/storage.py +0 -0
  47. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/utils.py +0 -0
  48. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/tests/test_logger.py +0 -0
  49. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/tests/test_monitoring.py +0 -0
  50. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/tests/test_smart.py +0 -0
  51. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/tests/test_stardima.py +0 -0
  52. {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/tests/test_stardima_live.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ani-cli-arabic
3
- Version: 2.1.0
3
+ Version: 2.1.2
4
4
  Summary: Terminal-based anime streaming with Arabic subtitles
5
5
  Author: np4abdou1
6
6
  Maintainer: np4abdou1
@@ -65,20 +65,20 @@ Dynamic: license-file
65
65
  </p>
66
66
 
67
67
  <p>
68
- 🌍 <strong><a href="README.ar.md">للتصفح باللغة العربية اضغط هنا</a></strong>
68
+ <strong><a href="README.ar.md">للتصفح باللغة العربية اضغط هنا</a></strong>
69
69
  </p>
70
70
 
71
71
  <hr />
72
72
 
73
73
  <!-- Quick Navigation Bar -->
74
74
  <p>
75
- <a href="#-whats-new-in-v20">🚀 What's New</a> &nbsp;•&nbsp;
76
- <a href="#-providers--ecosystem">🌐 Providers</a> &nbsp;•&nbsp;
77
- <a href="#-installation">📦 Installation</a> &nbsp;•&nbsp;
78
- <a href="#-usage--cli-guide">🎮 Usage</a> &nbsp;•&nbsp;
79
- <a href="#️-keyboard-shortcuts">⌨️ Shortcuts</a> &nbsp;•&nbsp;
80
- <a href="#️-configuration">⚙️ Config</a> &nbsp;•&nbsp;
81
- <a href="#-contributors">👥 Contributors</a>
75
+ <a href="#whats-new-in-v20">What's New</a> &nbsp;•&nbsp;
76
+ <a href="#providers--ecosystem">Providers</a> &nbsp;•&nbsp;
77
+ <a href="#installation">Installation</a> &nbsp;•&nbsp;
78
+ <a href="#usage--cli-guide">Usage</a> &nbsp;•&nbsp;
79
+ <a href="#keyboard-shortcuts">Shortcuts</a> &nbsp;•&nbsp;
80
+ <a href="#configuration">Config</a> &nbsp;•&nbsp;
81
+ <a href="#contributors">Contributors</a>
82
82
  </p>
83
83
 
84
84
  </div>
@@ -86,47 +86,45 @@ Dynamic: license-file
86
86
  <br />
87
87
 
88
88
  <div align="center">
89
-
90
- https://github.com/user-attachments/assets/e74d4443-20b0-4683-b346-bf168a720025
91
-
89
+ <img src="assets/showcase.gif" alt="ani-cli-arabic Showcase" />
92
90
  </div>
93
91
 
94
92
  ---
95
93
 
96
- ## 🚀 What's New in v2.0?
94
+ ## What's New in v2.0?
97
95
 
98
96
  Version **2.0** is the largest architectural overhaul in the project's history, engineered from the ground up for speed, reliability, and zero external bloat:
99
97
 
100
98
  | Feature | Highlights |
101
99
  | :--- | :--- |
102
- | 🌐 **Multi-Provider Engine** | Stream seamlessly from **6 independent sources**: `Anime3rb`, `Anime Slayer`, `Animeify`, `HiAnime` (English Sub & Dub), `Stardima` (Arabic Dub), and `Stardima Kids` (Cartoons). |
103
- | 📥 **Native Chunked Downloader** | Built from scratch with parallel chunked streaming, pause/resume, and live speed/ETA metrics — **zero external tools required** (no `aria2c` or `yt-dlp`). |
104
- | ⚡ **Rebuilt Interactive CLI (`-i`)** | Organic `fzf` workflow with mouse navigation, zero Arabic RTL text clipping, and a quick episode action menu (`Play`, `Download`, `Batch`, `Quality`). |
105
- | 🎬 **Universal Players & IPC** | Native support for **MPV**, **VLC**, **Celluloid**, **IINA**, and **Syncplay**. Real-time MPV JSON-IPC socket monitoring saves exact-second resume timestamps. |
106
- | 🛡️ **Zero-Downtime Edge Routing** | Automatic 3-tier domain fallback chains across custom domains, Cloudflare Pages, and Cloudflare Workers. |
107
- | 🔒 **Hardened Privacy** | Zero playback tracking and isolated development branches from health telemetry. |
108
- | 🔄 **Cross-Platform Updater** | One-step automated updates across PyPI (`pip`), Arch Linux (`yay` / `paru`), and Homebrew. |
100
+ | **Multi-Provider Engine** | Stream seamlessly from **6 independent sources**: `Anime3rb`, `Anime Slayer`, `Animeify`, `HiAnime` (English Sub & Dub), `Stardima` (Arabic Dub), and `Stardima Kids` (Cartoons). |
101
+ | **Native Chunked Downloader** | Built from scratch with parallel chunked streaming, pause/resume, and live speed/ETA metrics — **zero external tools required** (no `aria2c` or `yt-dlp`). |
102
+ | **Rebuilt Interactive CLI (`-i`)** | Organic `fzf` workflow with mouse navigation, zero Arabic RTL text clipping, and a quick episode action menu (`Play`, `Download`, `Batch`, `Quality`). |
103
+ | **Universal Players & IPC** | Native support for **MPV**, **VLC**, **Celluloid**, **IINA**, and **Syncplay**. Real-time MPV JSON-IPC socket monitoring saves exact-second resume timestamps. |
104
+ | **Zero-Downtime Edge Routing** | Automatic 3-tier domain fallback chains across custom domains, Cloudflare Pages, and Cloudflare Workers. |
105
+ | **Hardened Privacy** | Zero playback tracking and isolated development branches from health telemetry. |
106
+ | **Cross-Platform Updater** | One-step automated updates across PyPI (`pip`), Arch Linux (`yay` / `paru`), and Homebrew. |
109
107
 
110
108
  ---
111
109
 
112
- ## 🌐 Providers & Ecosystem
110
+ ## Providers & Ecosystem
113
111
 
114
112
  Switch providers dynamically in the Settings menu (`[O]` / `[c]`) or directly via the `-p` CLI flag:
115
113
 
116
114
  | Provider | CLI Key | Language | Stream Features |
117
115
  | :--- | :---: | :---: | :--- |
118
- | **Anime3rb** | `anime3rb` | 🇸🇦 Arabic Sub | High-speed direct CDN streams with multi-quality selection |
119
- | **Anime Slayer** | `anime_slayer` | 🇸🇦 Arabic Sub | Official API endpoints with multiple backup episode servers |
120
- | **Animeify** | `animeify` | 🇸🇦 Arabic Sub | Mirror servers with fast resolution switching |
121
- | **HiAnime** | `hianime` | 🇬🇧 English Sub / Dub | Fast English subbed & dubbed streams with dynamic referer resolution |
122
- | **Stardima** | `stardima` | 🇸🇦 Arabic Dub | Direct multi-server streams with automatic Arabic audio stream selection |
123
- | **Stardima Kids** | `stardima_kids` | 🇸🇦 Arabic Dub | Dubbed cartoons and kids series, isolated from anime catalog |
116
+ | **Anime3rb** | `anime3rb` | Arabic Sub | High-speed direct CDN streams with multi-quality selection |
117
+ | **Anime Slayer** | `anime_slayer` | Arabic Sub | Official API endpoints with multiple backup episode servers |
118
+ | **Animeify** | `animeify` | Arabic Sub | Mirror servers with fast resolution switching |
119
+ | **HiAnime** | `hianime` | English Sub / Dub | Fast English subbed & dubbed streams with dynamic referer resolution |
120
+ | **Stardima** | `stardima` | Arabic Dub | Direct multi-server streams with automatic Arabic audio stream selection |
121
+ | **Stardima Kids** | `stardima_kids` | Arabic Dub | Dubbed cartoons and kids series, isolated from anime catalog |
124
122
 
125
123
  ---
126
124
 
127
- ## 📦 Installation
125
+ ## Installation
128
126
 
129
- ### 🔧 Prerequisites
127
+ ### Prerequisites
130
128
 
131
129
  Ensure the following core tools are installed on your system before launching:
132
130
 
@@ -137,7 +135,7 @@ Ensure the following core tools are installed on your system before launching:
137
135
 
138
136
  ---
139
137
 
140
- ### ⚡ Option 1: PyPI via `pip` (Recommended — Linux, macOS, Windows)
138
+ ### Option 1: PyPI via `pip` (Recommended — Linux, macOS, Windows)
141
139
 
142
140
  ```bash
143
141
  # Install the latest stable release
@@ -149,7 +147,7 @@ ani-cli-ar
149
147
  ```
150
148
 
151
149
  <details>
152
- <summary><b>🔄 How to upgrade via pip</b></summary>
150
+ <summary><b> How to upgrade via pip</b></summary>
153
151
 
154
152
  ```bash
155
153
  pip install --upgrade ani-cli-arabic
@@ -158,7 +156,7 @@ pip install --upgrade ani-cli-arabic
158
156
 
159
157
  ---
160
158
 
161
- ### 🏹 Option 2: Arch Linux (AUR)
159
+ ### Option 2: Arch Linux (AUR)
162
160
 
163
161
  Available directly in the Arch User Repository for Arch, Manjaro, EndeavourOS, and Garuda:
164
162
 
@@ -172,7 +170,7 @@ paru -S ani-cli-arabic
172
170
 
173
171
  ---
174
172
 
175
- ### 🛠️ Option 3: Build from Source
173
+ ### Option 3: Build from Source
176
174
 
177
175
  Run the bleeding-edge development branch directly:
178
176
 
@@ -185,15 +183,15 @@ python3 main.py
185
183
 
186
184
  ---
187
185
 
188
- ## 🎮 Usage & CLI Guide
186
+ ## Usage & CLI Guide
189
187
 
190
- ### 1️⃣ Full Terminal UI Mode (Default)
188
+ ### 1. Full Terminal UI Mode (Default)
191
189
  Launch the rich interactive dashboard with arrow-key navigation, themes, history, and favorites:
192
190
  ```bash
193
191
  ani-cli-ar
194
192
  ```
195
193
 
196
- ### 2️⃣ Fast Interactive `fzf` Mode (`-i`)
194
+ ### 2. Fast Interactive `fzf` Mode (`-i`)
197
195
  Bypass the TUI and search/play directly from a lightweight `fzf` menu in English or Arabic:
198
196
  ```bash
199
197
  # Search in English
@@ -203,7 +201,7 @@ ani-cli-ar -i "One Piece"
203
201
  ani-cli-ar -i "ون بيس"
204
202
  ```
205
203
 
206
- ### 3️⃣ Provider Selection via CLI (`-p`)
204
+ ### 3. Provider Selection via CLI (`-p`)
207
205
  Target a specific streaming provider right from your terminal command:
208
206
  ```bash
209
207
  # Stream from Anime3rb (Arabic Sub)
@@ -225,7 +223,7 @@ ani-cli-ar -p stardima "ناروتو"
225
223
  ani-cli-ar -p stardima_kids "سبونج بوب"
226
224
  ```
227
225
 
228
- ### 4️⃣ Direct Query Search
226
+ ### 4. Direct Query Search
229
227
  Jump straight into search results inside the TUI:
230
228
  ```bash
231
229
  ani-cli-ar "Hunter x Hunter"
@@ -233,12 +231,12 @@ ani-cli-ar "Hunter x Hunter"
233
231
 
234
232
  ---
235
233
 
236
- ## 🎯 Core Features Deep-Dive
234
+ ## Core Features Deep-Dive
237
235
 
238
236
  <table>
239
237
  <tr>
240
238
  <td width="50%" valign="top">
241
- <h3>📥 Chunked Batch Downloader</h3>
239
+ <h3> Chunked Batch Downloader</h3>
242
240
  <ul>
243
241
  <li><b>Flexible Ranges:</b> Download full seasons or specific episodes (<code>1-12</code>, <code>1,3,5</code>, or <code>all</code>).</li>
244
242
  <li><b>Multi-Threaded:</b> Parallel chunked HTTP streams with automatic pause & resume support.</li>
@@ -247,7 +245,7 @@ ani-cli-ar "Hunter x Hunter"
247
245
  </ul>
248
246
  </td>
249
247
  <td width="50%" valign="top">
250
- <h3>🎨 Modern TUI & Smart Features</h3>
248
+ <h3> Modern TUI & Smart Features</h3>
251
249
  <ul>
252
250
  <li><b>17 Built-in Themes:</b> <code>blue</code>, <code>red</code>, <code>green</code>, <code>purple</code>, <code>cyan</code>, <code>gold</code>, <code>rose</code>, <code>sunset</code>, and more.</li>
253
251
  <li><b>Discord Rich Presence:</b> Displays live anime poster, title, and episode status on your profile.</li>
@@ -258,16 +256,16 @@ ani-cli-ar "Hunter x Hunter"
258
256
  </tr>
259
257
  </table>
260
258
 
261
- > ℹ️ *Classification metadata uses TMDB data; this product uses the TMDB API but is not endorsed or certified by TMDB.*
259
+ > *Classification metadata uses TMDB data; this product uses the TMDB API but is not endorsed or certified by TMDB.*
262
260
 
263
261
  ---
264
262
 
265
- ## ⌨️ Keyboard Shortcuts
263
+ ## Keyboard Shortcuts
266
264
 
267
265
  <table>
268
266
  <tr>
269
- <th width="50%">🖥️ Main TUI Navigation</th>
270
- <th width="50%">🎬 Video Player (MPV)</th>
267
+ <th width="50%"> Main TUI Navigation</th>
268
+ <th width="50%"> Video Player (MPV)</th>
271
269
  </tr>
272
270
  <tr>
273
271
  <td valign="top">
@@ -303,7 +301,7 @@ ani-cli-ar "Hunter x Hunter"
303
301
 
304
302
  ---
305
303
 
306
- ## ⚙️ Configuration
304
+ ## Configuration
307
305
 
308
306
  All user preferences are stored locally in:
309
307
  ```text
@@ -323,7 +321,7 @@ Open Settings (<kbd>c</kbd> or <kbd>O</kbd>) from the main menu at any time to c
323
321
 
324
322
  ---
325
323
 
326
- ## 👥 Contributors
324
+ ## Contributors
327
325
 
328
326
  Special thanks to everyone who has helped build, test, and maintain **ani-cli-arabic**:
329
327
 
@@ -338,34 +336,34 @@ Special thanks to everyone who has helped build, test, and maintain **ani-cli-ar
338
336
  * **[@IsmailMechkene](https://github.com/IsmailMechkene)** — Core Contributor
339
337
  * **[@ilyes-pro](https://github.com/ilyes-Pro)** — Core Contributor
340
338
 
341
- > 💡 **Want to contribute?** Check out our [Contributing Guidelines](.github/CONTRIBUTING.md) — issues and pull requests are always welcome!
339
+ > **Want to contribute?** Check out our [Contributing Guidelines](.github/CONTRIBUTING.md) — issues and pull requests are always welcome!
342
340
 
343
341
  ---
344
342
 
345
- ## 📄 License
343
+ ## License
346
344
 
347
345
  Licensed under the **GNU General Public License v3.0**. See the [LICENSE](LICENSE) file for full details.
348
346
 
349
- * ✅ Free for personal, educational, and community use
350
- * ✅ 100% open-source and transparent
351
- * ⚠️ Derivative works or forks must remain open-source under the **GPL-3.0** license
347
+ * Free for personal, educational, and community use
348
+ * 100% open-source and transparent
349
+ * Derivative works or forks must remain open-source under the **GPL-3.0** license
352
350
 
353
351
  ---
354
352
 
355
353
  <div align="center">
356
354
 
357
- <h3>💖 Support This Open-Source Project</h3>
355
+ <h3> Support This Open-Source Project</h3>
358
356
  <p>Your support helps cover infrastructure costs and keeps updates coming!</p>
359
357
  <a href="https://paypal.me/np4abdou"><img src="https://img.shields.io/badge/Donate_with_PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="Donate with PayPal" /></a>
360
358
 
361
359
  <br /><br />
362
360
 
363
- Made with ❤️ by the Anime Open-Source Community
361
+ Made with care by the Anime Open-Source Community
364
362
 
365
363
  <p>
366
- <a href="https://github.com/np4abdou1/ani-cli-arabic">⭐ Star Repo</a> &nbsp;•&nbsp;
367
- <a href="https://github.com/np4abdou1/ani-cli-arabic/issues">🐛 Report Bug</a> &nbsp;•&nbsp;
368
- <a href="https://github.com/np4abdou1/ani-cli-arabic/discussions">💬 Discussions</a>
364
+ <a href="https://github.com/np4abdou1/ani-cli-arabic">Star Repo</a> &nbsp;•&nbsp;
365
+ <a href="https://github.com/np4abdou1/ani-cli-arabic/issues">Report Bug</a> &nbsp;•&nbsp;
366
+ <a href="https://github.com/np4abdou1/ani-cli-arabic/discussions">Discussions</a>
369
367
  </p>
370
368
 
371
369
  </div>
@@ -28,20 +28,20 @@
28
28
  </p>
29
29
 
30
30
  <p>
31
- 🌍 <strong><a href="README.ar.md">للتصفح باللغة العربية اضغط هنا</a></strong>
31
+ <strong><a href="README.ar.md">للتصفح باللغة العربية اضغط هنا</a></strong>
32
32
  </p>
33
33
 
34
34
  <hr />
35
35
 
36
36
  <!-- Quick Navigation Bar -->
37
37
  <p>
38
- <a href="#-whats-new-in-v20">🚀 What's New</a> &nbsp;•&nbsp;
39
- <a href="#-providers--ecosystem">🌐 Providers</a> &nbsp;•&nbsp;
40
- <a href="#-installation">📦 Installation</a> &nbsp;•&nbsp;
41
- <a href="#-usage--cli-guide">🎮 Usage</a> &nbsp;•&nbsp;
42
- <a href="#️-keyboard-shortcuts">⌨️ Shortcuts</a> &nbsp;•&nbsp;
43
- <a href="#️-configuration">⚙️ Config</a> &nbsp;•&nbsp;
44
- <a href="#-contributors">👥 Contributors</a>
38
+ <a href="#whats-new-in-v20">What's New</a> &nbsp;•&nbsp;
39
+ <a href="#providers--ecosystem">Providers</a> &nbsp;•&nbsp;
40
+ <a href="#installation">Installation</a> &nbsp;•&nbsp;
41
+ <a href="#usage--cli-guide">Usage</a> &nbsp;•&nbsp;
42
+ <a href="#keyboard-shortcuts">Shortcuts</a> &nbsp;•&nbsp;
43
+ <a href="#configuration">Config</a> &nbsp;•&nbsp;
44
+ <a href="#contributors">Contributors</a>
45
45
  </p>
46
46
 
47
47
  </div>
@@ -49,47 +49,45 @@
49
49
  <br />
50
50
 
51
51
  <div align="center">
52
-
53
- https://github.com/user-attachments/assets/e74d4443-20b0-4683-b346-bf168a720025
54
-
52
+ <img src="assets/showcase.gif" alt="ani-cli-arabic Showcase" />
55
53
  </div>
56
54
 
57
55
  ---
58
56
 
59
- ## 🚀 What's New in v2.0?
57
+ ## What's New in v2.0?
60
58
 
61
59
  Version **2.0** is the largest architectural overhaul in the project's history, engineered from the ground up for speed, reliability, and zero external bloat:
62
60
 
63
61
  | Feature | Highlights |
64
62
  | :--- | :--- |
65
- | 🌐 **Multi-Provider Engine** | Stream seamlessly from **6 independent sources**: `Anime3rb`, `Anime Slayer`, `Animeify`, `HiAnime` (English Sub & Dub), `Stardima` (Arabic Dub), and `Stardima Kids` (Cartoons). |
66
- | 📥 **Native Chunked Downloader** | Built from scratch with parallel chunked streaming, pause/resume, and live speed/ETA metrics — **zero external tools required** (no `aria2c` or `yt-dlp`). |
67
- | ⚡ **Rebuilt Interactive CLI (`-i`)** | Organic `fzf` workflow with mouse navigation, zero Arabic RTL text clipping, and a quick episode action menu (`Play`, `Download`, `Batch`, `Quality`). |
68
- | 🎬 **Universal Players & IPC** | Native support for **MPV**, **VLC**, **Celluloid**, **IINA**, and **Syncplay**. Real-time MPV JSON-IPC socket monitoring saves exact-second resume timestamps. |
69
- | 🛡️ **Zero-Downtime Edge Routing** | Automatic 3-tier domain fallback chains across custom domains, Cloudflare Pages, and Cloudflare Workers. |
70
- | 🔒 **Hardened Privacy** | Zero playback tracking and isolated development branches from health telemetry. |
71
- | 🔄 **Cross-Platform Updater** | One-step automated updates across PyPI (`pip`), Arch Linux (`yay` / `paru`), and Homebrew. |
63
+ | **Multi-Provider Engine** | Stream seamlessly from **6 independent sources**: `Anime3rb`, `Anime Slayer`, `Animeify`, `HiAnime` (English Sub & Dub), `Stardima` (Arabic Dub), and `Stardima Kids` (Cartoons). |
64
+ | **Native Chunked Downloader** | Built from scratch with parallel chunked streaming, pause/resume, and live speed/ETA metrics — **zero external tools required** (no `aria2c` or `yt-dlp`). |
65
+ | **Rebuilt Interactive CLI (`-i`)** | Organic `fzf` workflow with mouse navigation, zero Arabic RTL text clipping, and a quick episode action menu (`Play`, `Download`, `Batch`, `Quality`). |
66
+ | **Universal Players & IPC** | Native support for **MPV**, **VLC**, **Celluloid**, **IINA**, and **Syncplay**. Real-time MPV JSON-IPC socket monitoring saves exact-second resume timestamps. |
67
+ | **Zero-Downtime Edge Routing** | Automatic 3-tier domain fallback chains across custom domains, Cloudflare Pages, and Cloudflare Workers. |
68
+ | **Hardened Privacy** | Zero playback tracking and isolated development branches from health telemetry. |
69
+ | **Cross-Platform Updater** | One-step automated updates across PyPI (`pip`), Arch Linux (`yay` / `paru`), and Homebrew. |
72
70
 
73
71
  ---
74
72
 
75
- ## 🌐 Providers & Ecosystem
73
+ ## Providers & Ecosystem
76
74
 
77
75
  Switch providers dynamically in the Settings menu (`[O]` / `[c]`) or directly via the `-p` CLI flag:
78
76
 
79
77
  | Provider | CLI Key | Language | Stream Features |
80
78
  | :--- | :---: | :---: | :--- |
81
- | **Anime3rb** | `anime3rb` | 🇸🇦 Arabic Sub | High-speed direct CDN streams with multi-quality selection |
82
- | **Anime Slayer** | `anime_slayer` | 🇸🇦 Arabic Sub | Official API endpoints with multiple backup episode servers |
83
- | **Animeify** | `animeify` | 🇸🇦 Arabic Sub | Mirror servers with fast resolution switching |
84
- | **HiAnime** | `hianime` | 🇬🇧 English Sub / Dub | Fast English subbed & dubbed streams with dynamic referer resolution |
85
- | **Stardima** | `stardima` | 🇸🇦 Arabic Dub | Direct multi-server streams with automatic Arabic audio stream selection |
86
- | **Stardima Kids** | `stardima_kids` | 🇸🇦 Arabic Dub | Dubbed cartoons and kids series, isolated from anime catalog |
79
+ | **Anime3rb** | `anime3rb` | Arabic Sub | High-speed direct CDN streams with multi-quality selection |
80
+ | **Anime Slayer** | `anime_slayer` | Arabic Sub | Official API endpoints with multiple backup episode servers |
81
+ | **Animeify** | `animeify` | Arabic Sub | Mirror servers with fast resolution switching |
82
+ | **HiAnime** | `hianime` | English Sub / Dub | Fast English subbed & dubbed streams with dynamic referer resolution |
83
+ | **Stardima** | `stardima` | Arabic Dub | Direct multi-server streams with automatic Arabic audio stream selection |
84
+ | **Stardima Kids** | `stardima_kids` | Arabic Dub | Dubbed cartoons and kids series, isolated from anime catalog |
87
85
 
88
86
  ---
89
87
 
90
- ## 📦 Installation
88
+ ## Installation
91
89
 
92
- ### 🔧 Prerequisites
90
+ ### Prerequisites
93
91
 
94
92
  Ensure the following core tools are installed on your system before launching:
95
93
 
@@ -100,7 +98,7 @@ Ensure the following core tools are installed on your system before launching:
100
98
 
101
99
  ---
102
100
 
103
- ### ⚡ Option 1: PyPI via `pip` (Recommended — Linux, macOS, Windows)
101
+ ### Option 1: PyPI via `pip` (Recommended — Linux, macOS, Windows)
104
102
 
105
103
  ```bash
106
104
  # Install the latest stable release
@@ -112,7 +110,7 @@ ani-cli-ar
112
110
  ```
113
111
 
114
112
  <details>
115
- <summary><b>🔄 How to upgrade via pip</b></summary>
113
+ <summary><b> How to upgrade via pip</b></summary>
116
114
 
117
115
  ```bash
118
116
  pip install --upgrade ani-cli-arabic
@@ -121,7 +119,7 @@ pip install --upgrade ani-cli-arabic
121
119
 
122
120
  ---
123
121
 
124
- ### 🏹 Option 2: Arch Linux (AUR)
122
+ ### Option 2: Arch Linux (AUR)
125
123
 
126
124
  Available directly in the Arch User Repository for Arch, Manjaro, EndeavourOS, and Garuda:
127
125
 
@@ -135,7 +133,7 @@ paru -S ani-cli-arabic
135
133
 
136
134
  ---
137
135
 
138
- ### 🛠️ Option 3: Build from Source
136
+ ### Option 3: Build from Source
139
137
 
140
138
  Run the bleeding-edge development branch directly:
141
139
 
@@ -148,15 +146,15 @@ python3 main.py
148
146
 
149
147
  ---
150
148
 
151
- ## 🎮 Usage & CLI Guide
149
+ ## Usage & CLI Guide
152
150
 
153
- ### 1️⃣ Full Terminal UI Mode (Default)
151
+ ### 1. Full Terminal UI Mode (Default)
154
152
  Launch the rich interactive dashboard with arrow-key navigation, themes, history, and favorites:
155
153
  ```bash
156
154
  ani-cli-ar
157
155
  ```
158
156
 
159
- ### 2️⃣ Fast Interactive `fzf` Mode (`-i`)
157
+ ### 2. Fast Interactive `fzf` Mode (`-i`)
160
158
  Bypass the TUI and search/play directly from a lightweight `fzf` menu in English or Arabic:
161
159
  ```bash
162
160
  # Search in English
@@ -166,7 +164,7 @@ ani-cli-ar -i "One Piece"
166
164
  ani-cli-ar -i "ون بيس"
167
165
  ```
168
166
 
169
- ### 3️⃣ Provider Selection via CLI (`-p`)
167
+ ### 3. Provider Selection via CLI (`-p`)
170
168
  Target a specific streaming provider right from your terminal command:
171
169
  ```bash
172
170
  # Stream from Anime3rb (Arabic Sub)
@@ -188,7 +186,7 @@ ani-cli-ar -p stardima "ناروتو"
188
186
  ani-cli-ar -p stardima_kids "سبونج بوب"
189
187
  ```
190
188
 
191
- ### 4️⃣ Direct Query Search
189
+ ### 4. Direct Query Search
192
190
  Jump straight into search results inside the TUI:
193
191
  ```bash
194
192
  ani-cli-ar "Hunter x Hunter"
@@ -196,12 +194,12 @@ ani-cli-ar "Hunter x Hunter"
196
194
 
197
195
  ---
198
196
 
199
- ## 🎯 Core Features Deep-Dive
197
+ ## Core Features Deep-Dive
200
198
 
201
199
  <table>
202
200
  <tr>
203
201
  <td width="50%" valign="top">
204
- <h3>📥 Chunked Batch Downloader</h3>
202
+ <h3> Chunked Batch Downloader</h3>
205
203
  <ul>
206
204
  <li><b>Flexible Ranges:</b> Download full seasons or specific episodes (<code>1-12</code>, <code>1,3,5</code>, or <code>all</code>).</li>
207
205
  <li><b>Multi-Threaded:</b> Parallel chunked HTTP streams with automatic pause & resume support.</li>
@@ -210,7 +208,7 @@ ani-cli-ar "Hunter x Hunter"
210
208
  </ul>
211
209
  </td>
212
210
  <td width="50%" valign="top">
213
- <h3>🎨 Modern TUI & Smart Features</h3>
211
+ <h3> Modern TUI & Smart Features</h3>
214
212
  <ul>
215
213
  <li><b>17 Built-in Themes:</b> <code>blue</code>, <code>red</code>, <code>green</code>, <code>purple</code>, <code>cyan</code>, <code>gold</code>, <code>rose</code>, <code>sunset</code>, and more.</li>
216
214
  <li><b>Discord Rich Presence:</b> Displays live anime poster, title, and episode status on your profile.</li>
@@ -221,16 +219,16 @@ ani-cli-ar "Hunter x Hunter"
221
219
  </tr>
222
220
  </table>
223
221
 
224
- > ℹ️ *Classification metadata uses TMDB data; this product uses the TMDB API but is not endorsed or certified by TMDB.*
222
+ > *Classification metadata uses TMDB data; this product uses the TMDB API but is not endorsed or certified by TMDB.*
225
223
 
226
224
  ---
227
225
 
228
- ## ⌨️ Keyboard Shortcuts
226
+ ## Keyboard Shortcuts
229
227
 
230
228
  <table>
231
229
  <tr>
232
- <th width="50%">🖥️ Main TUI Navigation</th>
233
- <th width="50%">🎬 Video Player (MPV)</th>
230
+ <th width="50%"> Main TUI Navigation</th>
231
+ <th width="50%"> Video Player (MPV)</th>
234
232
  </tr>
235
233
  <tr>
236
234
  <td valign="top">
@@ -266,7 +264,7 @@ ani-cli-ar "Hunter x Hunter"
266
264
 
267
265
  ---
268
266
 
269
- ## ⚙️ Configuration
267
+ ## Configuration
270
268
 
271
269
  All user preferences are stored locally in:
272
270
  ```text
@@ -286,7 +284,7 @@ Open Settings (<kbd>c</kbd> or <kbd>O</kbd>) from the main menu at any time to c
286
284
 
287
285
  ---
288
286
 
289
- ## 👥 Contributors
287
+ ## Contributors
290
288
 
291
289
  Special thanks to everyone who has helped build, test, and maintain **ani-cli-arabic**:
292
290
 
@@ -301,34 +299,34 @@ Special thanks to everyone who has helped build, test, and maintain **ani-cli-ar
301
299
  * **[@IsmailMechkene](https://github.com/IsmailMechkene)** — Core Contributor
302
300
  * **[@ilyes-pro](https://github.com/ilyes-Pro)** — Core Contributor
303
301
 
304
- > 💡 **Want to contribute?** Check out our [Contributing Guidelines](.github/CONTRIBUTING.md) — issues and pull requests are always welcome!
302
+ > **Want to contribute?** Check out our [Contributing Guidelines](.github/CONTRIBUTING.md) — issues and pull requests are always welcome!
305
303
 
306
304
  ---
307
305
 
308
- ## 📄 License
306
+ ## License
309
307
 
310
308
  Licensed under the **GNU General Public License v3.0**. See the [LICENSE](LICENSE) file for full details.
311
309
 
312
- * ✅ Free for personal, educational, and community use
313
- * ✅ 100% open-source and transparent
314
- * ⚠️ Derivative works or forks must remain open-source under the **GPL-3.0** license
310
+ * Free for personal, educational, and community use
311
+ * 100% open-source and transparent
312
+ * Derivative works or forks must remain open-source under the **GPL-3.0** license
315
313
 
316
314
  ---
317
315
 
318
316
  <div align="center">
319
317
 
320
- <h3>💖 Support This Open-Source Project</h3>
318
+ <h3> Support This Open-Source Project</h3>
321
319
  <p>Your support helps cover infrastructure costs and keeps updates coming!</p>
322
320
  <a href="https://paypal.me/np4abdou"><img src="https://img.shields.io/badge/Donate_with_PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="Donate with PayPal" /></a>
323
321
 
324
322
  <br /><br />
325
323
 
326
- Made with ❤️ by the Anime Open-Source Community
324
+ Made with care by the Anime Open-Source Community
327
325
 
328
326
  <p>
329
- <a href="https://github.com/np4abdou1/ani-cli-arabic">⭐ Star Repo</a> &nbsp;•&nbsp;
330
- <a href="https://github.com/np4abdou1/ani-cli-arabic/issues">🐛 Report Bug</a> &nbsp;•&nbsp;
331
- <a href="https://github.com/np4abdou1/ani-cli-arabic/discussions">💬 Discussions</a>
327
+ <a href="https://github.com/np4abdou1/ani-cli-arabic">Star Repo</a> &nbsp;•&nbsp;
328
+ <a href="https://github.com/np4abdou1/ani-cli-arabic/issues">Report Bug</a> &nbsp;•&nbsp;
329
+ <a href="https://github.com/np4abdou1/ani-cli-arabic/discussions">Discussions</a>
332
330
  </p>
333
331
 
334
332
  </div>