annotate Readme.html @ 18:841f711c40bd

Add new dialogs, and make NO the default for dangerous YES answers.
author David Barts <n5jrn@me.com>
date Sat, 11 Apr 2020 15:01:23 -0700
parents 0528030187e9
children 0161374f7a60
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
16
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
1 <!DOCTYPE html>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
2 <html>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
3 <head>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
4 <meta http-equiv="content-type" content="text/html; charset=UTF-8">
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
5 <title>Introducing ExifWasher</title>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
6 <style>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
7 html { font-family: "TeX Gyre Schola", serif; }
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
8 h1, h2, h3, h4, h5, h6 { font-family: "Avenir Next", sans-serif; }
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
9 pre, code, kbd, samp { font-family: "Menlo", monospace; font-size: 85%; }
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
10 </style>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
11 </head>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
12 <body>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
13 <h1>Indroducing ExifWasher</h1>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
14 <h2>Executive Summary</h2>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
15 <p>This program makes it easy to remove metadata from the digital images you
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
16 create.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
17 <h2>What is “Metadata” and Why Would I Want to Remove It?</h2>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
18 <p>You may not realize it, but image files can (and typically do!) contain
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
19 more than just image data. These data can include your camera make, model,
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
20 and serial number; the location where you took the photo; the software you
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
21 used to edit the photo (and what editing steps you did); etc.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
22 <p>One of the most powerful uses of photography is to graphically document
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
23 things that the wealthy and powerful might wish to remain concealed. The
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
24 evils of slavery, child labor, poverty, war, and imperialism have all been
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
25 documented photographically, and such photographs have often proved
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
26 instrumental in helping to motivate social change.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
27 <p>Because of the metadata they contain, digital photographs contain data
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
28 which has been used to determine who took them, and in some cases to exact
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
29 retribution against their photographers. ExifWasher makes it easy to see
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
30 and remove the privacy-compromising metadata in your images.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
31 <p>Even if your images are not of such a sensitive nature, that extra data
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
32 takes up space. It is not uncommon for a 100 KiB image to contain 20 KiB
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
33 of metadata in it; if that image is on a web page, that makes for 20 KiB
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
34 of wasted network usage each time the image is sent.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
35 <h2>What Makes ExifWasher Different from Other Metadata Editors?</h2>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
36 <p>Simply put, it is designed to <em>safely</em> remove <em>unimportant</em>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
37 metadata.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
38 <p>There are plenty of general-purpose image metadata editors out there, and
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
39 these tools can be employed to remove unimportant metadata. The trouble
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
40 is, they are not user-friendly: it is up to you, the user, to know which
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
41 metadata are unimportant, and to delete it.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
42 <p>There can be literally <em>hundreds</em> of bits of metadata in an
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
43 image, and <em>not all are safe to remove</em>. In particular, if you
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
44 accidentally remove color-management metadata, computers that don’t handle
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
45 images without color-management metadata properly (I’m talking about <em>you</em>,
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
46 Apple Computer, Inc.) will display colors that often look all “washed-out”
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
47 or otherwise incorrect.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
48 <p>Likewise, there are already plenty of simple-to-use, user-friendly tools
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
49 out there for cleaning the metadata out of image files, but they
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
50 inevitably delete <em>all</em> metadata, resulting in files that often
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
51 display improperly. Also of concern, many of these “tools” are actually
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
52 online services. If you’re concerned about your privacy, why would you
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
53 trust the images you’re processing to some unknown third party, who may be
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
54 linked somehow to those who might want to retaliate against you.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
55 <p>I wrote this program because I wanted there to be a quick, easy way to
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
56 scrub images before they even left a photographer’s computer and made
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
57 their way onto the Internet, and for that program to leave vital metadata
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
58 alone, so that the resulting images continue to display properly.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
59 <h2>ExifWasher Washes More than Just Exif Metadata</h2>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
60 <p>Exif is the most common type of metadata, but image files commonly
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
61 contain compromising XMP or IPTC data, particularly if they have been
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
62 edited with a tool like Photoshop. ExifWasher will seamlessly deal with
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
63 these kinds of metadata, too. It tries to do as thorough a job as possible
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
64 of scrubbing possibly compromising metadata from your images.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
65 <h2>Using ExifWasher</h2>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
66 <p>Just double-click on the ExifWasher icon and a main window should open
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
67 up. Either choose the File… Wash from the menu bar, or just drag image
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
68 files onto the main ExifWasher image.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
69 <p>When ExifWasher opens an image, it displays all the metadata it finds.
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
70 That metadata will be run through an internal whitelist, and any data
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
71 whose “key” is not found on the whitelist will be automatically selected
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
72 for deletion.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
73 <p>If you disagree with ExifWasher’s decisions, you can check or uncheck the
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
74 boxes next to the metadata in question. When you are satisfied with the
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
75 choice of metadata to be scrubbed, click “Wash” and all offending metadata
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
76 will be removed. A dialog will pop up showing the metadata remaining in
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
77 the new, washed file.</p>
17
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
78 <h3>Important: Run ExifWasher Last!</h3>
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
79 <p>Most image-editing tools insert telltale bits of metadata into the output
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
80 they create. Thus, only way you can create a file with the minimum amount
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
81 of metadata in it is to run ExifWasher as the final step in your image
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
82 preparation.</p>
16
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
83 <h2>Output Files</h2>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
84 <p>ExifWasher never modifies an existing image file. Instead, it creates a
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
85 new file of the same type but with “_washed” appended to its name. For
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
86 example, processing <code>foo.jpg</code> will create <code>foo_washed.jpg</code>.
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
87 By default, the new file will be created in the same directory as the file
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
88 being washed.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
89 <h2>ExifWasher is Configurable</h2>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
90 <p>Both the whitelist and the destination directory for the washed files are
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
91 user-configurable in the Preferences menu.</p>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
92 <h3>Configuring the Whitelist</h3>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
93 <p>There are two kinds of whitelist entries: those that match an entire
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
94 metadata key, and those that match a key prefix. The latter end in an
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
95 asterisk. The whitelist is case-sensitive; i.e. the entry <code>exif.image.colormap</code>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
96 <em>will not</em> match the <code>Exif.Image.ColorMap</code> key.</p>
17
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
97 <h2>That’s about It</h2>
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
98 <p>ExifWasher does not, and probably never will, do anything but remove
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
99 extraneous metadata.</p>
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
100 <p>First, I have no desire to re-invent the wheel. There are already
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
101 excellent open-source tools like Gimp for image editing, and ExifTool and
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
102 Exiv2 for general-purpose metadata editing (in fact, ExifWasher is built
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
103 on top of Exiv2). If you need the functionality of some other tool,
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
104 download and use it!</p>
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
105 <p>Second (and more importantly), I want ExifWasher to be simple, and
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
106 therefore easy to learn and easy to use. The more challenging an
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
107 information-security tool is to use, the less likely it is to be used
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
108 frequently, and the more likely it is that compromising information gets
0528030187e9 More Readme updates.
David Barts <n5jrn@me.com>
parents: 16
diff changeset
109 disclosed.</p>
16
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
110 </body>
304492a6b72b Add a Readme file.
David Barts <n5jrn@me.com>
parents:
diff changeset
111 </html>