This Python-based application uses the TMDb API to provide information about movies. It features a graphical user interface for users to search and view movie details.This application allows users to search for movies and view similar movies based on the selected movie. It is built using the Python tkinter library for the graphical user interface and interacts with the TMDB API for fetching movie data.
app_functions.py
: ContainsMovieFunctions
for TMDb API interactions.Key.py
: Holds the TMDb API key.main.py
: Main application script, establishes the GUI.LICENSE
: MIT License documentation..gitignore
: Specifies files for Git to ignore.
- Ensure Python is installed on your system.
- Clone the repository:
git clone https://github.com/MeliZiba/LBL---LessBoringLife---A-movie-recommender
- Install required packages:
pip install -r requirements.txt
- Insert your TMDb API key in
Key.py
. To have a TMDB API, you need to go to https://www.themoviedb.org/signup, and create an account. and from https://www.themoviedb.org/settings/api get your API key. Enter your API key inKey.py
.
-
Execute
main.py
to launch the application. -
Use the GUI for searching movies. Results are based on TMDb API data. -
-
Enter the name of the desired movie.
-
Erro handling for invalid entry or no results:
-
From the result page, choose the intended movie, and press show similar button to see a list of similar movies.
-
A list of movies similar to the choosen one will be shown:
-
Use Add to Playlist button to add the movie to your playlist.
-
On the right side of the app, the "Your Playlist" section will include the movies that are added to playlist:
-
Filter the result range by entering the deisred year range.
-
If one or both entries are blank or not numerical a message box will pop up to show the error:
- Fork the repo and create a new feature or bug-fix branch.
- Follow clean code practices with comments.
- Test the application thoroughly.
- Make a pull request with a detailed description of changes.
This project is under the MIT License. See LICENSE
file for more details.