Cinema Scope

Cinema Scope is a Flutter app that uses the TMDB API to provide movie and TV listings. Users can search for movies and TV shows based on genre, keywords, region, release date, watch providers, voting, and much more. The app provides detailed information on each title, including trailers, images, overviews, ratings, release dates, genres, cast and crew, recommendations, keywords, runtime, more titles by the director/creator, more titles by the leading actors, similar titles, and much more. The person detail page provides images, personal details, filmography, alternative names, and useful filters to short-list the filmography. The search screen provides multi-search and infinite scrolling support.

Features

• Browse movie and TV listings by various filters
• Search movies and TV shows using multi-search and infinite scrolling
• Get detailed information about each title, including trailers, images, overviews, ratings, release dates, genres, cast and crew, recommendations, keywords, runtime, more titles by the director/creator, more titles by the leading actors, similar titles, and much more
• Explore a person's filmography, including images, personal details, alternative names, and useful filters

Technical Features

• Developed using Flutter framework and Dart language
• Uses the TMDB API for data
• Provides search and filter functionality for the movie and TV listings
• Displays trailers, images, and other information on the movie and TV detail pages
• Shows filmography, images, personal details, and alternative names on the person detail page
• Implements multi-search and infinite scrolling functionality on the search page

Screenshots

Packages used

Some of the Flutter packages that have been used in this project are:

• provider - for State management
• infinite_scroll_pagination - for infinite scrolling of paginated results
• youtube_player_flutter - for playing Youtube trailers
• photo_view - for zooming and panning of images
• sliver_tools - for expanding on the usage of Slivers
• retrofit - for pulling TMDB API data
• card_swiper - for auto-play and loop features of PageView

How to Use

To use Cinema Scope, you must first create a TMDB API key by signing up at TMDB. Once you have a key, head into your account page, under the API section, you will see a new token listed called API Read Access Token. Replace the value of the `accessToken` constant in the `lib/tmdb_api.dart` file with your API Read Access Token. Then, simply run the app on your emulator or device to start browsing movies and TV shows.

How to Run the App

1. Clone the repository to your local machine.
2. Open the project in your preferred IDE.
3. Run the app on your preferred emulator or physical device.

How to Contribute

1. Fork the repository.
2. Clone the forked repository to your local machine.
3. Create a new branch for your feature or bug fix.
4. Make your changes and commit them.
5. Push your changes to your forked repository.
6. Create a pull request to the original repository.

Contributing

Cinema Scope is open source and contributions are always welcome! If you find a bug or want to add a feature, simply create a new issue on the Github repository or fork the project and submit a pull request.

License

Cinema Scope is licensed under the MIT License. See the LICENSE file for more information.