This is a toy project for learning how to use a couple of python libraries.
Repo status
This repo is unmaintained. I guess I never intended for others to use this (and never imagined my terrible code would be of any value to others), but I recognize that a nonzero number of people have stumbled upon this repo and may have found it useful as a reference. Given that, even though I do not plan on maintaining this repo, I am happy for people to
- submit pull requests to fix known issues (there are quite a few), or to
- fork and make your own version. I'd be happy to link to a better maintained fork for future readers' benefit.
What it does
- The web client sends video stream data (from the user's webcam) to a flask server using socketio
- The server does some processing on the video stream
- The client receives the processed video stream and re-displays the results in a different frame
In the demo site, the server is simply flipping the image horizontally. You could imagine it doing something more sophisticated (e.g. applying some filters), but obviously I was too lazy to implement anything cool.
Known issues
- The server does not handle multiple clients well. If multiple clients connect, the server treats them as one and sends back mixed frames as a result.
Demo
Setup
Optional
- setup heroku (
brew install heroku) - Use a python virtualenv
Required
git clone https://github.com/dxue2012/python-webcam-flask.gitpip install -r requirements.txt
Run locally
IF YOU HAVE HEROKU:
-
heroku localIF NOT: -
gunicorn -k eventlet -w 1 app:app --log-file=- -
in your browser, navigate to localhost:5000
Deploy to heroku
git push heroku master- heroku open
Common Issues
If you run into a 'protocol not found' error, see if this stackoverflow answer helps.