Film box 0.1.0

.gitignore

@@ -1 +1 @@
-ignore/
+/venv

README.md

@@ -1,9 +1,91 @@
 # FilmLabs
 
-Local hosted streaming site.
+This repository does not store any media files it uses streaming apis to stream movies/tv shows.
 
-This repository does not store any film files it uses streaming apis to stream movies/tv shows.
+# Features
 
-You can create accounts to store watch history, you can search for movies, tv shows and anime.
+* Local hosted streaming site.
+* Create/Login accounts.
+* Account favoriting for Movies/TV Shows.
+* Account Watch history for Movies/TV Shows.
+* Account Settings.
+* Home page showing popular, trending, new, etc Movies/TV Shows.
+* Search for Movies/TV Shows.
+* Watch Movies/TV Shows.
 
-The database uses mysql.
+# Technical Features
+* MYSQL Database.
+* Python Flask Server.
+* TMDB Api.
+
+# FilmLabs Installation Intructions
+
+## WINDOWS
+
+## LINUX
+
+### Downloading Files
+Clone/download the repository by running `git clone -b film-labs https://github.com/Monnapse/FilmLabs.git`.
+
+Now go into directory by running `cd FilmLabs/`.
+
+### Create Virtual Environemnt (Optional)
+If you want to use a virtual environment then you want to first run `python3 -m venv filmlabs-environment` 
+(if you dont have the venv package install by running `apt install python3-venv`)
+
+Activate the virtual environemnt by running `source filmlabs-environment/bin/activate`.
+
+### Install required packages
+Now install required packages by running `pip install -r requirements.txt`.
+
+### Install mysql
+Now install the mysql server by running `sudo apt install mysql-server`. Now you need to secure mysql server by 
+running `sudo mysql_secure_installation` it will ask some questions, for the first question say `y` 
+then password security level question just say `2` for highest security,
+and then all the rest of the questions just say `y` to all of them.
+
+### Create mysql password
+Now enter mysql by running `sudo mysql -u root` 
+add this line and enter a password in `ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_new_password';` replace `'your_new_password'` with your password then press enter, once you have done that add this line `FLUSH PRIVILEGES;`
+
+### Create database
+Now create the database by adding `source mysql/forward_engineer.sql` to the next line. Exit by entering `exit`.
+
+### Creating environment variables
+Now create your environment variables by running `sudo nano /etc/environment`
+next in that file add the following on different lines:
+
+1. `FILMLABS_DB="filmlabs"` (this is the name of the database)
+
+2. `FILMLABS_JWT_KEY="df6^Dju-3Ffsf__d9pFDfSh#7#$)448*#4v$Jf-#HQHjf9hdf-FH(#r#"lrjfx-dSGsDJ4td)"` (This variable is your secret key creating your tokens so you can change it to whatever you want but its best to make it long and randomized so no hacker can get it)
+
+3. `MYSQL_PASSWORD="mysql password"` (Change mysql passsword with your password you created for your mysql root)
+
+4. `MYSQL_USER="root"` (This is your mysql user that is being logged into just keep it the same)
+
+5. `TMDB_API_KEY="your tmdb api key"` (Put in your TMDB api key here, you can get an api key from this [link](https://developer.themoviedb.org/docs/getting-started))
+
+Now save the file by doing `ctrl+o` then press `enter` now exit the file by doing `ctrl+x`.
+
+Now restart, so the changes to take effect by running `sudo reboot`.
+
+Once restarted go to your the FilmLabs folder (`cd FilmLabs/`) 
+(and if you set up a virtual environment you need to activate it by running  `source filmlabs-environment/bin/activate`) 
+now run your server by running `python3 main.py`,  it should print out alot of stuff but what you are looking for is a list of ip adresses like this
+```
+* Running on all addresses (0.0.0.0)
+* Running on http://127.0.0.1:2400  
+* Running on http://10.0.0.52:2400
+```
+`http://127.0.0.1:2400` will only allow access on your local machine. The last one `http://10.0.0.52:2400` allows access to the site on your network.
+
+Now enjoy.
+
+## Update files
+if you want to update the files to latest release you do, pull latest changes `git pull origin film-labs`.
+
+# Modifying Home Page Categories
+Open `home_page.json`
+
+# Adding/Removing Streaming Apis
+Open `services.json`

home_page.json

@@ -0,0 +1,100 @@
+{
+    "pages": [
+        {
+            "current_page": 1,
+
+            "categories": [
+                {
+                    "name": "My watch history",
+                    "media_type": null,
+                    "list_type": "watch_history",
+                    "time_window": null
+                },
+                {
+                    "name": "My favorites",
+                    "media_type": null,
+                    "list_type": "favorites",
+                    "time_window": null
+                },
+                {
+                    "name": "Trending today",
+                    "media_type": null,
+                    "list_type": "trending",
+                    "time_window": "day"
+                }
+            ]
+        },
+        {
+            "current_page": 2,
+
+            "categories": [
+                {
+                    "name": "Trending this week",
+                    "media_type": null,
+                    "list_type": "trending",
+                    "time_window": "week"
+                },
+                {
+                    "name": "Popular movies",
+                    "media_type": "movie",
+                    "list_type": "popular",
+                    "time_window": null
+                },
+                {
+                    "name": "Now playing movies",
+                    "media_type": "movie",
+                    "list_type": "now_playing",
+                    "time_window": null
+                }
+            ]
+        },
+        {
+            "current_page": 3,
+
+            "categories": [
+                {
+                    "name": "Top rated tv series",
+                    "media_type": "tv",
+                    "list_type": "top_rated",
+                    "time_window": null
+                },
+                {
+                    "name": "Top rated movies",
+                    "media_type": "movie",
+                    "list_type": "popular",
+                    "time_window": null
+                },
+                {
+                    "name": "Popular tv series",
+                    "media_type": "tv",
+                    "list_type": "popular",
+                    "time_window": null
+                }
+            ]
+        },
+        {
+            "current_page": 4,
+
+            "categories": [
+                {
+                    "name": "Airing today tv series",
+                    "media_type": "tv",
+                    "list_type": "airing_today",
+                    "time_window": null
+                },
+                {
+                    "name": "On the air tv series",
+                    "media_type": "tv",
+                    "list_type": "on_the_air",
+                    "time_window": null
+                },
+                {
+                    "name": "Upcoming movies",
+                    "media_type": "movie",
+                    "list_type": "upcoming",
+                    "time_window": null
+                }
+            ]
+        }
+    ]
+}

main.py

@@ -0,0 +1,101 @@
+"""
+
+    Film Box Server
+    Made by Monnapse
+
+    Created 11/6/2024
+    Last Updated 11/6/2024
+
+    0.1.0
+
+"""
+
+from flask import Flask, request
+#from flask_session import Session
+from datetime import timedelta
+from os import environ
+from flask_limiter import Limiter
+from flask_limiter.util import get_remote_address
+from flask_jwt_extended import JWTManager
+import json
+
+import server.web as web
+from server.packages import db, films, tmdb, json_controller, service
+from server.packages.tmdb import FilmType, TVListType, MovieListType, TimeWindow, TMDB, ListResult
+
+# Settings
+token_max_days = 7
+
+password_min_length = 8
+password_max_length = 20
+
+username_min_length = 3
+username_max_length = 20
+
+# w9, w154, w185, w342, w500, w780, original
+poster_sizing = "w185" # Smaller = more optimized = faster loading
+
+# Define the flask app
+app = Flask(__name__)
+limiter = Limiter(app, key_func=get_remote_address)
+
+#app.config["SESSION_PERMANENT"] = False
+#app.config["SESSION_TYPE"] = "filesystem"
+#app.config['PERMANENT_SESSION_LIFETIME'] = timedelta(minutes=session_days)
+app.config['JWT_SECRET_KEY'] = environ.get("FILMLABS_JWT_KEY")
+app.config['JWT_ACCESS_TOKEN_EXPIRES'] = timedelta(days=token_max_days)
+
+#Session(app)
+jwt = JWTManager(app)
+
+api = tmdb.TMDB(
+    environ.get("TMDB_API_KEY"), 
+    poster_sizing
+)
+service_controller = service.ServiceController(
+    json_controller.load_json("services.json")
+)
+
+#print(service_controller.get_services()[0].get_tv_url("693134", 1, 1))
+
+#print(film_controller.get_next_categories(2))
+
+db_controller = db.FilmLabsDB(
+    password_max_length, 
+    password_min_length,
+    username_min_length,
+    username_max_length
+)
+film_controller = films.FilmsController(
+    api,
+    db_controller,
+    json_controller.load_json("home_page.json")
+)
+web_controller = web.WebClass(
+    app, 
+    limiter,
+    db_controller,
+    jwt,
+    film_controller,
+    service_controller,
+    token_max_days,
+    password_max_length, 
+    password_min_length,
+    username_min_length,
+    username_max_length
+)
+if __name__ == '__main__':
+    # Connect to database
+    db_controller.connect(
+        "localhost",
+        environ.get("MYSQL_USER"),
+        environ.get("MYSQL_PASSWORD"),
+        environ.get("FILMLABS_DB")
+    )
+
+    # Now make the web directories
+    # and run the flask app
+    web_controller.run_directories()
+
+    # Run flask app
+    app.run(debug=False, port="2400", host="0.0.0.0")