| ---
|
| title: AniCove
|
| emoji: ⛩️
|
| colorFrom: indigo
|
| colorTo: purple
|
| sdk: docker
|
| app_file: run.py
|
| pinned: false
|
| ---
|
| <div align="center">
|
| <img src="api/static/images/logos/logo.png" alt="AniCove Logo" width="200">
|
| <h1>AniCove</h1>
|
| <p><strong>Your Ultimate Ad-Free Anime Streaming Experience</strong></p>
|
|
|
| <p>
|
| <a href="https://yume-animez.vercel.app/home"><strong>⛩️ AniCove</strong></a>
|
| </p>
|
| <p>
|
| <a href="#-key-features">Features</a> •
|
| <a href="#%EF%B8%8F-tech-stack">Tech Stack</a> •
|
| <a href="#-installation">Installation</a> •
|
| <a href="#-contributing">Contributing</a>
|
| </p>
|
| </div>
|
| ---
|
|
|
| ## 📖 Introduction
|
|
|
| **AniCove** is a highly polished, feature-rich anime streaming platform built for fans who want a seamless, ad-free viewing experience. It hooks into AniList and MyAnimeList and utilizes Miruro API to provide a comprehensive anime library wrapped in a gorgeous Glassmorphism user interface.
|
|
|
| Our focus is entirely on usability, speed, and cross-platform consistency.
|
|
|
| ## ✨ Key Features
|
|
|
| - **🚫 Ad-Free Streaming**: Pure entertainment without popups, redirects, or visual clutter.
|
| - **📺 High-Quality Playback**: Fast streaming with multiple server options, subtitle/audio toggles, and quality selectors natively baked into the player.
|
| - **🔄 Two-Way Tracker Sync**: Link **AniList** and **MyAnimeList** accounts! The player will automatically update your viewing progress seamlessly in the background as you watch.
|
| - **💬 Live Comments & Reactions**: Express yourself on episodes using the custom-built nested comment system with integrated GIF support. Drop quick "likes" or "dislikes" on comments and specific episodes.
|
| - **⏯️ Smart Resume**: Intelligent tracking remembers exactly what episode you were on. "Watch Now" will instantly drop you back into the action.
|
| - **🎨 Modern UI/UX**:
|
| - **Glassmorphism Design**: Sleek, immersive dark-themed presentation.
|
| - **Spotlight Carousel**: Discover tracking information, genres, ratings, and studios right from the top page.
|
| - **Cinema Mode**: Distraction-free, immersive video player layout.
|
| - **Fully Responsive**: A premium and consistent experience whether you are on Desktop, Tablet, or Mobile.
|
| - **🔐 Secure Authentication**: Includes full user accounts, password recovery flow via email, Turnstile bot protection, and more.
|
| - **🔎 Advanced Discoverability**: Deep search, category filtering, schedule countdowns, and genre exploration.
|
|
|
| ## 🛠️ Tech Stack
|
|
|
| - **Backend**: Python (Flask, Async/Await)
|
| - **Frontend**: HTML5, CSS3 (Vanilla / Custom Variables), JavaScript
|
| - **Video Player**: Video.js with specialized integrations
|
| - **Database**: MongoDB (User accounts, watch history, caching logic)
|
| - **Data & Streaming APIs**: Miruro Native API, AniList GraphQL, MyAnimeList OAuth API
|
| - **Security**: Cloudflare Turnstile, Bcrypt Password Hashing, Session Versioning
|
|
|
| ## 🚀 Installation & Local Development
|
|
|
| Ready to run AniCove locally? Follow these steps:
|
|
|
| 1. **Clone the Repository**
|
| ```bash
|
| git clone https://github.com/OTAKUWeBer/AniCove
|
| cd AniCove
|
| ```
|
| 2. **Create a Virtual Environment**
|
| ```bash
|
| python -m venv venv
|
| # Windows
|
| venv\Scripts\activate
|
| # macOS/Linux
|
| source venv/bin/activate
|
| ```
|
| 3. **Install Dependencies**
|
| ```bash
|
| pip install -r requirements.txt
|
| ```
|
| 4. **Set Up Environment Variables**
|
| Duplicate `.env.example` and rename it to `.env`. Fill in the required parameters:
|
| ```env
|
| # Core Application Settings
|
| FLASK_KEY="YOUR_RANDOM_SECRET_KEY"
|
| ALLOWED_ORIGINS="http://localhost:5000"
|
| # Cloudflare Turnstile (for Login / Signup protection)
|
| CLOUDFLARE_SECRET="YOUR_CLOUDFLARE_SECRET"
|
| # Database
|
| MONGODB_URI="mongodb+srv://<username>:<password>@<cluster>.mongodb.net/...?"
|
| db="YumeDB"
|
| users_collection="users"
|
| watchlist_collection="watchlist"
|
| comments_collection="comments"
|
| episode_reactions_collection="episode_reactions"
|
| # Scraping / Streaming Endpoints
|
| MIRURO_API_URL="https://api.your-domain.com/"
|
| PROXY_URL="https://proxy.your-domain.com/proxy/"
|
| # Auth Integrations
|
| # (Set up API clients via AniList & MAL developer portals respectively)
|
| ANILIST_CLIENT_ID="YOUR_ANILIST_CLIENT_ID"
|
| ANILIST_CLIENT_SECRET="YOUR_ANILIST_CLIENT_SECRET"
|
| ANILIST_REDIRECT_URI="http://localhost:5000/auth/anilist/callback"
|
| MAL_CLIENT_ID="YOUR_MAL_CLIENT_ID"
|
| MAL_CLIENT_SECRET="YOUR_MAL_CLIENT_SECRET"
|
| MAL_REDIRECT_URI="http://localhost:5000/auth/mal/callback"
|
| # SMTP Settings (for password resets)
|
| GMAIL_USER="your-email@gmail.com"
|
| GMAIL_APP_PASSWORD="your-16-char-app-password"
|
| ```
|
| 5. **Run the Application**
|
| ```bash
|
| python run.py
|
| ```
|
| Access the application right from your browser at `http://localhost:5000`.
|
| > 💡 **For Hugging Face Spaces**: Ensure your Flask app binds to `0.0.0.0` and listens on port `7860` (the default Space port):
|
| > ```python
|
| > if __name__ == "__main__":
|
| > app.run(host="0.0.0.0", port=7860)
|
| > ```
|
|
|
| ## ⚙️ Integrations Setup Notes
|
|
|
| - **Miruro API**: You'll need access to a Miruro-compatible data API instance for anime indexing and m3u8 stream resolution.
|
| - **AniList & MyAnimeList**: Go to their respective Developer Portals, create a new application, and match the OAuth Redirect URIs to your `.env` values.
|
| - **Passwords via Gmail**: You'll need to generate a Google App Password for the application to dispatch secure password reset tokens.
|
|
|
| ## 🤝 Contributing
|
|
|
| We welcome community contributions! Found a bug, or have a UI polish idea? Read our setup to dive in:
|
|
|
| 1. **Fork the Project**
|
| 2. Create your Feature Branch (`git checkout -b feature/CoolNewAddition`)
|
| 3. Commit your Changes (`git commit -m 'feat: Add a new custom player skin'`)
|
| 4. Push to the Branch (`git push origin feature/CoolNewAddition`)
|
| 5. Open a **Pull Request**
|
|
|
| ## 📜 License
|
|
|
| This project is open-source and available under the [MIT License](LICENSE).
|
|
|
| ---
|
|
|
| <div align="center">
|
| <p>Made with ❤️ for the Anime Community</p>
|
| </div> |
