Skip to content
 
 

Repository files navigation

🎬 MovieLens - Your Personal Movie Companion

MovieLens Logo

Discover • Track • Get Personalized Recommendations

Kotlin Android Firebase Jetpack Compose

A smart movie tracking and recommendation app built with modern Android development practices

🌟 About MovieLens

MovieLens is a comprehensive Android application that helps movie enthusiasts discover, track, and get personalized movie recommendations. With intelligent AI-powered suggestions and seamless user experience, it's your ultimate movie companion.

🎯 What Makes MovieLens Special?

  • 🤖 AI-Powered Recommendations: Get personalized movie suggestions based on your watch history and preferences
  • 📊 Smart Tracking: Keep track of watched movies and maintain a watchlist
  • 🎭 Multi-Source Data: Powered by TMDB (The Movie Database) with 500,000+ movies
  • 👤 Social Features: User profiles, ratings, and personalized stats
  • 💬 AI Assistant: Built-in chatbot for instant movie recommendations

📱 Features

🏠 Home Screen

  • Personalized movie recommendations based on your taste
  • New releases and upcoming movies
  • Your watch history with quick access
  • Trending movies from TMDB

🔥 Trending

  • Discover popular movies across different genres
  • Real-time data from TMDB API
  • Filter by popularity, rating, and release date

🎬 My Movies

  • Watchlist: Movies you plan to watch
  • Watched: Your viewing history
  • Smart Stats: Track your movie consumption
  • Easy add/remove functionality

🤖 AI Assistant

  • Chat-based movie recommendations
  • "Movies like [favorite movie]" queries
  • Genre and mood-based suggestions
  • Integration with Chatbase AI

👤 Profile

  • User authentication with Firebase
  • "Remember Me" functionality
  • Movie statistics and personal data
  • Secure logout

👥 Contributors

🌟 Project Lead

🎭 Core Features Developed

  • Authentication System with Firebase Auth
  • Movie Recommendation Engine with TMDB integration
  • Personalized User Profiles with watch statistics
  • AI Chatbot Integration for instant recommendations
  • Modern UI/UX with Jetpack Compose

🤝 Contributing

We love contributions! Whether you're fixing bugs, adding new features, or improving documentation, your help is welcome.

How to Contribute

  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request

🎯 Areas Needing Contribution

  • 🧪 Testing: Unit tests, integration tests, UI tests
  • 🎨 UI/UX: Improved animations, dark mode enhancements
  • 🔧 Performance: Optimize image loading, reduce APK size
  • 🌐 Backend: Additional API integrations, caching strategies
  • 📱 Features:
    • Social features (friends, sharing)
    • Offline mode
    • Movie reviews and ratings
    • Advanced filtering options

🐛 Reporting Issues

Found a bug? Have a feature request? Open an issue and we'll look into it!

📈 Future Roadmap

🚀 Upcoming Features

  • Social Integration - Share watchlists with friends
  • Advanced Analytics - Detailed viewing statistics
  • Offline Mode - Watch movies without internet
  • Multi-language Support - Internationalization
  • Widget Support - Home screen widgets
  • TV App - Android TV compatibility

🔄 In Progress

  • Enhanced AI recommendations
  • Improved caching mechanism
  • Performance optimizations

📄 License

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

📞 Support


⭐ Star this repository if you find it helpful!

Made with ❤️ by Manul Sahu and Dushyant

GitHub stars GitHub forks GitHub watchers

About

MovieLens is a comprehensive Android application that helps movie enthusiasts discover, track, and get personalized movie recommendations. With intelligent AI-powered suggestions and seamless user experience, it's your ultimate movie companion.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages