Skip to content
💻 Streaming Services Finder and Movies DB Explorer Web App 🎥
Python HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
img/readme
static
templates
.gitignore
LICENSE
README.md
app.py
db.py
query.py
requirements.txt

README.md

💻 Where Is It Streaming 🎥

Where Is It Streaming is the web app that your entertainment has been waiting for. This web app helps you in exploring a wide variety of movies and in finding streaming services, renters, and sellers of your favorite movies. In addition to that, Where Is It Streaming randomly generates twenty movies every time you visit – or refresh – the main page for the convenience of simplifying the struggles of finding a movie to watch 😎.

Table of Content 📘

Features 😎

Currently, Where Is It Streaming supports the following:

  • Registration System
    • Username as Primary Key - No Duplicates
    • Email Regex Validation
    • Hashed Passwords (8 to 80 Characters in Length)
  • Login
    • Validation System
    • Users' Sessions
  • Searching for Movies
  • Movies' Genre, Ratings, Summary, and Casting Preview
  • Streaming Services, Sellers, and Renters Locator
  • Randomly Generated Movies on Main Page
  • Logout

📷 Demo and Screenshots 📹

Where Is It Streaming Where Is It Streaming
Landing Page Register
Invalid Register Paths
Mainpage Searching

Movie

Demo

Usage 🎮

This web app is written in Python 3 using Flask Web Framework. Frontend uses Bootstrap Framework. Sqlite DB is used - you will need, as instructed below, to build a database from The Movies Dataset.

Cloning and Virtual Environment

  • git clone https://github.com/Ahmad-Magdy-Osman/WhereIsItStreaming.git
  • cd WhereIsItStreaming
  • python3 -m venv venv
  • source venv/bin/active
  • pip3 install -r requirements.txt

Generating Movies Database

This step is essential before running the web app.

  • Download The Movies Dataset and unzip it.
  • mkdir data
  • Move CSV files to the 'data' sub-directory.
  • Run python3 db.py. Should take a minute or two.

Running the Web App

Tools 👓

Programming Languages, Frameworks, Libraries, APIs, Databases, and Data Formats.

  • Python 3
    • Flask
      • Flask-WTF
      • Flask-User
      • Flask-Images
      • Flask-Bootstrap
      • Flask-StormPath
      • Flask-SqlAlchemy
    • APIs
    • SQLite3
  • SQLite
    • SQL
    • CSV Dataset
  • HTML & CSS
    • Bootstrap Framework

Current Web App Hierarchy 💪

  • Web Pages
    • Landing Page
      • Pre-login
    • Register
    • Login
    • Main Page
      • Randomly Generated Movies
    • Search
    • Movie Page
    • Logout
      • Leads to Landing Page
  • Database Tables
    • Movies - Cast - Crew - Ratings - Users
    • Relationships
      • Many to Many: Movies to Cast
      • Many to Many: Movies to Crew
      • One to Many: Ratings
  • More to come...

Future Plans 🔜

Some of the features that would be appropriate for Where Is It Streaming. Please feel free to pick any of them and start working on improving it as a contributor.

  • General
    • Mobile Responsiveness
    • Project Structure and Cleaning
  • Features
    • Mark Movies as Watched or To-Watch
    • Like and Unlike Movies
      • Helps with Recommendation System
    • Account Retrieval via Email
  • Views
    • View Search History
    • View Liked and Unliked Movies
    • View Watched and To-Watch Movies
  • Movie Recommendation System
    • Based on Liked/Unliked Movies
  • Content
    • Better Dataset with up-to-date Movies and TV Shows
  • Marketing
    • SEO
    • Share on Social Media button
  • Style/Design
    • Fonts
    • Footer
    • Movies Images
  • Read Me
    • Add Collaborates and Contributors

Contributing 🔥

  1. 🍝 Fork this repo!
  2. Clone and cd into it
  3. Setup your virtual environment.
  4. Create your feature branch: git checkout -b my-new-feature
  5. Commit your changes: git commit -m 'Add some feature'
  6. Push to the branch: git push origin my-new-feature
  7. Submit a pull request 👍

🕺 Collaborators & Contributors 💃


Ahmad M. Osman

Inspiration 📓

You will fail.

You will mess up.

You'll do poorly on assignments and tests.

Your side projects will not work.

Your code will be sloppy and incomplete.

You will bomb job interviews.

Your PR's will be rejected.

And because you fail, you will succeed.

Don't be afraid to fail, don't let it destroy your self-confidence, don't let it define you. Instead, do everything you can to learn from that failure and take that new knowledge into the next piece of work.

Indeed, failure is the only path to success.

    ― Stranger on the Internet.

License 📚

Where Is It Streaming is an open source project under MIT license.

You can’t perform that action at this time.