Skip to content

Latest commit

 

History

History
210 lines (168 loc) · 5.41 KB

README.md

File metadata and controls

210 lines (168 loc) · 5.41 KB

MovieDex - Open Source Movie Streaming App

MovieDex

MovieDex is a Flutter-based movie and TV show streaming application that provides a beautiful user interface and rich features for streaming enthusiasts.

Features

  • 🎬 Movie & TV Show Streaming
  • 🔍 Advanced Search
  • 📱 Responsive Design
  • 🌙 Dark/AMOLED Theme
  • 📋 Watchlist Management
  • 🔐 User Authentication
  • 🔄 Cloud Sync
  • 📺 Multiple Video Quality
  • 🌐 Proxy Support

Screenshots

Setup Instructions

Prerequisites

  • Flutter SDK (3.0 or higher)
  • Dart SDK
  • Android Studio / VS Code
  • Git

Installation Steps

  1. Clone the repository:
git clone /~https://github.com/kodify-js/MovieDex.git
cd MovieDex
  1. Install dependencies:
flutter pub get
  1. Setup TMDB API:
    • Sign up at TMDB
    • Get your API key from API Settings
    • Create lib/api/secrets.dart:
const String apiKey = 'YOUR_TMDB_API_KEY';
  1. Firebase Setup:
    • Create a new Firebase project
    • Enable Authentication and Realtime Database
    • Download google-services.json and place in android/app/
    • Add Firebase configuration to your project:
flutter pub add firebase_core
flutter pub add firebase_auth
flutter pub add firebase_database
  1. Generate Hive Adapters:
flutter pub run build_runner build
  1. Run the app:
flutter run

Configuration

Firebase Setup Details

  1. Go to Firebase Console
  2. Create a new project
  3. Add Android app:
    • Package name: com.kodify.moviedex
    • Download google-services.json
  4. Enable Authentication:
    • Go to Authentication > Sign-in method
    • Enable Email/Password
  5. Setup Realtime Database:
    • Create database in test mode
    • Set up rules for user data

TMDB API Setup

  1. Create account on TMDB
  2. Request an API key
  3. Create secrets.dart:
const String apiKey = 'YOUR_API_KEY';

Contributing

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

  • TMDB for providing the movie database
  • Flutter for the amazing framework
  • Firebase for backend services

Support

If you find this project helpful, please give it a ⭐️!

For help getting started with Flutter development, view the online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.

Contributors

Core Team

  • KodifyJs - Project Lead
    • Core architecture
    • Video player implementation
    • Content providers

Contributors

Project Structure

Key features and their locations:

lib/
├── api/              # API and data layer
├── components/       # Reusable UI components
├── pages/           # Application screens
├── providers/       # State management
├── services/        # Business logic
└── utils/          # Helper functions

Key Files

  • lib/api/contentproviders/ - Streaming source implementations
  • lib/components/content_player.dart - Video player component
  • lib/services/watch_history_service.dart - History tracking
  • lib/services/firebase_service.dart - Authentication
  • lib/services/cache_service.dart - Local caching

See CONTRIBUTING.md for detailed project structure and contribution guidelines.

DMCA disclaimer

The developers of this application do not have any affiliation with the content available in the app. It collects content from sources that are freely available through any web browser.