From 99a517349d0c225320916cc1cc9a2e8e38103564 Mon Sep 17 00:00:00 2001 From: Shawn Shan Date: Tue, 7 Jul 2020 18:36:20 -0500 Subject: [PATCH] Update README.md Former-commit-id: 685dd5610f55b152af9f86d052ca1e77648a3508 [formerly 80066d9c9ace3622966e9ce06e9c0c646a28b415] Former-commit-id: 98514acd48dae5a7a4d3d61a7f266788acd14eed --- fawkes/README.md | 36 ++++++++++++++++-------------------- 1 file changed, 16 insertions(+), 20 deletions(-) diff --git a/fawkes/README.md b/fawkes/README.md index f06d62b..6c1327e 100644 --- a/fawkes/README.md +++ b/fawkes/README.md @@ -1,26 +1,22 @@ -# Fawkes +# 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](http://sandlab.cs.uchicago.edu/fawkes/). -If you are a developer or researcher planning to customize and modify on our existing code. Please refer to [fawkes_dev](https://github.com/Shawn-Shan/fawkes/tree/master/fawkes_dev). +If you are a developer or researcher planning to customize and modify on our existing code. Please refer to [fawkes](https://github.com/Shawn-Shan/fawkes/tree/master/). + +### How to Setup + +#### MAC: + +* Download the binary following this [link](http://sandlab.cs.uchicago.edu/fawkes/files/fawkes_binary.zip) 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](https://support.apple.com/guide/terminal/open-or-quit-terminal-apd5265185d-f365-44cb-8b09-71a064a42125/mac) 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. +* Run `./fawkes -d IMAGE_DIR_PATH -m low` to generate cloak for images in `IMAGE_DIR_PATH`. +* More details on the optional parameters check out the [github repo](https://github.com/Shawn-Shan/fawkes/tree/master/). -# How do I protect my images? +#### PC: +More details coming soon. The steps should be similar to the MAC setup. -TBD - - - - -### Citation -``` -@inproceedings{shan2020fawkes, - title={Fawkes: Protecting Personal Privacy against Unauthorized Deep Learning Models}, - author={Shan, Shawn and Wenger, Emily and Zhang, Jiayun and Li, Huiying and Zheng, Haitao and Zhao, Ben Y}, - booktitle="Proc. of USENIX Security", - year={2020} -} -``` - - -Code implementation of the paper "[Fawkes: Protecting Personal Privacy against Unauthorized Deep Learning Models](https://arxiv.org/pdf/2002.08327.pdf)", at *USENIX Security 2020*.