A command-line application for creating and managing your personal movie database. This tool allows you to add movies, view statistics, and generate a beautiful, shareable HTML website from your collection.
- User Management: Create multiple user profiles to keep movie collections separate.
- Add Movies: Easily add movies to your database. The app fetches movie details like year and rating automatically from OMDb API.
- Delete Movies: Remove movies you no longer want in your collection.
- Add Notes: Add personal notes to any movie.
- View Statistics: Get interesting stats about your collection, including:
- Average and median ratings.
- Highest and lowest-rated movies.
- Filtering and Sorting:
- List all movies (sorted alphabetically).
- Sort movies by rating or release year.
- Search for movies by title.
- Filter movies by a range of years and ratings.
- Generate a Website: Create a static HTML website from your movie list, complete with posters, ratings, and notes.
-
Clone the repository:
git clone https://github.com/KarimTalbi/MovieProject.git cd MovieProject -
Create a virtual environment:
python -m venv .venv source .venv/bin/activate # On Windows, use `.venvScriptsactivate`
-
Install the required packages:
pip install -r requirements.txt
-
Set up API Keys: Create a
.envfile in the project's root directory and add your API keys:OMDB_API_KEY="your_omdb_api_key" API_NINJAS_KEY="your_api_ninjas_key"
To run the application, simply execute the main.py script from within the src directory:
python src/main.pyYou will be prompted to either select an existing user or create a new one. From there, a menu will guide you through the available actions.
