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 😎.

• 💻 Where Is It Streaming 🎥
  • Table of Content 📘
  • Features ✨ 😎
  • Demo and Screenshots 📷 📹
  • Usage 🎮
    • Cloning and Virtual Environment
    • Generating Movies Database
    • Running the Web App
  • Tools 👓
  • Current Web App Hierarchy 💪
  • Future Plans 🔜
  • Contributing 🔥
  • Collaborators & Contributors 🕺 💃
  • Inspiration 📓
  • License 📚

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

Where Is It Streaming	Where Is It Streaming

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.

• 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

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.

• Run the Web App using python3 app.py
• Visit http://127.0.0.1:5000/

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
    • JustWatch
  • SQLite3
• SQLite
  • SQL
  • CSV Dataset
• HTML & CSS
  • Bootstrap Framework

• 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...

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

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 👍

_{Ahmad M. Osman}

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.

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