|
| 1 | +# 🎬 AniPlay — Premium Mobile Anime Client |
| 2 | + |
| 3 | +AniPlay is a premium, open-source mobile anime streaming client designed for Android devices. Built using a hybrid web-native architecture (React + Vite + Capacitor), it offers a fluid, glassmorphic UI, responsive controls, and high-performance video playback. |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## 📱 Screenshots & Application Walkthrough |
| 8 | + |
| 9 | +AniPlay provides a sleek, modern, and intuitive user interface designed to match premium streaming platforms. Below is an overview of the key screens and features: |
| 10 | + |
| 11 | +| **Welcome & Onboarding** | **Spotlight & Home** | **Discovery Feed** | |
| 12 | +| :---: | :---: | :---: | |
| 13 | +| <img src="assets/screenshots/welcome_screen.jpg" width="220" alt="Welcome Screen"> | <img src="assets/screenshots/home_screen.jpg" width="220" alt="Home Screen"> | <img src="assets/screenshots/home_feed.jpg" width="220" alt="Discovery Feed"> | |
| 14 | +| **Welcome Screen**<br>A stunning glassmorphic intro screen featuring a blurred collage of popular anime art, prompting guest access ("Watch now") or credentials sign-in. | **Featured Spotlight**<br>An immersive home banner highlighting trending titles (e.g. *Solo Leveling*) with dynamic context-aware backgrounds, quick list-adds, and recent episode updates. | **Content Discovery**<br>Scrolled home view detailing *Top Airing*, *Airing This Week*, and *Popular This Season* grids with clear video quality (HD) and rating indicators. | |
| 15 | + |
| 16 | +<br> |
| 17 | + |
| 18 | +| **Upcoming Release Schedule** | **Advanced Video Player** | |
| 19 | +| :---: | :---: | |
| 20 | +| <img src="assets/screenshots/schedule_screen.jpg" width="220" alt="Schedule Screen"> | <img src="assets/screenshots/player_screen.jpg" width="220" alt="Video Player"> | |
| 21 | +| **Release Calendar**<br>A chronological, timezone-aware calendar displaying upcoming episode releases, integrated with AniList metadata and quick watchlist actions. | **HLS Video Player & Episode Hub**<br>Feature-packed media player with double-tap seek, fit options, sub/dub selectors, multi-source streaming routes (e.g. *AniHD1*, *Neko*, *Waves*), and a scrolling episode drawer. | |
| 22 | + |
| 23 | +--- |
| 24 | + |
| 25 | +## 🌟 Key Features |
| 26 | + |
| 27 | +* **🎭 Elegant UI & Fluid Animations**: Modern, dark-themed user interface utilizing curated indigo/violet accent gradients, responsive carousels, and micro-interactions. |
| 28 | +* **💾 Native Device Storage (Capacitor Preferences)**: Save watchlist details, favorites, and track precise watch history directly to the native Android SharedPreferences database (cache-wipe proof). |
| 29 | +* **📺 High-Performance HLS Player**: Custom HTML5 media player tailored for mobile touchscreens, featuring double-tap seek, automatic orientation locking/unlocking, gesture controls, and clean error states. |
| 30 | +* **📡 Dynamic Server Aggregation**: Fetches and aggregates public streams on-demand, automatically parsing subtitle tracks, available resolutions, and host metadata. Designed with a zero-trust architecture that never stores user credentials locally. |
| 31 | +* **🔄 Serverless Live Updates**: Built-in background update checker that compares installed versions against GitHub releases, enabling remote updates and domain hot-swaps instantly. |
| 32 | +* **📅 Adaptive Schedule Feed**: Fully integrated with the AniList GraphQL API to fetch upcoming episode releases, schedules, and metadata. |
| 33 | + |
| 34 | +--- |
| 35 | + |
| 36 | +## 🛠️ Architecture |
| 37 | + |
| 38 | +AniPlay is built on the **Capacitor WebView Bridge** standard: |
| 39 | +* **UI Layer**: React Single Page Application (SPA) powered by Vite. |
| 40 | +* **Styling**: Vanilla CSS utilizing custom properties and modern layout elements (Flexbox/CSS Grid). |
| 41 | +* **Native Integration**: Capacitor plugins for hardware lifecycle hooks, status bar overlay, device orientation locks, and native SharedPreferences database access. |
| 42 | + |
| 43 | +--- |
| 44 | + |
| 45 | +## 📲 Installation |
| 46 | + |
| 47 | +To run AniPlay on your Android phone, download the latest build from the Releases tab: |
| 48 | + |
| 49 | +1. Go to the [Releases](https://github.com/SahilKumar337/AniPlay/releases) page. |
| 50 | +2. Download the **app-release.apk** file. |
| 51 | +3. Open the downloaded file on your Android device. |
| 52 | +4. Enable *"Install from Unknown Sources"* if prompted by your system. |
| 53 | +5. Tap **Install** and launch **AniPlay**! |
| 54 | + |
| 55 | +--- |
| 56 | + |
| 57 | +## 🔒 Privacy & Security |
| 58 | + |
| 59 | +AniPlay values your privacy: |
| 60 | +* All favorites, watch history, and playlists are stored **locally** on your device. |
| 61 | +* No personal data or user accounts are sent to external databases. |
| 62 | +* Streaming connections are requested directly to aggregation endpoints, keeping the user interface completely independent. |
0 commit comments