Ever wonder what's currently in theaters?
While Google, Rotten Tomatoes, and IMDb provide movie information, they can sometimes be cumbersome and overwhelming when you need quick, concise details to make an informed decision.
ShowTime+ is a streamlined platform designed for users who want just enough information about movies currently in theaters, all in one place. Our goal is to offer an experience that is both informative and easy to navigate, helping you make an informed decision without the clutter.
The platform features a list of popular movies, and users can click on each movie to view more details.
To run the ShowTime+ project locally, follow these steps:
Clone the repository:
git clone [repository-url]
cd django-showtime-plus
Create an account on The Movie Database (TMDB) and request an API key.
Set up environment variables:
At the root of the directory, create a .env
file with the following configurations:
DEBUG=TRUE
ALLOWED_HOSTS=localhost,127.0.0.1
SECRET_KEY=<your-secret-key> # Optionally create one using: python -c 'from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())'
TMDB_API_KEY=<your-tmdb-api-key>
(Optional) Create a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
Install dependencies:
pip install piptools
pip-sync requirements/requirements.txt requirements/dev/requirements-dev.txt
Run the development server:
python manage.py runserver
You should now be able to access the application at http://localhost:8000
.
At the root of the directory, ensure you have your .env file. Optionally, you can use the .env-template
file to fill out the required variables and renamed it to .env
.
In your .env file, toggle DEBUG=false
.
To run the project, execute:
docker compose up
optionally, if you wish to rebuild from scratch (without any caching)
docker compose up --build
The Dockerfile is designed to be used with Docker compose and will pull environment variable info from .env.
localhost
on port 80.