AniDex — Anime Streaming & Tracking Platform

Developed by: Shubham Narware

---

Quick Setup (5 Steps)

1. Create & activate virtual environment

python -m venv venv

# Windows:
venv\Scripts\activate

# macOS / Linux:
source venv/bin/activate

2. Install dependencies

pip install -r requirements.txt

3. Run database migrations

python manage.py makemigrations
python manage.py migrate

4. Create a superuser (Admin)

python manage.py createsuperuser

Enter any username/email/password — use these to log into /admin/

5. Start the development server

python manage.py runserver

Open your browser → http://127.0.0.1:8000/

---

Admin Panel

Go to http://127.0.0.1:8000/admin/ and log in with your superuser credentials.

From the admin panel you can:

• Add / edit / delete Anime
• Add Episodes with video URLs or file uploads
• Set anime as Free or Premium
• Mark anime as Trending or Featured
• Manage users and view watchlists/comments

---

Adding Anime (Quick Start)

1. Log into /admin/
2. Click Anime → Add Anime
3. Fill in title, description, genre, mood, rating, year
4. Upload a thumbnail image
5. Check Is Featured to show it on the hero section
6. Check Is Trending to show in Trending section
7. Check Is Premium to lock it behind a subscription
8. Save — then add episodes inline on the same page

---

Project Structure

anidex/
├── anidex/             # Core Django settings & URLs
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── anime/              # Main app — models, views, URLs, admin
│   ├── models.py       # Anime, Episode, WatchHistory, Watchlist, Comment, UserProfile
│   ├── views.py        # All page views
│   ├── urls.py
│   └── admin.py
├── accounts/           # Auth — login, register, upgrade
│   ├── views.py
│   └── urls.py
├── templates/
│   ├── base.html           # Navbar + footer layout
│   ├── anime/
│   │   ├── home.html       # Landing page
│   │   ├── browse.html     # Browse with filters
│   │   ├── detail.html     # Anime detail + episodes
│   │   ├── watch.html      # Video player page
│   │   ├── trending.html
│   │   ├── mood.html       # Mood picker
│   │   ├── watchlist.html
│   │   ├── profile.html
│   │   ├── search.html
│   │   └── premium.html
│   ├── accounts/
│   │   ├── login.html
│   │   ├── register.html
│   │   └── upgrade.html
│   └── includes/
│       └── anime_card.html  # Reusable anime card
├── static/
│   ├── css/style.css        # Full cinematic dark theme
│   └── js/main.js           # Scroll animations, AJAX watchlist
├── media/                   # Uploaded thumbnails & videos
├── requirements.txt
└── manage.py

---

Key Features Implemented

• User registration & login (required to watch)
• Free & Premium anime system
• Video player (embed URL or file upload)
• Smart Continue Watching with progress tracking
• Watchlist (add/remove via AJAX)
• Mood-based recommendation system
• Trending anime by view count
• Random anime picker
• Community comments
• Admin dashboard (Django Admin with full CRUD)
• Fully responsive cinematic dark UI

---

Tech Stack

• Backend: Django 4.2 (Python)
• Frontend: HTML, CSS, JavaScript (no extra frameworks)
• Database: SQLite (dev) — change to PostgreSQL in settings for production
• Media: Django MEDIA files (Pillow for image handling)

---

AniDex © 2024 — Developed by Shubham Narware