ani-cli-ar 1.8.4__py3-none-any.whl

ani_cli_ar-1.8.4.dist-info/METADATA

@@ -0,0 +1,348 @@
+Metadata-Version: 2.4
+Name: ani-cli-ar
+Version: 1.8.4
+Summary: Terminal-based anime streaming with Arabic subtitles
+Author: NoBy
+Maintainer: NoBy
+License-Expression: GPL-3.0
+Project-URL: Homepage, https://github.com/np4abdou1/ani-cli-arabic
+Project-URL: Repository, https://github.com/np4abdou1/ani-cli-arabic
+Project-URL: Issues, https://github.com/np4abdou1/ani-cli-arabic/issues
+Project-URL: Changelog, https://github.com/np4abdou1/ani-cli-arabic/releases
+Keywords: anime,streaming,cli,arabic,subtitles,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pypresence>=4.5.0
+Requires-Dist: yt-dlp
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: pycryptodomex
+Dynamic: license-file
+
+<h1 align="center">                          NEW MAJOR UPDATE COMING IN LATE SUMMER </h1> 
+
+<div align="center">
+
+<h2>💖 Support This Open Source Project</h2>
+<p>Your support helps maintain the project and keeps the updates coming!</p>
+<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>
+<br><br><br>
+
+Terminal-based anime streaming with Arabic subtitles
+
+<p align="center">
+  <a href="https://github.com/np4abdou1/ani-cli-arabic/stargazers">
+    <img src="https://img.shields.io/github/stars/np4abdou1/ani-cli-arabic?style=for-the-badge" />
+  </a>
+  <a href="https://github.com/np4abdou1/ani-cli-arabic/network">
+    <img src="https://img.shields.io/github/forks/np4abdou1/ani-cli-arabic?style=for-the-badge" />
+  </a>
+  <br>
+  <a href="https://github.com/np4abdou1/ani-cli-arabic/releases">
+    <img src="https://img.shields.io/github/v/release/np4abdou1/ani-cli-arabic?style=for-the-badge" />
+  </a>
+  <a href="https://pypi.org/project/ani-cli-arabic">
+    <img src="https://img.shields.io/pypi/v/ani-cli-arabic?style=for-the-badge" />
+  </a>
+  <a href="https://aur.archlinux.org/packages/ani-cli-arabic">
+  <img src="https://img.shields.io/aur/version/ani-cli-arabic?style=for-the-badge" />
+  </a>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3.8+-3776AB?style=for-the-badge&logo=python&logoColor=white" />
+  <img src="https://img.shields.io/badge/License-GPL--3.0-green?style=for-the-badge" />
+</p>
+
+<br>
+
+## 📑 Navigation
+
+[Installation](#-installation) • [Features](#-what-can-you-do) • [How to Use](#-how-to-use) • [Keyboard Shortcuts](#️-keyboard-shortcuts) • [Configuration](#%EF%B8%8F-configuration) • [Contributors](#-contributors) • [License](#-license)
+
+<br><br>
+
+<p>لإختيار اللغة العربية اضغط على الزر: </p>
+<a href="README.ar.md">
+  <img src="https://img.shields.io/badge/Language-Arabic-green?style=for-the-badge&logo=google-translate&logoColor=white" alt="Arabic">
+</a>
+
+<br>
+<br>
+
+https://github.com/user-attachments/assets/a6c6882a-7c50-4a8d-aa9c-e56a6d4ff7eb
+
+</div>
+
+---
+
+## 📦 Installation
+
+### Requirements
+Before installing, make sure you have: 
+- **Python 3.8 or newer** (Python 3.12 recommended)
+- **MPV** or **VLC** media player (for streaming)
+
+### Method 1: One-Line Installer (Recommended)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/np4abdou1/ani-cli-arabic/main/install.sh | sh
+```
+
+This auto-detects your environment (Linux, macOS, Termux) and installs via `pipx` or `pip`.
+
+### Method 2: Install via pip / pipx
+
+```bash
+# Direct from GitHub (always latest)
+pip install git+https://github.com/np4abdou1/ani-cli-arabic.git
+
+# Or from PyPI (stable releases)
+pip install ani-cli-ar
+
+# Or with pipx (isolated environment, recommended)
+pipx install ani-cli-ar
+```
+
+Launch the app:
+```bash
+ani-cli-ar
+```
+
+To update:
+```bash
+pip install --upgrade ani-cli-ar
+```
+
+### Method 3: Arch Linux (AUR)
+
+For Arch Linux users, install from the AUR: 
+
+```bash
+yay -S ani-cli-ar
+# or
+paru -S ani-cli-ar
+```
+
+### Method 4: From Source (Development)
+
+```bash
+git clone https://github.com/np4abdou1/ani-cli-arabic.git
+cd ani-cli-arabic
+pip install -e .
+ani-cli-ar
+```
+
+---
+
+## 🎯 What Can You Do?
+
+Here's everything this tool offers:
+
+### Streaming & Playback
+- **Multiple Quality Options**: Watch in 1080p, 720p, or 480p depending on your internet speed
+- **Batch Download**: Download multiple episodes at once to watch offline
+- **Trailer Support**: Watch YouTube trailers before committing to an anime
+- **Resume from History**: Pick up exactly where you left off ( buggy )
+
+### Discovery & Browsing
+- **Search Anime**: Find any anime and anime movie by name (supports both English and Japanese titles and arabic titles)
+- **Trending Now**: See what's currently popular
+- **Top Rated**: Browse the highest-rated anime of all time
+- **Browse by Genre**: Filter by Action, Romance, Isekai, and 12 other genres
+- **Browse by Studio**: Find anime from Toei Animation, MAPPA, Ufotable, and 20+ more studios
+- **Latest Releases**: Stay updated with the newest anime
+
+### Personal Library
+- **Watch History**: Keep track of everything you've watched with timestamps
+- **Favorites System**: Bookmark your favorite anime for quick access
+- **Episode Tracking**: The app remembers which episode you're on
+
+### Interface & Experience
+- **Rich TUI (Terminal User Interface)**: Beautiful terminal interface built with Rich library
+- **17 Color Themes**: Choose from blue, red, purple, sunset, mint, lavender, and more 
+- **Discord Rich Presence**: Show off what you're watching on Discord with anime posters 
+<img width="864" height="372" alt="image" src="https://github.com/user-attachments/assets/eb8c5bc1-84dc-46a0-9b06-7efc5a5fee6d" />
+
+- **Smooth Navigation**: Intuitive keyboard controls
+
+### Technical Features
+- **Zero Ads**: Clean streaming experience
+- **Automatic Updates**: Built-in version checker notifies you of new releases, and yes this can be turned off.
+- **MPV/VLC Support**: Choose your preferred media player
+- **Dependency Auto-installer**: Automatically checks and installs missing dependencies, too lazy...
+- **CLI Mode**: Simple command-line mode for quick searches (`ani-cli-ar -i "Naruto"`) _interactive mode also runs if the terminal is too narrow_
+- **Cross-platform**: Works on Windows and Linux
+
+---
+
+## 🎮 How to Use
+
+1. **Launch the app**:  Run `ani-cli-arabic` or `ani-cli-ar`
+2. **Browse or Search**: Use the main menu to search, view trending, or browse genres
+3. **Select an Anime**: Navigate with arrow keys and press Enter
+4. **Pick an Episode**: Choose which episode to watch
+5. **Select Quality**: Pick your preferred video quality
+6. **Enjoy**: MPV will launch and start streaming
+
+You can also use interactive mode for quick searches:
+```bash
+ani-cli-ar -i "One Piece"
+```
+
+---
+
+## ⌨️ Keyboard Shortcuts
+
+| Key | What it Does |
+|-----|--------------|
+| **↑ / ↓** | Navigate through lists |
+| **Enter** | Select/Confirm choice |
+| **G** | Jump directly to an episode number |
+| **B** | Go back to previous screen |
+| **Q / Esc** | Quit the application |
+| **Space** | Pause/Resume video (in player) |
+| **← / →** | Rewind/Forward 5 seconds |
+| **F** | Toggle fullscreen |
+
+---
+
+## ⚙️ Configuration
+
+Settings are stored locally in `~/.ani-cli-arabic/database/config.json`
+
+### Available Settings
+
+Access the settings menu from the main screen to customize:
+
+- **Default Quality**: Set your preferred quality (1080p, 720p, or 480p)
+- **Media Player**: Choose between MPV or VLC
+- **Auto-next Episode**: Toggle automatic episode continuation
+- **Discord Rich Presence**:  Show or hide Discord activity
+- **Theme Color**: Pick from 17 beautiful color schemes: 
+  - blue, red, green, purple, cyan, yellow, pink, orange, teal, magenta
+  - lime, coral, lavender, gold, mint, rose, sunset
+- **Analytics**:  Opt-in/out of anonymous usage stats - this is auto enabled by default.
+- **Update Checking**: Toggle automatic update notifications
+
+You can also manually edit the config file if you prefer. 
+
+---
+
+## Star History
+
+<a href="https://www.star-history.com/#np4abdou1/ani-cli-arabic&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=np4abdou1/ani-cli-arabic&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=np4abdou1/ani-cli-arabic&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=np4abdou1/ani-cli-arabic&type=date&legend=top-left" />
+ </picture>
+</a>
+
+---
+
+## 👥 Contributors
+
+Special thanks to everyone who helped make this project happen: 
+
+<div align="center">
+
+[![Contributors](https://contrib.rocks/image?repo=np4abdou1/ani-cli-arabic)](https://github.com/np4abdou1/ani-cli-arabic/graphs/contributors)
+
+</div>
+
+**Key Contributors:**
+- [@np4abdou1](https://github.com/np4abdou1) - Creator and main developer
+- [@Anas-Tou](https://github.com/Anas-Tou) - Contributor
+
+Want to contribute? Feel free to open issues or submit pull requests!
+
+---
+
+## 🔧 Build & Release (for maintainers)
+
+### Build the package
+
+```bash
+# Install build tools
+pip install build twine
+
+# Build source distribution and wheel
+python -m build
+
+# Check the package
+twine check dist/*
+```
+
+### Publish to PyPI
+
+```bash
+# Upload to PyPI
+twine upload dist/*
+
+# Or for test PyPI first:
+# twine upload --repository-url https://test.pypi.org/legacy/ dist/*
+```
+
+### Installing from a local build
+
+```bash
+pip install dist/ani_cli_arabic-*.whl
+```
+
+---
+
+## 📄 License
+
+This project is licensed under the **GNU General Public License v3.0**. 
+
+You're free to use, modify, and distribute this software under the terms of the GPL-3.0 license.  See the [LICENSE](LICENSE) file for the full legal text.
+
+**In simple terms:**
+- ✅ Use it for personal or commercial purposes
+- ✅ Modify the source code
+- ✅ Distribute it to others
+- ⚠️ Any modifications must also be open source under GPL-3.0
+- ⚠️ Include the original copyright notice
+
+---
+
+<div align="center">
+
+### ⚠️ Important Notice
+
+</div>
+
+> [! CAUTION]
+> **By using this software you understand:**
+> 
+> - Anonymous usage statistics are collected for the GitHub page stats banner (can be disabled in settings)
+> - The project is licensed under GPL-3.0 - see [LICENSE](LICENSE) for details
+> - We do not host any content; all streams are from third-party sources
+> - This tool is for personal use and educational purposes only
+
+---
+
+<br>
+
+Made with ❤️ by the anime community
+
+[⭐ Star this repo](https://github.com/np4abdou1/ani-cli-arabic) | [🐛 Report bugs](https://github.com/np4abdou1/ani-cli-arabic/issues) | [💬 Discussions](https://github.com/np4abdou1/ani-cli-arabic/discussions)
+
+</div>

ani_cli_ar-1.8.4.dist-info/RECORD

@@ -0,0 +1,27 @@
+ani_cli_ar-1.8.4.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+ani_cli_arabic/__init__.py,sha256=Tat3WDaKrh5ILuubTDBRbmHR2_-uPADqNx-vLhd3iMs,56
+ani_cli_arabic/__main__.py,sha256=jXDguYrj7S_2k_H8Rx2mazf3aPNPW-HozkHcIBH59L8,166
+ani_cli_arabic/api.py,sha256=QAxPM2P-jQGAi_-qfqKePs5EetdPr6WEOCfpjOaHPDA,11287
+ani_cli_arabic/app.py,sha256=1SkSsEoKk8UOpIiH8jQfXbRutWWZeiHs3vbNQVWTS18,43264
+ani_cli_arabic/cli.py,sha256=APYccr3C40EyeMUBgRYKruVqa1XsYBqGvmcdSLf_K2I,24870
+ani_cli_arabic/config.py,sha256=oEi2j9Y2kZTlPcM0JACJIkZCthSNUeGGC2q5EcPX3Y4,7848
+ani_cli_arabic/deps.py,sha256=goXlYqMzPVnQIj4lgwdd8C8ge5m8gWOVzqW41seefhw,16372
+ani_cli_arabic/discord_rpc.py,sha256=_chuKdeQBdbm45XeuNOhHVGiv4ol6PvK90lpKSKL0kM,13314
+ani_cli_arabic/favorites.py,sha256=lIFUzfuqYpocmss5zFw2756ZGDa_CLdl4KoC7i8BUUk,2401
+ani_cli_arabic/history.py,sha256=aq8Sk_UveLv1X9I_XPKDPITvz648XcgBLMZdTGeSjuQ,2540
+ani_cli_arabic/models.py,sha256=ETG5Bb0H8r2f7aH1_X2LOyIRe9stBPqMYDinT8QzGE4,587
+ani_cli_arabic/monitoring.py,sha256=u-qFUIw6IEdwnFJ9DQQwqKuObVt8n_9L50IDYBZmcXc,2878
+ani_cli_arabic/player.py,sha256=a74L3oiJKMYUbNCLAF38P2p4k7MwuMR98MLHL3Zystg,10714
+ani_cli_arabic/settings.py,sha256=RrLHimT0au-Tw2wMAiowkdeAp5rCPSXNLTmLx2QSo4w,1776
+ani_cli_arabic/storage.py,sha256=bQpz8wTMfFAvXi7dnf2M6ygBrVK0UDOoHRanhEVpBCE,764
+ani_cli_arabic/ui.py,sha256=s7g2m63GyeFOCe2kUvCUN1DkQ_HifYq2UN_8sDdc2Eg,65042
+ani_cli_arabic/updater.py,sha256=2PvOFochHA1aP8dt_oPLAQ6YGxJgZS1jjm3vbe5F-zE,10151
+ani_cli_arabic/utils.py,sha256=DETDtjYlLvn8aPuoqsCsj81pYHHFS7VHeK3Z7ekKC5I,21065
+ani_cli_arabic/version.py,sha256=cnkC2KJgtF20Envp2ursBMYp2DZvh1BQnc7_brw6AtY,319
+ani_cli_arabic/scrapers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ani_cli_arabic/scrapers/english.py,sha256=1CV-tX5KHqrLHW2iCctKNBYhuWvxlEte6_2u6VzwcPc,12453
+ani_cli_ar-1.8.4.dist-info/METADATA,sha256=iyaTOTTdjRsLThKsDUnOSW2ENaQ1fsLRFKrKMPVyxtU,11302
+ani_cli_ar-1.8.4.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+ani_cli_ar-1.8.4.dist-info/entry_points.txt,sha256=0R5ltdA4HMw92uDvWYm2rmzwWj7d7wVUitZK4UGQ6q4,96
+ani_cli_ar-1.8.4.dist-info/top_level.txt,sha256=qOIqFZbK2qsyp7taUK4PrbTuAXN4TgHkoOMyy04pb0Q,15
+ani_cli_ar-1.8.4.dist-info/RECORD,,

ani_cli_ar-1.8.4.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ani_cli_ar-1.8.4.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ani-cli-ar = ani_cli_arabic.app:main
+ani-cli-arabic = ani_cli_arabic.app:main