mirror of https://github.com/Shawn-Shan/fawkes.git synced 2024-09-20 07:26:37 +05:30

History

Shawn-Shan 93af1c998d Merge branch 'master' of https://github.com/Shawn-Shan/fawkes Former-commit-id: f0c762735c65492816ef3b5dc9cbbb4b8aea28c5 [formerly 8fd01229e0c09d8034705dd6e990ca685c9d9111] Former-commit-id: a29febcba88adb22fe87b68d6eeee431695e961a		2020-07-08 23:10:22 -05:00
..
__pycache__	0.0.6	2020-07-07 11:14:38 -05:00
__init__.py	0.0.6	2020-07-07 11:14:38 -05:00
__main__.py	cli	2020-07-02 12:32:05 -05:00
align_face.py	0.0.6	2020-07-07 11:14:38 -05:00
detect_faces.py	0.0.6	2020-07-07 11:14:38 -05:00
differentiator.py	0.0.6	2020-07-07 11:14:38 -05:00
protection.py	app	2020-07-08 23:10:13 -05:00
README.md	Update README.md	2020-07-07 18:38:21 -05:00
utils.py	0.0.6	2020-07-07 11:14:38 -05:00

README.md

Fawkes Binary

This application is built for individuals to cloak their images before uploading to the Internet. For more information about the project, please refer to our project webpage.

If you are a developer or researcher planning to customize and modify on our existing code. Please refer to fawkes.

How to Setup

MAC:

Download the binary following this link and unzip the download file.
Create a directory and move all the images you wish to protect into that directory. Note the path to that directory (e.g. ~/Desktop/images).
Open terminal and change directory to fawkes (the unzipped folder).
(If your MacOS is Catalina) Run sudo spctl --master-disable to enable running apps from unidentified developer. We are working on a solution to bypass this step.
Run ./fawkes -d IMAGE_DIR_PATH -m low to generate cloak for images in IMAGE_DIR_PATH.
When the cloaked image is generated, it will output a *_low_cloaked.png image in IMAGE_DIR_PATH. The generation takes ~40 seconds per image depending on the hardware.
More details on the optional parameters check out the github repo.

PC:

More details coming soon. The steps should be similar to the MAC setup.