| 🔍 | Jikan API Integration | Uses Jikan API (official MyAnimeList API, 99.9% uptime) for reliable metadata provider. Fallback to AnimeKAI for missing data. |
| ⚡ | AnimeKAI Streaming Fix | Fixed production streaming by using AnimeKAI bridge. Jikan (metadata) → AnimeKAI (streaming sources). Resolves 404 errors on Render. |
| 📊 | Accurate Episode Tracking | Displays all available episodes correctly. Episode ID format: jikan::malId::episodeNumber for proper routing and fallback. |
| 🌐 | Production-Ready Streaming | Fully tested on Render production. Metadata search from Jikan, streaming sources from AnimeKAI, M3U8 playback via HLS. |
Click to expand v2.4.0 changelog
| 🎥 | HLS.js Streaming | Native HLS.js player with adaptive quality, replacing iframe embeds |
| 🧭 | Season-Safe Matching | Explicit season-aware ranking prevents season overlap (e.g., S3 titles resolving to S1 sources) |
| 🛡️ | CDN Resilience | Delayed retry with backoff, referer rotation, and source re-fetch for MegaCloud CDN blocking |
| ⚡ | Rapid Episode Switch | Three-layer request cancellation (AbortController + signal forwarding + server disconnect detection) |
| 🎬 | Skip Intro & Outro | One-click skip buttons using API-provided timestamps |
╭─────────────────────────────────────────────────────────────────╮
│ │
│ 🎬 STREAMING 👤 EXPERIENCE 🔧 TECHNICAL │
│ ─────────────── ─────────────── ─────────────── │
│ │
│ ▸ HLS Adaptive ▸ User Accounts ▸ React 18 + TS │
│ ▸ Multi-Server ▸ Watch History ▸ Vite 7 Build │
│ ▸ Sub/Dub Toggle ▸ Favorites List ▸ Express 5 API │
│ ▸ Skip Intro/Outro ▸ Cross-Device ▸ HLS.js Player │
│ ▸ Auto Subtitles ▸ Custom Avatars ▸ Self-Hosted │
│ ▸ Resume Playback ▸ Dark/Light Mode ▸ Tailwind CSS │
│ │
╰─────────────────────────────────────────────────────────────────╯
📺 Video Player Highlights
| Feature | Description |
|---|---|
| 🔄 Adaptive Streaming | HLS.js with automatic quality switching and same-origin stream proxy |
| ⏭️ Skip Intro/Outro | Smart buttons appear during intro and outro segments |
| ⏪⏩ Quick Seek | Instant ±10 second skip buttons for precise playback control |
| 📝 Smart Subtitles | Auto-selects English, with dropdown for 10+ languages |
| 🔁 Auto-Retry | Multi-phase error recovery: delayed retry, source re-fetch, embed fallback |
| 📍 Resume Playback | Continue from exactly where you left off with smart episode progression |
| 🎚️ Source Selector | Switch between multiple streaming servers on-the-fly |
| 🎯 Smart Progress | Auto-cleanup completed series and intelligent next episode detection |
👤 User Experience Features
| Feature | Description |
|---|---|
| 🔐 Secure Auth | Firebase authentication with email/password and Google OAuth |
| 📜 Smart History | Auto-tracking with intelligent duplicate prevention |
| 🔄 Auto-Progress | Automatically advance to next episode on 97%+ completion |
| 🗑️ Auto-Cleanup | Completed series removed automatically from Continue Watching |
| ❤️ Favorites | Save your favorite anime for instant access |
| ☁️ Cloud Sync | Seamless sync across all your devices in real-time |
| 🎨 Customization | Choose from 50+ anime character avatars |
| 🌓 Themes | Beautiful dark and light mode with smooth transitions |
| 📅 Seasonal Updates | Automatic refresh when anime seasons change |
╔══════════════════════════════════════════╗
║ ║
║ $ ny-cli search "one piece" ║
║ ║
║ Searching... ║
║ Found: One Piece (1120 eps) ║
║ Playing episode 1120... ║
║ ║
╚══════════════════════════════════════════╝
Love the command line? NY-CLI brings the full NyAnime experience to your terminal!
# One-line install
curl -sL https://raw.githubusercontent.com/AnjishnuSengupta/ny-cli/main/install.sh | sh
# Or via npm
npm install -g ny-cliFeatures: Search · Trending · Continue Watching · Cloud Sync · MPV/VLC Support
- Node.js 18+
- npm or yarn
- Firebase project (for auth & database)
# Clone the repository
git clone https://github.com/AnjishnuSengupta/nyanime.git
# Navigate to project
cd nyanime
# Install dependencies
npm install
# Copy environment template
cp .env.example .env
# Start development server
npm run devCreate a .env file with your Firebase credentials:
VITE_FIREBASE_API_KEY=your_api_key
VITE_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
VITE_FIREBASE_PROJECT_ID=your_project_id
VITE_FIREBASE_STORAGE_BUCKET=your_project.appspot.com
VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
VITE_FIREBASE_APP_ID=your_app_idOpen localhost:8080 and start watching! 🎉
| Layer | Technologies |
|---|---|
| Frontend |     |
| Backend |   |
| Services |   |
| Scraping |  |
NyAnime uses a multi-provider strategy for maximum reliability:
-
Jikan API (Primary — Metadata)
- Official MyAnimeList API, no scraping required
- Used for: Search, anime info, episode lists, episode titles
- Reliable: 99.9% uptime, no rate limiting for metadata
- Returns all episodes with accurate numbering
-
AnimeKAI (Streaming Sources)
- Primary source for M3U8 streaming URLs
- Used for: Finding episode tokens, extracting streaming links
- Direct integration for high streaming success rate
User searches anime
↓
Try Jikan API → AnimeKAI
↓ (if found, continues with this anime)
User clicks episode
↓
Get episode info from Jikan (title, number)
↓
Search anime on AnimeKAI (by title)
↓
Get episode token from AnimeKAI
↓
Fetch M3U8 streaming sources from AnimeKAI
↓
HLS.js player streams with adaptive quality
- Jikan: Stable official API, no scraping, no downtime
- AnimeKAI: Backup metadata provider for edge cases
- Fallbacks: If one provider down, others automatically used
- All APIs are public (Jikan, AnimeKAI)
- No authentication or API keys required
- Pure proxy model — Express.js delegates to providers
- Lightweight, deployable on free tier (Render, Vercel)
| Build Command | npm install && npm run build |
| Start Command | npm start |
| Health Check | /health |
Note: Free tier has ~50s cold start. The app automatically pings the backend on load to minimize delays.
NODE_ENV=productionVITE_USE_DIRECT_API=false
Note: No additional API URLs needed. All providers are public and hardcoded.
Vercel is supported via /api/* serverless routes in this repo.
NODE_ENV=productionRENDER_STREAM_PROXY=https://<your-render-service-domain>VITE_STREAM_PROXY_URL=https://<your-render-service-domain>
No. As of v2.5.3, NyAnime uses fully public APIs:
- Jikan API (primary metadata provider — official MyAnimeList API)
- AnimeKAI (primary streaming sources provider)
- Consumet: No longer used as a fallback metadata aggregator
All are publicly accessible with no authentication required. No custom backend needed. No API keys required.
- Render free instances can sleep.
- NyAnime is now implemented to work seamlessly with AnimeKAI:
- AnimeKAI has no rate limits or auth restrictions for public API
- Requests fail fast if AnimeKAI is unavailable (no long timeouts)
- Recommended: Use Render paid tier for stable streaming
- ✅ Use HTTPS for all API calls and frontend (handled by Render/Vercel)
- ✅ Deploy on Render Web Service or Vercel (not static site)
- ✅ Set
NODE_ENV=productionandVITE_USE_DIRECT_API=false - ✅ No external backend needed — all APIs public
- ✅ Jikan API provides primary metadata (search, info, episodes)
- ✅ AnimeKAI provides streaming sources (M3U8 URLs)
- ✅ On Vercel: Set
RENDER_STREAM_PROXYto your Render service URL (for CDN relay)
nyanime/
├── 📂 src/
│ ├── 📂 components/ # React components
│ │ ├── VideoPlayer # HLS player with skip buttons
│ │ ├── AnimePlayer # Episode management
│ │ └── ui/ # shadcn/ui components
│ ├── 📂 pages/ # Route pages
│ ├── 📂 services/ # API services
│ ├── 📂 hooks/ # Custom React hooks
│ └── 📂 config/ # Firebase & API config
├── 📂 api/ # Serverless functions
├── 📂 public/ # Static assets
├── 📄 server.js # Express server
└── 📄 vite.config.ts # Vite configuration
Contributions are welcome! Here's how you can help:
# 1. Fork the repository
# 2. Create your feature branch
git checkout -b feature/amazing-feature
# 3. Commit your changes
git commit -m "feat: add amazing feature"
# 4. Push to the branch
git push origin feature/amazing-feature
# 5. Open a Pull Request| 🌐 Website | nyanime.qzz.io |
| 🖥️ Terminal Client | NY-CLI |
| 🎬 Allanime Reference (ani-cli) | pystardust/ani-cli |
| 🏗️ Architecture | ARCHITECTURE.md |
This project is licensed under the MIT License.
Use freely. Give credit. Build cool things. 💜
This is an educational project. No video content is hosted on our servers.
All streams are fetched from third-party sources. Use responsibly.
All streams are fetched from third-party sources. Use responsibly.
"In a world full of filler episodes, be the main arc." ✦
Made with 💜 by Anjishnu
⭐ Star this repo if you found it useful!