From e44cb646ff7a4a2512c79cdea5936439097357ac Mon Sep 17 00:00:00 2001 From: Shawn Shan Date: Tue, 7 Jul 2020 17:59:31 -0500 Subject: [PATCH 1/5] Update README.md Former-commit-id: dcd4fc63fe48676f4312fa3a9702ab934d0e268c [formerly 72337c5fdc6132a9b8522969720ab9ecb2ebba28] Former-commit-id: 25d5795192b8fb499d3bc510c89a3660899b59e6 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 14729ef..41acfd5 100644 --- a/README.md +++ b/README.md @@ -29,9 +29,9 @@ when --mode is `custom`: * `--feature-extractor` : name of the feature extractor to use * `--separate_target` : whether select separate targets for each faces in the diectory. +### Example - - +`fawkes -d ./imgs --mode mid` ### Tips From 99a517349d0c225320916cc1cc9a2e8e38103564 Mon Sep 17 00:00:00 2001 From: Shawn Shan Date: Tue, 7 Jul 2020 18:36:20 -0500 Subject: [PATCH 2/5] 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*. From 2d1d37bd2ea244f4c33161596db9f425bf39b35a Mon Sep 17 00:00:00 2001 From: Shawn Shan Date: Tue, 7 Jul 2020 18:36:35 -0500 Subject: [PATCH 3/5] Update README.md Former-commit-id: 9a6b2168e3a53d7e198503ba97c466b8b49ea8cd [formerly fb8e2d781bf4b31e264cac69be268b238a089f38] Former-commit-id: 48286955c0445dbfbd95d841cadd6fc363cf7ad4 --- fawkes/README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/fawkes/README.md b/fawkes/README.md index 6c1327e..b69f649 100644 --- a/fawkes/README.md +++ b/fawkes/README.md @@ -9,7 +9,6 @@ If you are a developer or researcher planning to customize and modify on our exi #### 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. From 30a11f952af8efa16aced333242a49834073bbe0 Mon Sep 17 00:00:00 2001 From: Shawn Shan Date: Tue, 7 Jul 2020 18:37:41 -0500 Subject: [PATCH 4/5] Update README.md Former-commit-id: 2c33f9383650bd64a483e3e4c82980938a185ec5 [formerly e192cdc7818a73572fd18e60bebcefe12a0f81be] Former-commit-id: 720251993a1350f2ec214eeb2d0af93248d342f6 --- fawkes/README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/fawkes/README.md b/fawkes/README.md index b69f649..126c644 100644 --- a/fawkes/README.md +++ b/fawkes/README.md @@ -13,6 +13,7 @@ If you are a developer or researcher planning to customize and modify on our exi * 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`. +* 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](https://github.com/Shawn-Shan/fawkes/tree/master/). From cc5da1b31e78c2f61b4cf206f20f4e7fe9f2d121 Mon Sep 17 00:00:00 2001 From: Shawn Shan Date: Tue, 7 Jul 2020 18:38:21 -0500 Subject: [PATCH 5/5] Update README.md Former-commit-id: ad29a4afb784a8bb124d77f64b8796967340774b [formerly 2cfb092d8c0a8794c3ac95d337703b925d370829] Former-commit-id: 10c625d91cf6c2538f69e018742b31774982a283 --- fawkes/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fawkes/README.md b/fawkes/README.md index 126c644..bdf7531 100644 --- a/fawkes/README.md +++ b/fawkes/README.md @@ -11,7 +11,7 @@ If you are a developer or researcher planning to customize and modify on our exi * 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. +* (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](https://github.com/Shawn-Shan/fawkes/tree/master/).