Mercurial > cgi-bin > hgweb.cgi > JpegWasher
annotate Readme.rst @ 31:3b0546fa0d74
Add documentation in alternative formats to HTML.
author | David Barts <davidb@stashtea.com> |
---|---|
date | Sat, 18 Apr 2020 09:08:23 -0700 |
parents | |
children | 35fb8de77c7d |
rev | line source |
---|---|
31
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
1 [This file automatically generated by pandoc from 'Readme.html'.] |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
2 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
3 Introducing JpegWasher |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
4 ====================== |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
5 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
6 Executive Summary |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
7 ----------------- |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
8 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
9 This program makes it easy to remove metadata from the digital images |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
10 you create. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
11 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
12 What is “Metadata” and Why Would I Want to Remove It? |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
13 ----------------------------------------------------- |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
14 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
15 You may not realize it, but image files can (and typically do!) contain |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
16 more than just image data. These data can include your camera make, |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
17 model, and serial number; the location where you took the photo; the |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
18 software you used to edit the photo (and what editing steps you did); |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
19 etc. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
20 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
21 One of the most powerful uses of photography is to graphically document |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
22 things that the wealthy and powerful might wish to remain concealed. The |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
23 evils of slavery, child labor, poverty, war, and imperialism have all |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
24 been documented photographically, and such photographs have often proved |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
25 instrumental in helping to motivate social change. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
26 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
27 Because of the metadata they contain, digital photographs contain data |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
28 which has been used to determine who took them, and in some cases to |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
29 exact retribution against those photographers. JpegWasher makes it easy |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
30 to see and remove the privacy-compromising metadata in your images. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
31 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
32 Even if your images are not of such a sensitive nature, that extra data |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
33 takes up space. It is not uncommon for a 100 KiB image to contain 20 KiB |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
34 of metadata in it; if that image is on a web page, that makes for 20 KiB |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
35 of wasted network usage each time the image is sent. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
36 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
37 What Makes JpegWasher Different from Other Metadata Editors? |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
38 ------------------------------------------------------------ |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
39 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
40 Simply put, it is designed to *safely* remove *unimportant* metadata |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
41 from JPEG files. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
42 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
43 There are plenty of general-purpose image metadata editors out there, |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
44 and these tools can be employed to remove unimportant metadata. The |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
45 trouble is, they are not user-friendly: it is up to you, the user, to |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
46 know which metadata are unimportant, and to delete it. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
47 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
48 There can be literally *hundreds* of bits of metadata in an image, and |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
49 *not all are safe to remove*. In particular, if you accidentally remove |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
50 color-management metadata, computers that don’t handle images without |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
51 color-management metadata properly (I’m talking about *you*, Apple |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
52 Computer, Inc.) will display colors that often look all “washed-out” or |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
53 otherwise incorrect. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
54 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
55 Likewise, there are already plenty of simple-to-use, user-friendly tools |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
56 out there for cleaning the metadata out of image files, but they |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
57 inevitably delete *all* metadata, resulting in files that often display |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
58 improperly. Also of concern, many of these “tools” are actually online |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
59 services. If you’re concerned about your privacy, why would you trust |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
60 the images you’re processing to some unknown third party, who may be |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
61 linked somehow to those who might want to retaliate against you? |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
62 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
63 I wrote this program because I wanted there to be a quick, easy way to |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
64 scrub images before they even left a photographer’s computer and made |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
65 their way onto the Internet, and for that program to leave vital |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
66 metadata alone, so that the resulting images continue to display |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
67 properly. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
68 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
69 JpegWasher Washes More than Just Exif Metadata |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
70 ---------------------------------------------- |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
71 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
72 Jpeg is the most common type of metadata, but image files commonly |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
73 contain compromising XMP or IPTC data, particularly if they have been |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
74 edited with a tool like Photoshop. JpegWasher will seamlessly deal with |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
75 these kinds of metadata, too. It tries to do as thorough a job as |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
76 possible of scrubbing possibly compromising metadata from your images. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
77 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
78 Using JpegWasher |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
79 ---------------- |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
80 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
81 Just double-click on the JpegWasher icon and a main window should open |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
82 up. Either choose the File… Wash from the menu bar, or just drag image |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
83 files onto the main JpegWasher image. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
84 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
85 When JpegWasher opens an image, it displays all the metadata it finds. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
86 That metadata will be run through an internal whitelist, and any data |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
87 whose “key” is not found on the whitelist will be automatically selected |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
88 for deletion. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
89 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
90 If you disagree with JpegWasher’s decisions, you can check or uncheck |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
91 the boxes next to the metadata in question. When you are satisfied with |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
92 the choice of metadata to be scrubbed, click “Wash” and all offending |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
93 metadata will be removed. A dialog will pop up showing the metadata |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
94 remaining in the new, washed file. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
95 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
96 Important: Run JpegWasher Last! |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
97 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
98 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
99 Most image-editing tools insert telltale bits of metadata into the |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
100 output they create. Thus, only way you can create a file with the |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
101 minimum amount of metadata in it is to run JpegWasher as the final step |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
102 in your image preparation. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
103 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
104 Washing Non-JPEG Images |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
105 ~~~~~~~~~~~~~~~~~~~~~~~ |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
106 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
107 In short: it’s possible, but it is not recommended unless you *really* |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
108 know what you’re doing. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
109 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
110 JpegWasher is called JpegWasher for a reason: it is geared to cleaning |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
111 metadata in *JPEG* files. Different types of images use metadata |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
112 differently; metadata that would be extraneous deadwood in a JPEG can be |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
113 critical to interpreting other image file formats correctly. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
114 JpegWasher’s built-in whitelist is geared to what must be retained when |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
115 washing JPEG images, so *careless use of JpegWasher is likely to damage |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
116 non-JPEG files.* It is for this reason that JpegWasher will warn you if |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
117 you attempt to open and wash a non-JPEG file with it. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
118 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
119 Output Files |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
120 ------------ |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
121 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
122 JpegWasher never modifies an existing image file. Instead, it creates a |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
123 new file of the same type but with “_washed” appended to its name. For |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
124 example, processing ``foo.jpg`` will create ``foo_washed.jpg``. By |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
125 default, the new file will be created in the same directory as the file |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
126 being washed. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
127 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
128 JpegWasher is Configurable |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
129 -------------------------- |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
130 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
131 Both the whitelist and the destination directory for the washed files |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
132 are user-configurable in the Preferences menu. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
133 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
134 Configuring the Whitelist |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
135 ~~~~~~~~~~~~~~~~~~~~~~~~~ |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
136 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
137 There are two kinds of whitelist entries: those that match an entire |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
138 metadata key, and those that match a key prefix. The latter end in an |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
139 asterisk. The whitelist is case-sensitive; i.e. the entry |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
140 ``exif.image.colormap`` *will not* match the ``Exif.Image.ColorMap`` |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
141 key. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
142 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
143 That’s about It |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
144 --------------- |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
145 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
146 JpegWasher does not, and probably never will, do anything but remove |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
147 extraneous metadata from JPEG files. |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
148 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
149 First, I have no desire to re-invent the wheel. There are already |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
150 excellent open-source tools like Gimp for image editing, and ExifTool |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
151 and Exiv2 for general-purpose metadata editing (in fact, JpegWasher is |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
152 built on top of Exiv2). If you need the functionality of some other |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
153 tool, download and use it! |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
154 |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
155 Second (and more importantly), I want JpegWasher to be simple, and |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
156 therefore easy to learn and easy to use. The more challenging an |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
157 information-security tool is to use, the less likely it is to be used |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
158 frequently, and the more likely it is that compromising information gets |
3b0546fa0d74
Add documentation in alternative formats to HTML.
David Barts <davidb@stashtea.com>
parents:
diff
changeset
|
159 disclosed. |