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.
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/PKG-INFO +55 -57
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/README.md +54 -56
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/PKG-INFO +55 -57
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/SOURCES.txt +2 -1
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/api.py +79 -38
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/app.py +7 -7
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/changelog.py +6 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/monitoring.py +37 -3
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/ui.py +5 -0
- ani_cli_arabic-2.1.2/src/updater.py +359 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/version.py +1 -1
- ani_cli_arabic-2.1.2/tests/test_updater.py +104 -0
- ani_cli_arabic-2.1.0/src/updater.py +0 -279
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/LICENSE +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/dependency_links.txt +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/entry_points.txt +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/requires.txt +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/ani_cli_arabic.egg-info/top_level.txt +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/pyproject.toml +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/setup.cfg +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/__init__.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/__main__.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/broadcast.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/broadcast_popup.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/cli.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/config.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/deps.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/discord_rpc.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/downloader.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/favorites.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/history.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/logger.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/models.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/player.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/__init__.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/anime3rb.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/anime_slayer.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/animeify.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/base.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/hianime.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/manager.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/stardima.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/stardima_catalog.json +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/providers/stardima_client.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/settings.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/storage.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/src/utils.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/tests/test_logger.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/tests/test_monitoring.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/tests/test_smart.py +0 -0
- {ani_cli_arabic-2.1.0 → ani_cli_arabic-2.1.2}/tests/test_stardima.py +0 -0
- {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.
|
|
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
|
-
|
|
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="
|
|
76
|
-
<a href="
|
|
77
|
-
<a href="
|
|
78
|
-
<a href="
|
|
79
|
-
<a href="
|
|
80
|
-
<a href="
|
|
81
|
-
<a href="
|
|
75
|
+
<a href="#whats-new-in-v20">What's New</a> •
|
|
76
|
+
<a href="#providers--ecosystem">Providers</a> •
|
|
77
|
+
<a href="#installation">Installation</a> •
|
|
78
|
+
<a href="#usage--cli-guide">Usage</a> •
|
|
79
|
+
<a href="#keyboard-shortcuts">Shortcuts</a> •
|
|
80
|
+
<a href="#configuration">Config</a> •
|
|
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
|
-
##
|
|
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
|
-
|
|
|
103
|
-
|
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
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
|
-
##
|
|
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` |
|
|
119
|
-
| **Anime Slayer** | `anime_slayer` |
|
|
120
|
-
| **Animeify** | `animeify` |
|
|
121
|
-
| **HiAnime** | `hianime` |
|
|
122
|
-
| **Stardima** | `stardima` |
|
|
123
|
-
| **Stardima Kids** | `stardima_kids` |
|
|
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
|
-
##
|
|
125
|
+
## Installation
|
|
128
126
|
|
|
129
|
-
###
|
|
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
|
-
###
|
|
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
|
|
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
|
-
###
|
|
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
|
-
###
|
|
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
|
-
##
|
|
186
|
+
## Usage & CLI Guide
|
|
189
187
|
|
|
190
|
-
### 1
|
|
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
|
|
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
|
|
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
|
|
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
|
-
##
|
|
234
|
+
## Core Features Deep-Dive
|
|
237
235
|
|
|
238
236
|
<table>
|
|
239
237
|
<tr>
|
|
240
238
|
<td width="50%" valign="top">
|
|
241
|
-
<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
|
|
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
|
-
>
|
|
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
|
-
##
|
|
263
|
+
## Keyboard Shortcuts
|
|
266
264
|
|
|
267
265
|
<table>
|
|
268
266
|
<tr>
|
|
269
|
-
<th width="50%"
|
|
270
|
-
<th width="50%"
|
|
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
|
-
##
|
|
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
|
-
##
|
|
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
|
-
>
|
|
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
|
-
##
|
|
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
|
-
*
|
|
350
|
-
*
|
|
351
|
-
*
|
|
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
|
|
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
|
|
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"
|
|
367
|
-
<a href="https://github.com/np4abdou1/ani-cli-arabic/issues"
|
|
368
|
-
<a href="https://github.com/np4abdou1/ani-cli-arabic/discussions"
|
|
364
|
+
<a href="https://github.com/np4abdou1/ani-cli-arabic">Star Repo</a> •
|
|
365
|
+
<a href="https://github.com/np4abdou1/ani-cli-arabic/issues">Report Bug</a> •
|
|
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
|
-
|
|
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="
|
|
39
|
-
<a href="
|
|
40
|
-
<a href="
|
|
41
|
-
<a href="
|
|
42
|
-
<a href="
|
|
43
|
-
<a href="
|
|
44
|
-
<a href="
|
|
38
|
+
<a href="#whats-new-in-v20">What's New</a> •
|
|
39
|
+
<a href="#providers--ecosystem">Providers</a> •
|
|
40
|
+
<a href="#installation">Installation</a> •
|
|
41
|
+
<a href="#usage--cli-guide">Usage</a> •
|
|
42
|
+
<a href="#keyboard-shortcuts">Shortcuts</a> •
|
|
43
|
+
<a href="#configuration">Config</a> •
|
|
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
|
-
##
|
|
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
|
-
|
|
|
66
|
-
|
|
|
67
|
-
|
|
|
68
|
-
|
|
|
69
|
-
|
|
|
70
|
-
|
|
|
71
|
-
|
|
|
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
|
-
##
|
|
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` |
|
|
82
|
-
| **Anime Slayer** | `anime_slayer` |
|
|
83
|
-
| **Animeify** | `animeify` |
|
|
84
|
-
| **HiAnime** | `hianime` |
|
|
85
|
-
| **Stardima** | `stardima` |
|
|
86
|
-
| **Stardima Kids** | `stardima_kids` |
|
|
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
|
-
##
|
|
88
|
+
## Installation
|
|
91
89
|
|
|
92
|
-
###
|
|
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
|
-
###
|
|
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
|
|
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
|
-
###
|
|
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
|
-
###
|
|
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
|
-
##
|
|
149
|
+
## Usage & CLI Guide
|
|
152
150
|
|
|
153
|
-
### 1
|
|
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
|
|
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
|
|
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
|
|
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
|
-
##
|
|
197
|
+
## Core Features Deep-Dive
|
|
200
198
|
|
|
201
199
|
<table>
|
|
202
200
|
<tr>
|
|
203
201
|
<td width="50%" valign="top">
|
|
204
|
-
<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
|
|
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
|
-
>
|
|
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
|
-
##
|
|
226
|
+
## Keyboard Shortcuts
|
|
229
227
|
|
|
230
228
|
<table>
|
|
231
229
|
<tr>
|
|
232
|
-
<th width="50%"
|
|
233
|
-
<th width="50%"
|
|
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
|
-
##
|
|
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
|
-
##
|
|
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
|
-
>
|
|
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
|
-
##
|
|
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
|
-
*
|
|
313
|
-
*
|
|
314
|
-
*
|
|
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
|
|
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
|
|
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"
|
|
330
|
-
<a href="https://github.com/np4abdou1/ani-cli-arabic/issues"
|
|
331
|
-
<a href="https://github.com/np4abdou1/ani-cli-arabic/discussions"
|
|
327
|
+
<a href="https://github.com/np4abdou1/ani-cli-arabic">Star Repo</a> •
|
|
328
|
+
<a href="https://github.com/np4abdou1/ani-cli-arabic/issues">Report Bug</a> •
|
|
329
|
+
<a href="https://github.com/np4abdou1/ani-cli-arabic/discussions">Discussions</a>
|
|
332
330
|
</p>
|
|
333
331
|
|
|
334
332
|
</div>
|