Metadata-Version: 2.1
Name: flask-opencv-streamer
Version: 1.2
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
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: cryptography
Requires-Dist: flask
Requires-Dist: opencv-python

# 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 = video_capture.read()

    streamer.update_frame(frame)

    if not streamer.is_streaming:
        streamer.start_streaming()

    cv2.waitKey(30)
```

### 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 = video_capture.read()

    streamer.update_frame(frame)

    if not streamer.is_streaming:
        streamer.start_streaming()

    cv2.waitKey(30)
```

**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")
```


