Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/esimov/facemask
Overlay a mask over a person's face
https://github.com/esimov/facemask
computer-vision face-detection facemask golang mouth-detection pigo pigo-face-detection
Last synced: 3 months ago
JSON representation
Overlay a mask over a person's face
- Host: GitHub
- URL: https://github.com/esimov/facemask
- Owner: esimov
- License: mit
- Created: 2020-04-07T04:10:05.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-01-15T13:04:31.000Z (almost 4 years ago)
- Last Synced: 2024-06-20T03:31:50.120Z (7 months ago)
- Topics: computer-vision, face-detection, facemask, golang, mouth-detection, pigo, pigo-face-detection
- Language: Go
- Homepage:
- Size: 7.42 MB
- Stars: 17
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# facemask
**Facemask** is a simple tool to overlay a medical mask over a person's face. It can be used to modify a profile picture for example to raise awareness about the necessity to protect ourself and others by wearing a medical mask, limiting the pandemic risks of covid-19.
## Install
```bash
$ go get -u -v github.com/esimov/facemask && cd $GOPATH/src/github.com/esimov/facemask
$ go install
```
### Other alternatives
If you don't have Go already installed or don't want to install Go you can get the cross-compiled binaries in the [releases](https://github.com/esimov/facemask/releases) folder.
```bash
$ facemask -h
____ __ ___ ____ _ _ __ ____ __ _
( __)/ _\ / __)( __)( \/ ) / _\ / ___)( / )
) _)/ \( (__ ) _) / \/ \/ \\___ \ ) (
(__) \_/\_/ \___)(____)\_)(_/\_/\_/(____/(__\_)
Face mask generator
Version: 1.0.1
-angle float
0.0 is 0 radians and 1.0 is 2*pi radians
-in string
Source image
-iou float
Intersection over union (IoU) threshold (default 0.2)
-max int
Maximum size of face (default 1000)
-min int
Minimum size of face (default 20)
-out string
Destination image
-scale float
Scale detection window by percentage (default 1.1)
-shift float
Shift detection window by percentage (default 0.1)
```
## Run it
```bash
$ facemask -in -out
```
## Author
* Endre Simo ([@simo_endre](https://twitter.com/simo_endre))
## License
Copyright © 2020 Endre Simo
This software is distributed under the MIT license. See the [LICENSE](https://github.com/esimov/facemask/blob/master/LICENSE) file for the full license text.