This app helps visually impaired person connect with their loved ones emotionally.
As a visually acute person, we take being able to know the emotion of our friends/family members emotions with their facial expressions for granted. This is not the case for visually impaired person. They have to guess others emotion by hearing, which can't be always known. This application helps them to remove that barrier.
This app is ease to access with big area (Cam Feed), where they can tap to know the emotion. Output is in form of audio or vibrator of device.
-
Download this repo:
git clone https://github.com/SurajValluru/EmoVision.git
-
Navigatie to directory:
cd EmoVision
-
Run
pip install -r requirements.txt
This app was tested on Windows and Ubuntu WSL. Linux docker containers are not supported.
Navigate to EmoVision directory
Run python app.py
or flask run
The website will be up and running at localhost:5000
by default.
To mention local ip address and port run flask run --host=0.0.0.0 --port=80
Required to be online to load complete page.
ngrok can be used to expose localhost, globally.
I provided ngrok for windows in extras folder.
-
Navigate to extras directory:
cd extras
-
Create a ngrok account, run below command with received authtoken. This command should be run for the very first time only.
./ngrok config add-authtoken <token>
- Run
./ngrok http 5000
command to exposelocalhost:5000
server port 5000 to internet.
-
Use above generated link to open locally hosted website on any device with internet.
-
Once you cancel ngrok service and start again, new link is generated.
Make sure that your surrounding is well-lit.
Tap on video to know the current emotion. Change output modes with bottom buttons.
By default, camera is set to rear camera.
Configurations:
- Custom vibration patterns
- Languages
- Camera
Compatible on Chromium based browsers like Google Chrome, Microsoft Edge, Brave.
Vibration feature is compatible only to Android versions of above browsers.
Thats the reason why few features are deprecated in desktop version.
Using mobile mode in desktop redirects to desktop version.
If opened in desktop inspection mode as a mobile, app doesn't give correct emotion results.