https://github.com/evanwieland/shady
😎 Little OpenCV program written in C++ that augments glasses onto a persons face.
https://github.com/evanwieland/shady
augmented-reality computer-vision cpp opencv
Last synced: about 2 months ago
JSON representation
😎 Little OpenCV program written in C++ that augments glasses onto a persons face.
- Host: GitHub
- URL: https://github.com/evanwieland/shady
- Owner: EvanWieland
- Created: 2021-11-13T21:52:50.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-11-15T20:37:49.000Z (over 4 years ago)
- Last Synced: 2025-01-21T17:14:19.358Z (over 1 year ago)
- Topics: augmented-reality, computer-vision, cpp, opencv
- Language: C++
- Homepage:
- Size: 35.7 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
😎 Shady
Little OpenCV program written in C++ that augments glasses onto a persons face.
❗ The following instructions are for Ubuntu 20.04. A similiar process will work for other platforms. ❗
## Requirements
### CMake
```console
$ sudo snap install cmake --classic
```
### OpenCV
```console
$ sudo apt update
$ sudo apt install libopencv-dev python3-opencv
```
## Running
### Build from source and run
Install requirements mentioned above
```console
$ sudo apt install build-essential # If no compiler already installed
$ git clone https://github.com/EvanWieland/Shady.git
$ cd /path/to/shady/project
$ mkdir cmake-build-release && cd cmake-build-release && cmake ../
$ cmake --build .
$ ./shady
```
### Run pre-compiled release
Install requirements mentioned above
Download [Release v1.0.0](https://github.com/EvanWieland/Shady/releases/download/1.0.0/1.0.0.zip)
```console
# Decompress the downloaded release zip file
$ cd /path/to/shady/release/filese
$ ./shady
```
### Usage
The Shady program will launch a window showing a stream from your machine's webcam. It will scan for faces and augment readers and sunglasses onto faces that are found.
Press the `ENTER` key to swap between reading glasses and sunglasses.
Press and hold the `ESC` key to terminate the program.
### Credits
[This post](https://learnopencv.com/facemark-facial-landmark-detection-using-opencv/) by LearnOpenCV helped get me up to speed for this project.