Flask Movies Collection

🎬 Overview

This Flask web application allows users to manage a collection of movies. Users can add, edit, rate, and delete movies within their collection.

🚀 Prerequisites

1. Python 3.x

2. Install required Python packages using:

   python -m pip install -r requirements.txt

   On MacOS, use pip3 instead of pip.

🌐 Data Scraping via APIs

Flask Movies Collection utilizes data scraping through The Movie Database (TMDb) API to provide detailed information about movies. This integration allows users to seamlessly add new movies to their collection by searching and fetching data from TMDb.

🔑 Key Points:

• The Movie Database (TMDb): The project leverages the TMDb API to retrieve information such as movie titles, release years, descriptions, and poster images.

🚨 Important Note:

Ensure compliance with The Movie Database (TMDb) API terms of service while using this feature.

Movie Database API Key

This project uses The Movie Database (TMDb) API to fetch movie information. To run the application, you'll need to obtain your own API key from TMDb by following these steps:

1. Visit TMDb Developer and sign up for a developer account.
2. Once logged in, navigate to your account settings to generate an API key.
3. Copy the generated API key.
4. Create a file named .env in the project root and add the following line: TMDB_API_KEY=your_generated_api_key

Make sure to replace your_generated_api_key with the actual API key you obtained from TMDb.

5. Save the .env file. This file is listed in the project's .gitignore to ensure it's not included in the repository.

Now you're ready to run the application with your own TMDb API key.

🛠️ Getting Started

1. Clone the repository:

   git clone https://github.com/Herc-Ch/movie-website.git

2. Navigate to the project folder:

   cd movie-website

3. Install dependencies:

   python -m pip install -r requirements.txt

4. Run the application:

   python main.py

   The application will start, and you can access it at http://localhost:5000.

🌐 Live Deployment

The live version of this application is accessible at https://my-movies-website.onrender.com/.

🎥 Features

• View a list of movies with ratings and reviews.
• Edit the rating and review of each movie.
• Delete movies from the collection.
• Add new movies by searching The Movie Database (TMDb) API.

📂 Project Structure

1. main.py: The main application file.
2. templates/: HTML templates for rendering pages.
3. static/: Static files such as stylesheets and images.
4. requirements.txt: List of Python packages required for the project.
5. .env: Environment variables configuration file (create this file).

🤝 Contributing

Feel free to contribute to the project by opening issues or submitting pull requests. Follow the GitHub flow when contributing.

📄 License

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

🙌 Acknowledgments

• Flask
• The Movie Database (TMDb) API