Metadata-Version: 2.1
Name: flask-opencv-streamer
Version: 1.0
Summary: A Python package for easily streaming OpenCV footage, even with authentication
Home-page: https://github.com/oitsjustjose/Flask-OpenCV-Streamer
Author: Jose Stovall
Author-email: stovallj1995@gmail.com
License: GNU General Public License 3
Description: # Flask-OpenCV-Streamer
        A Python package for easily streaming OpenCV footage, even with authentication
        
        ## Installation
        
        Install via PyPi using Pip / PipEnv:
        
        `pip install flask_opencv_streamer`
        
        ## Usage
        
        Usage is quite straight forward. After importing, you can create as many streamer objects as you wish. 
        
        
        ## Example Code:
        
        ### Without authentication (no login required to view page)
        
        
        ```python
        from flask_opencv_streamer.streamer import Streamer
        import cv2
        
        port = 3030
        require_login = False
        streamer = Streamer(port, require_login)
        
        # Open video device 0
        video_capture = cv2.VideoCapture(0)
        
        while True:
            _, frame = cap.read()
        
            streamer.update_frame(frame)
        
            if not streamer.is_streaming:
                streamer.start_streaming()
        
            cv2.waitKey(1)
        ```
        
        ### With authentication (A password will be generated for you, expiring every 24 hrs)
        
        ```python
        from flask_opencv_streamer.streamer import Streamer
        import cv2
        
        port = 3030
        require_login = True
        login_file = "logins.txt"
        login_key = "loginkey.txt
        streamer = Streamer(port, require_login, login_file=login_file, login_key=login_key)
        
        # Open video device 0
        video_capture = cv2.VideoCapture(0)
        
        while True:
            _, frame = cap.read()
        
            streamer.update_frame(frame)
        
            if not streamer.is_streaming:
                streamer.start_streaming()
        
            cv2.waitKey(1)
        ```
        
        **If there is no logins file or key found at the path given, it will create one for you**. Logins will be stored in a `.txt` file `logins.txt` but will be **encrypted**. Therefore, unless someone has the key (in this example, `loginkey.txt`) the `logins.txt` file will be able to show logins or passwords. It is very unsafe to keep the login key somewhere publicly accessible; it's suggested you hide it well and do not upload it anywhere.
        
        ### Adding or removing your own logins
        
        Currently, there is no streamlined way to add or remove logins. Fortunately it only needs to be done once per login and can be done very easily:
        
        ```python
        from flask_opencv_streamer.login_mgr import LoginManager
        
        login_file = "logins.txt"
        login_key = "loginkey.txt"
        
        lm = LoginManager(login_file, login_key)
        lm.add_login("user", "hotdog123")
        lm.add_login("admin", "password")
        lm.remove_login("guest")
        ```
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
