-
Notifications
You must be signed in to change notification settings - Fork 3
/
GPGMail.html
508 lines (458 loc) · 37 KB
/
GPGMail.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="author" content="Stephane Corthesy">
<link rel="SHORTCUT ICON" href="../favicon.ico" type="image/x-icon">
<link rel="alternate" href="../French.lproj/GPGMail.html" hreflang="fr">
<title>Sen:te - GPGMail</title>
<style type="text/css">
body,P,TD,TH,textarea,select,option,submit,input{font-size:12px;font-family:verdana,arial,geneva,helvetica,sans-serif;}
code{font-size:13px;font-family:courrier,courrier-new;color: 3399FF;}
:link{ color: 0000FF; }
:link:hover { color: FF0000; }
:visited { color: 3399FF; }
:visited:hover { color: FF0000; }
:active { color: 0000DD; }
:active:hover { color: FF0000; }
</style>
</head>
<body BGCOLOR="#FFFFFF">
<!--#if expr="0 = 1" -->
On-line (and up-to-date) version of this document can be found at <A HREF="http://www.sente.ch/software/GPGMail/">http://www.sente.ch/software/GPGMail/</A>
<HR NOSHADE SIZE=1>
<BR>
<!--#endif -->
<CENTER>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="0" WIDTH="650">
<TR>
<TD WIDTH="230">
<H1><img src="../sente.gif" width="226" height="116" border="0" ALT="Sen:te"></H1>
</TD>
<TD ALIGN="RIGHT" VALIGN="BOTTOM"><IMG SRC="../GPGMail.gif" ALT="GPGMail" width="138" height="122" border="0"></TD>
</TR>
<TR>
<TD ALIGN="RIGHT" VALIGN="BOTTOM" COLSPAN=2><IMG SRC="../PoweredByObjC2.gif" ALT="Powered by Objective C"></TD>
</TR><TR><TD colspan=2>
<HR NOSHADE SIZE=1>
<P ALIGN="CENTER">English | <A HREF="../French.lproj/GPGMail.html">Français</A></P>
<!--#config timefmt="%A %B %d, %Y" --><!--#set var="LastUpdateText" value="<p><i>Last update: ${LAST_MODIFIED}</i></p>" --><!--#echo encoding="none" var="LastUpdateText" -->
<H2><FONT face="Verdana,Arial,Geneva,Sans-serif">PGP for Apple's Mail</font></H2>
<P><B>GPGMail is a plug-in for Apple's Mail, providing a front-end to <code>gpg</code> for some operations. It allows you to read/write encrypted messages, as well as electronically signed messages.</B></P>
<P>GPGMail extends Apple's Mail application and allows you to read and send PGP authenticated and/or encrypted messages. You can use GPGMail for plain text and MIME messages, following <A HREF="#RFC3156">RFC 3156</A>.</P>
<P><B>GPGMail does not contain any encryption code</B>: it is a client to <code>gpg</code> executable.</P>
<P>GPGMail is a complete hack, relying on Mail's private internal API. Use it at your own risks!</P>
<P ALIGN=CENTER><IMG ALT="English" SRC="../US.gif"> <IMG ALT="Español" SRC="../ES.gif"> <IMG ALT="Japanese" SRC="../JP.gif" BORDER=0> <A HREF="../French.lproj/GPGMail.html"><IMG ALT="Français" SRC="../FR.gif" BORDER=0></A> <IMG ALT="Deutsch" SRC="../DE.gif"> <!--<IMG ALT="Dansk" SRC="../DK.gif">--> <IMG ALT="한글" SRC="../KO.gif" BORDER=0> <IMG ALT="Italiano" SRC="../IT.gif"> <IMG ALT="suomalainen" SRC="../FI.gif"> <IMG ALT="danske" SRC="../DK.gif"> <IMG ALT="Nederlands" SRC="../NL.gif"> <IMG ALT="Svenska" SRC="../SWDN.gif"></P>
<P>GPGMail has been localized in 11 different languages, thanks to contributors. The following languages are included in GPGMail: English, Spanish, Japanese, <A HREF="../French.lproj/GPGMail.html">French</A>, German, Korean, Italian, Finnish, Danish, Dutch and Swedish.</P>
<P><IMG SRC="../new.gif" ALT="NEW!"> (Dec 30th, 2008) GPGMail Release 1.2.3 (v61) is currently available.<BR>
<P>Information on this page includes:</P>
<UL>
<li> <A HREF="#Features">Features</A>
<li> <A HREF="#Requirements">Requirements</A>
<li> <A HREF="#License">BSD License</A>
<li> <A HREF="#Feedback">Feedback</A>
<li> <A HREF="#MailingList">Mailing-list</A>
<li> <A HREF="#ReleaseNotes">Release Notes</A><UL><li><A HREF="#KnownBugs">Known bugs</A></LI><li><A HREF="#Suggestions">Ideas for future developments</A></UL>
<li> <A HREF="#Download">Download</A>
<li> <A HREF="#Installation">Installation</A>
<li> <A HREF="FAQ.html">FAQ</A>
<li> <A HREF="#More">References</A>
<li> <A HREF="#Thanks">Thanks</A>
</UL>
<H2><A NAME="Features">Features</A></H2>
<P>Once started, Mail has a new submenu, <B>PGP</B>, in its
<B>Message</B> menu, containing the following items:</P>
<CENTER><TABLE><TR valign="bottom">
<TD>
<img ALT="GPG" src="../GPG.gif" width="48" height="48" border="0"><BR>
<UL>
<li>Decrypt
<li>Authenticate
<li>Encrypt New Message
<li>Encryption Keys<ul>
<li>Use Passphrase Encryption
<li>Automatic Choice
<li>Choose...
<li>(list of public keys)
</ul>
<li>Sign New Message
<li>Signing Keys<ul>
<li>(list of secret keys)
</ul>
<li>Force Use of PGP-MIME
<li>Refresh Keys
</UL>
<TD><IMG SRC="PGPSubMenu.png" ALT="PGP submenu">
</TR></TABLE></CENTER>
<P>There is also a new submenu, <B>PGP Keys</B>, in menu <B>View</B>, allowing you to choose on-the-fly which attributes must be displayed for keys.</P>
<P>Finally, in menu <B>Window</B>, a new item <B>PGP Key Search</B> displays a PGP key search panel when clicked.</P>
<P>Mail also has a new Preferences panel in which you
can:</P>
<UL>
<li>choose your default PGP key
<li>when to encrypt/sign/decrypt/verify, etc.
</UL>
<CENTER><IMG SRC="Preferences.gif" ALT="Preferences panel"></CENTER>
<P>When composing a new message, some new buttons appear in the composer window:</P>
<CENTER><IMG SRC="Compose.png" ALT="Compose window"></CENTER>
<P>They allow you to choose which key you want to sign with, and which keys have to be used for encryption, when enabled. By default, GPGMail will try to find out by itself which keys are needed for encryption, according to the recipients email addresses; keys are listed in the <b>Keys</b> popdown button. In case it misses some keys, a warning icon will be displayed next to the popdown button. At that time you can ask GPGMail to search for missing keys on key servers (if <code>gpg</code> has been configured correctly, using for example <A target="_blank" HREF="http://macgpg.sourceforge.net/">GPGPreferences</A>), using menu item <B>Download...</B> in popdown menu.</P>
<CENTER><IMG SRC="SearchKeys.png" ALT="PGP Key Search panel"></CENTER>
<P>In the Composer window, you can also add two toolbar items (by customizing the toolbar) to set the
encryption (on/off) and add or not your PGP signature; you can also use menu items
<B>PGP/Encrypt New Message</B> and <B>PGP/Sign New Message</B>. When you compose
a new message, you can sign it (you will be asked for your key
passphrase), and/or you can encrypt it. Note that encryption/signature is always applied on the whole message.</P>
<CENTER><IMG SRC="Signing.png" ALT="Message Authentication panel"></CENTER>
<P>GPGMail can use two different formats for encryption/signature: if your message consists only of plain text (no attachments, no rich text attributes like bold, italic, etc.), GPGMail will use the old PGP format, with inline ASCII-armored signature/encryption. In the other case, it will use the new OpenPGP/MIME format, with MIME attachments, which is not recognized by some mail agents like Outlook/Entourage/Eudora, but welcomed by Sylpheed, Mulberry and others. If you prefer GPGMail to always use the OpenPGP/MIME format, then you can set it in preferences, or using menu item <B>Message</B>/<B>PGP</B>/<B>Force Use of PGP-MIME</B>.</P>
<P>You can also apply some rules to let GPGMail decide when to encrypt/sign a message, according to the recipients. Look at GPGMail Composing preferences, and Robert Goldsmith's <A HREF="#ABKey">ABKey</A> bundle.</P>
<P>AddressBook groups are also supported: if you use a group's name as a message recipient, and all members of this group have a valid PGP key, then GPGMail will use all these keys.</P>
<P>When you browse through messages, GPGMail can operate automatically, or on-demand. In automatic mode, it tries to authenticate or decrypt the currently selected message; in manual mode, you click on a button/menu to decrypt or authenticate the currently selected message; you can also use the contextual menu.</P>
<P>After authenticating a message, the signature information is displayed, in short or long form.</P>
<CENTER><IMG SRC="Decrypting.gif" ALT="Decrypting a message"></CENTER>
<P>Encryption/decryption of plain text and MIME messages works.</P>
<P>Decryption of HTML messages works too, if there's a plain text alternative, but you need to tell Mail to display the plain text alternative after you decrypted the message (menu <B>View</B>/<B>Message</B>/<B>Plain Text Alternative</B>). Don't expect better support in the future!</P>
<P>If you allow passphrase cacheing, passphrase is either stored in cache during
a small amount of time (default is 60 seconds) - if it has not been used during this time, cache
is cleared -, or stored in your default keychain. Note that this feature does not work when <CODE>gpg-agent</CODE> is used.</P>
<H2><A NAME="Requirements">Requirements</A></H2>
<P>You need <B>MacOS X 10.5.x</B>; GPGMail will not work as-is on other OS versions, because the internals of Apple's Mail changes on every revision.</P>
<P>You need a <code>gpg</code> version >= 1.4.0 (or <code>gpg2</code>), usually installed in <code>/usr/local/bin/</code>, but GPGMail will search for <code>gpg2</code> then <code>gpg</code> in several locations (<code>/usr/local/bin</code>, <code>/opt/local/bin</code>, <code>/sw/bin</code>) and use the first found one. Or you can change user default <code>GPGOpenPGPExecutablePath</code> to set a different path, or use <A target="_blank" HREF="http://macgpg.sourceforge.net/">GPGPreferences 1.3</A>.</P>
<P>You can use MacGPG distribution, available at <A target="_blank" HREF="http://macgpg.sourceforge.net/">MacGPG web site</A>, or, for <code>gpg2</code>, <A target="_blank" HREF="http://macgpg2.sourceforge.net/">MacGPG2 web site</A>.</P>
<H2><A NAME="License">BSD License</A></H2>
<pre>Copyright (c) 2000-2009, Stéphane Corthésy <stephane at sente.ch>
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of Stéphane Corthésy nor the names of GPGMail
contributors may be used to endorse or promote products
derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY STÉPHANE CORTHÉSY AND CONTRIBUTORS ``AS IS'' AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL STÉPHANE CORTHÉSY AND CONTRIBUTORS BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</pre>
<P>Note that some parts of the GPGMail distribution are under <A target="_blank" HREF="http://www.gnu.org/licenses/gpl.html">LGPL</A> license: the <A target="_blank" HREF="http://macgpg.sourceforge.net/">MacGPGME</A> framework, the <A target="_blank" HREF="http://www.gnupg.org/">gpg-error</A> and <A target="_blank" HREF="http://www.gnupg.org/">gpgme</A> C libraries. The GPGMail license does not apply to these parts.</P>
<UL>
<li><A target="_blank" HREF="http://macgpg.sourceforge.net/">MacGPGME</A>, copyright 2001-2008 MacGPG Project</li>
<li><A target="_blank" HREF="http://www.gnupg.org/">gpg-error</A>, copyright 2005-2008 g10 Code GmbH</li>
<li><A target="_blank" HREF="http://www.gnupg.org/">gpgme</A>, copyright 2001-2008 g10 Code GmbH</li>
</UL>
<H2><A NAME="Feedback">Feedback</A></H2>
<P>I appreciate feedback on this software.
Before sending bug reports or asking for new features, please have a look at the already submitted ones:<UL><LI><A target="_blank" HREF="http://sourceforge.net/tracker2/?group_id=222344&atid=1055153">Bug tracker</A><LI><A target="_blank" HREF="http://sourceforge.net/tracker2/?group_id=222344&atid=1055156">Feature Requests</A><LI><A target="_blank" HREF="FAQ.html">FAQ - Frequently Asked Questions</A></UL>
You can add new entries (or comments) anonymously - no need to have a SourceForge login. You can also contact me through the <a href="#MailingList">mailing list</a>, or privately at <code>gpgmail at sente ch</code></P>
<P>My PGP key is available from the most public keyservers.<BR>My key ID: <code>0x992020D4</code>. My key fingerprint: <code>A5BA B3D8 4F6C AE03 8B22 76F2 5467 B616 9920 20D4</code></P>
<P><B>If you like it, tell it to me, and to <a target="_blank" href="http://www.apple.com/feedback/macosx.html">Apple</a>, and maybe they will help me to port it to future MacOS X releases.</B> (now that they <a target="_blank" href="http://support.apple.com/kb/TS2486">recognized</a> that GPGMail exists ;-) )</P>
<P>GPGMail is free software, but if you want to give something... well, send me a postcard from where you live; if you're too lazy to, you can also send me a geo-tagged image from where you live.<BR><ADDRESS>Sen:te, Simplon 25, 1006 Lausanne, Switzerland</ADDRESS></P>
<P>Till now I already received postcards from Wien (A), Utrecht (NL), Nürnberg (D), Berlin (D), Munich (D), Diemen (NL), Geneva/CERN (CH), Manchester (USA/NH), Hakalau (USA/HI), Columbia University (USA/NY), Emmendingen (D), Naantali (FI), Newport Beach (USE/CA), Ellensburg (USA/WA), Hsinshu (TW), Ulm an der Donau (D), Lafayette (USA/IN), Chicago (USA/IL), Tallahassee (USA/FL), Key West (USA/FL), Djakarta (Indonesia), Battery Point (Tasmania), Zaragoza (E), somewhere else in Germany, Heidelberg (D), Eugene (USA/OR), Brisbane (AUS), Macao, Amherst (USA/MA), Toronto (CAN), Barcelona (E), Frankfurt am Main (D). Thanks all!</P>
<H2><A NAME="MailingList">Mailing-list</A></H2>
<P>I set up a mailing list, <b>gpgmail-users@lists.sourceforge.net</b> (which replaces the old one gpgmail-users@sente.ch). It is intended to be low traffic mailing list, mainly used by me to announce news on GPGMail development. Anyone can subscribe: go to <A target="_blank" HREF="https://lists.sourceforge.net/lists/listinfo/gpgmail-users">https://lists.sourceforge.net/lists/listinfo/gpgmail-users</A>. Recent archives can be consulted online, at <a target="_blank" href="http://sourceforge.net/mailarchive/forum.php?forum_name=gpgmail-users">http://sourceforge.net/mailarchive/forum.php?forum_name=gpgmail-users</a>, whereas old archives (years 2002-2008) can still be consulted on-line, at <A target="_blank" HREF="http://www.sente.ch/Lists/gpgmail-users/List.html">http://www.sente.ch/Lists/gpgmail-users/List.html</A> (login: sente, password: sente). Note that you may post messages too, if you want to exchange opinions/ideas on GPGMail with other users.</P>
<H2><A NAME="ReleaseNotes">Release Notes</A></H2>
<P><IMG SRC="../new.gif" ALT="NEW!"> (Dec 30th, 2008) GPGMail 1.2.3 (v61) is currently available:<UL>
<li>Available for 10.5 Leopard only</li>
<li>Now under <a href="#License">BSD license</a> (more liberal than before)
<li>Project now located on <a target="_blank" href="http://sourceforge.net/projects/gpgmail/">SourceForge.net</a>
<li>Better compatibility when decrypting messages from old mailers (e.g. handles encrypted attachments)
<li>Added Swedish localization by Erik Hedlund
<li>Added new keyserver to list (SKS)
<li>For ASCII encrypted/signed messages, enforces use of quoted-printable - more robust - Thanks to Greg A. Woods
<li>Fixed support for <code>gpg2</code> (provided that you have a working agent - see <a target="_blank" href="FAQ.html#gpg2">FAQ</a>)
<li>Fixed problem with <code>GPGOpenPGPExecutablePath</code> (no longer necessary in most cases - see documentation)
<li>Fixed bug when sending signed+encrypted (ASCII) message with untrusted recipient, and GPGMail set to trust no key: an exception was logged, instead of being displayed to user.
<li>Fixed bug: was still signing when automatic signing but no matching account
<li>Fixed bug with manual choice of encryption keys: message might be sent without encryption/signature
<li>Fixed bug: draft additional headers were not removed when message was delivered
<li>Fixed bug with manual choice of keys: choice was lost when displaying again key list
<li>Fixed bug with AppleScript-generated messages, and redisplayed PGP buttons
<li>Fixed dependency on <code>/usr/local/bin/gpg</code>
<li>Fixed positioning of compose accessory view
<li>Fixed bug with 'verbose' option in gpg.conf file
<li>Fixed toggle triangle state (showing/hiding the extended signature info)
<li>Fixed case where public key choice was still automatic even after user chose keys manually
<li>Fixed initial automatic choice of key according to account
<li>Fixed initial sign/encrypt settings, when they should be set by default
<li>Fixed bug with disabled toolbar items on detached viewers
<li>Fixed UI-compatibility problems with MailTags
<li>Fixed bug with non-English locales
<li>Fixed bug with 'Reply to All' button
<li>No longer supports Tiger (10.4)
<li>No longer supports Panther (10.3)
</UL>
<P>(Feb 5th, 2006) GPGMail 1.1.2 (v46):<UL>
<li>Last version for Panther/10.3</li>
<li>Panther: fixed crashes</li>
<li>Tiger: built as Universal Binary</li>
<li>Now needs <code>gpg</code> >= 1.4.x</li>
<li>Tiger: temporarily disabled display of PGP elements in composer window when window is created via AppleScript, to avoid unsolvable bug - you can still change PGP settings via menu Message/PGP.</li>
<li>Mail no longer freezes when with using untrusted keys for encryption</li>
<li>Now fills in automatically PGP Key Download search field as soon as a key is missing (except when already performing search/import)</li>
<li>Fixed passphrase encryption when signature was toggled on</li>
<li>Fixed crash after message delivery failure</li>
<li>Dutch localization by Marc-Siebren Kwadijk</li>
<li>Added hidden user default, <code>GPGOpenPGPExecutablePath</code></li>
<li>Fixed uncaught exceptions when <code>gpg</code> not configured correctly</li>
<li>Better error message when error related to specific key</li>
<li>Better key server-related error messages (not yet localized though)</li>
<li>Now accepts SHA-256, SHA-384 and SHA-512 hash algorithms</li>
<li>Fixed compatibility-problem with MailTags</li>
<li>Fixed sorting of keys in key chooser dialog</li>
<li>Fixed bug when "only if message is unread" prefs were followed (when checked) even when automatic decryption/authentication was unchecked</li>
<li>Fixed problem where encryption was not settable until signing had been set, in some cases.</li>
<li>No longer tries to decrypt text/plain attachments</li>
<li>Tries to decrypt/verify application/octet-stream attachments</li>
<li>Fixed alignments in new message window</li>
</ul>
<P>(Jul 17th, 2005) GPGMail Release 1.1.1 (v44):<UL>
<li>Changed keyboard shortcuts for sign/encrypt/decrypt/verify, using same as PGP, because our ones didn't work on Tiger anylonger
<li>Tiger: Fixed compatibility problem with Enigmail encrypted messages that could not get decrypted
<li>Fixed unlocalized error message NO_VALID_PRIVATE_KEY
<li>Tiger: added separator line to compose window (thanks to Felix Schaumburg)
<li>Changed pref text: reply to <b>PGP</b> encrypted/signed
<li>Warning icon was no longer displayed when missing PGP keys
<li>Tiger: toolbar icons take less space now
<li>Tiger: Encryption/signing works again when performed from menu/toolbar buttons, without PGP buttons in composer
<li>Tiger: it was no longer possible to choose any PGP keys manually
<li>Spanish localization by Sergio Rodríguez Concha
<li>Finnish localization fix by Seppo Laaksonen
<li>Japanese localization by Tomio Arisaka
<li>Sender's PGP information (sign/encrypt/MIME) stored in AddressBook is no longer evaluated by rules
<li>When evaluating for reply/forwarded, don't use signed/encrypted information from S/MIME messages
<li>Fixed German localization
<li>Added hidden option, <code>GPGAddCustomHeaders</code>
<li>Tiger: Fixed install on 10.4.1 and later
<li>Fixed alignment of some items in composer window
<li>Now links to MacGPGME dynamically, to avoid license problem
<li>ASCII signed messages: fixed problem with Usenet signatures
<li>Tiger: fixed auto-decryption/auto-verification of unread messages
<li>Tiger: fixed refresh problem of compose accessory view when To/CC fields get higher
<li>Tiger: fixed iPhoto problem
<li>Added Danish localization by Sebastian Adorjàn Dyhr
<li>Fixed some ASCII signature verification problems
<li>Fixed UI bug when message is created by AppleScript
<li>Tiger: Fixed assertion failure when verifying messages
<li>Tiger: Was sometimes failing to report error
</ul>
<P>(Apr 29th, 2005) GPGMail Release 1.1 (v42):<UL>
<li>Added support for Tiger (10.4)
<li>Fixed invalid display of keys being revoked/expired/disabled/invalid
<li>Fixed compatibility problem with Windows' EudoraGPG, thanks to Georg Wedemeyer
<li>Fixed Finnish translation (courtesy of Asko Kauppi)
<li>Added basic support for AddressBook groups
<li>Added automatic settings (encryption, signature) based on current context
<li>Added retrieval of people <code>gpg</code> options from their Address Book card (set by Robert Goldsmith's <A HREF="#ABKey">ABKey</A> bundle)
<li>No longer tries to use invalid secret key when encrypting
<li>Got rid of GPGMEProxyServer
<li>Much faster PGP operations, notably key listing
<li>When a draft is restored, the encryption and signature states are restored too
<li>Fixed problem with attachments having non-ASCII filenames: now these chars are replaced by '_', but that doesn't affect final filename, except maybe on old mail clients.
<li>Fixed bug with default private key which needed to be selected manually to get actually selected
<li>Lot of new options
<li>Added PGP-settings conflict resolution panel on delivery
<li>Now correctly recognizes revoked/disabled keys
<li>No longer reports wrongly a hash algo choice error instead of the unability to sign
<li>Only English, French, Finnish and German localizations are complete
<li>And more... to be documented
</UL>
<P>(May 14th, 2004) GPGMail Release 1.0.2 (v37):<UL>
<li>New icons by Michel Poulain (thanks also to Moritz Guth)
<li>Corrected default key selection restoration
<li>Corrected Spanish localization
<li>Corrected scrolling of signature banner title
<li>10.2: no longer fails to load 10.3-compiled version, but catches error and reports it to user
<li>New (hidden) option, <code>GPGRefreshesKeysOnVolumeMount</code>, to disable automatic refresh of keys when volume is (un)mounted; default value is YES.
<li>New (hidden) option, <code>GPGDisablesSMIME</code>, to totally disable S/MIME encryption/signature. Default value is NO.
<li>No longer considers text/plain attachments as potential PGP parts
<li>Fixed incompatibility with PGP7/Outlook: for encrypted messages, always uses <code>content-transfer-encoding: 7bit</code>
<li>When keychain passphrase was wrong, keychain item was not deleted
<li>Corrected recognition of disabled/revoked secret/public keys
<li>User could select revoked private key -> signed message was empty
<li>New feature: if user shows all keys (no filter), then display key status (revoked/disabled/expired)
<li>New feature: extended key server list, like in <A target="_blank" HREF="http://macgpg.sourceforge.net/">GPGPreferences</A>
<li>New feature: show alert when signer's key is revoked/disabled/...
<li>Fixed: if you select passphrase encryption then turn it back off, the signing option is unticked (when it should be ticked).
<li>New feature: after encryption failure due to missing keys, user can now select to send unencrypted
<li>Fixed: 10.3: Account pulldown menu in composer window is randomly greyed. Happens as soon as changing account changes PGP key, from now on.
<li>10.3: changed disclosure triangle in signature banner
<li>Compose window: warning icon is now displayed in popdown menu
<li>Added hidden option <code>GPGUsesAlwaysCRLF</code> to always use CRLF as line-ending for PGP-inline encryption/signing; default value is NO.
<li>Corrected recognition of disabled/revoked public keys in compose panel
<li>Fixed enabling/disabling of toolbar/menu items when multiple windows are open
<li>Fixed rare dead-lock at startup
<li>Last release with 10.2-compatibility
</UL>
<P>(Nov 17th, 2003) GPGMail Release 1.0.1 (v33):<UL>
<li>When PGPmail is installed, you're no longer forced to quit, but you're warned that it's at your own risks.
<li>No longer leaves orphan GPGMEProxyServer processes on quit or crash
<li>Corrected some error messages
<li>Key search results sometimes didn't display correct names (problem with accents)
<li>Key search now displays "revoked" status in results
<li>Now refreshes keys each time a volume has been (un)mounted
<li>Added Finnish localization by Seppo Laaksonen
<li>Added Japanese localization by Kory Talmage
<li>Applied typographical rules to French localization
<li>Corrected some resizing errors
<li>Corrected installation problem with FileVault
<li>Corrected installation problem in <code>/Network/Users/</code>
<li>Corrected problem with some keys which have ISOLatin1 string encoding for the userIDs, when decrypting/signing
<li>Installer checks now system version
<li>No longer leaves a sticky "Done." message in the status view
<li>Added Korean localization by Sangduk Park
<li>Corrected problem with other mailers that added an empty line between each line when verifying/decrypting a PGP message
<li>Replying/forwarding/redirecting a decrypted message now quotes the decrypted message
</UL>
<P>(Oct 25th, 2003) GPGMail Release 1.0 (v30):<UL>
<li>Completely reviewed code; now uses GPGME (indirectly)
<li>Replaced most of modal dialogs by non-modal ones, à la Junk Mail
<li>Added support for KeyChain, thanks to Annard Brouwer
<li>Added support for multiple secret keys
<li>User can now choose private/public keys; automatically, or manually
<li>Added symetric encryption support (encryption without key, only with shared passphrase)
<li>Preferences panel has been completely revamped, with new options
<li>New option: enable/disable trust of keys according to web-of-trust
<li>New option: choose OpenPGP-MIME format; automatically, or manually
<li>User can use BCC recipients too
<li>Decryption of encrypted and signed messages no longer fails when when signature cannot be checked (missing key, etc.)
<li>Corrected AppleScript incompatibility
<li>New option: sign when encrypting
<li>New option: decrypt/authenticate automatically only when message is unread
<li>New option: in passphrase panel, you can display typed passphrase
<li>When encrypting message, if you miss a key, GPGMail will try to find one on your default keyserver.
<li>Added ability to search for keys on keyservers.
<li>New option: line wrapping
<li>New option: always encrypt
<li>After computer sleep, passphrase timeout is now reset
<li>Corrected Installer problem with path containing aliases/links
<li>Corrected problem with format=flowed
<li>Now checks presence of PGPmail
<li>Hash algorithm is set according to your gpg preferences
<li>Dropped support for 10.1
<li>Added support for 10.3
</UL>
<P>(Sep 10th, 2002) GPGMail Release 0.5.4 (v22):<UL>
<li>Added Swedish translation from Daniel Aarno
<li>Added Italian translation from Filippo Stefanelli
<li>Corrected some glitches with passphrase panel
<li>No longer leaves files in <code>/tmp</code>
<li>Added an installer
<li>Documentation translated in French
<li>License has been modified
<li>Corrected Korean translation
<li>Added support for MacOS X 10.2.x
<li>Corrected compatibility problem between contextual menu and other Mail plug-ins
</UL>
<P>(Jun 23rd, 2002) GPGMail Release 0.5.3 (v20):<UL>
<li>Added Spanish translation from Sergio Rodríguez Concha
<li>Added French translation from Michel Poulain
<li>Added Japanese translation from Tomio Arisaka
<li>Added beautiful icons from Michel Poulain
<li>Modified "decrypted" icon, by Jamin Wilson
<li>Added new userDefaults, <code>GPGOpenPGPStyleOnly</code> (default value is NO), to force always using OpenPGP-style encryption/signing
<li>Corrected problems with attachments which were not yet loaded
<li>Corrected problem with Kotoeri input method
<li>Added German translation from Hauke Müller
<li>Added Danish translation from Thomas Dyhr
<li>Stopped support for MacOS X Server (Rhapsody)
<li>Added Korean translation from Sangduk Park
<li>Added support for encapsulated signature (RFC1847); this is now the default method used when encrypting a signed message with OpenPGP style.
<li>Corrected state of newly added toolbar buttons
<li>Corrected problems due to character sets (no longer forces use of UTF8)
<li>Added contextual menu for decryption/authentication
<li>Corrected header decoding bug
<li>Corrected signature bug
<li>Corrected compatibility problems with Sylpheed, Evolution, Entourage, Outlook, Eudora, etc.
<li>Corrected compatibility problem with MacOS X 10.1.5
<li>Added basic support for HTML signed/encrypted messages
<li>Corrected problem with gpg 1.0.7: you no longer need to sign keys before using them for encryption. With gpg 1.0.6, you still need to: if you don't, encryption is refused.
<li>Corrected problems with <A target="_blank" HREF="http://www.parapunzi.ch/projects/mailpriority/">MailPriority</A> >= 1.1
</UL>
<P>(Nov 22nd, 2001) GPGMail Release 0.5.2 (v13):<UL>
<li>Ported to MacOS X 10.1.x
<li>Corrected problems with character sets
<li>Added keyboard shortcuts
<li>Now needs gpg version >= 1.0.6
<li>No version for MacOS X Server 1.x
</UL>
<P>(Sep 8th, 2001) GPGMail Release 0.5.1 (v8):<UL>
<li>Ported to MacOS X 10.0.4
<li>Corrected bugs in the application of RFC 3156
<li>Corrected lots of other bugs
</UL>
<P>(Feb 7th, 2001) GPGMail Release 0.5 (v4): initial release, for MacOS X Server 1.x and MacOS X Public Beta.</P>
<H3><A NAME="KnownBugs">Known bugs</A></H3>
Bugs are now listed on <a target="_blank" href="http://sourceforge.net/tracker2/?group_id=222344&atid=1055153">SourceForge</a>. You're encouraged to consult the list before reporting bugs; you can add comments to existing bug reports.
<H3><A NAME="Suggestions">Ideas for future developments</A></H3>
You can now submit your ideas and feature requests online at <A target="_blank" HREF="http://sourceforge.net/tracker2/?group_id=222344&atid=1055156">SourceForge</A>. No need to have a login at SourceForge.
<H2><A NAME="Download">Download</A></H2>
<P>The source code as well as precompiled binaries of GPGMail can be downloaded from <a target="_blank" href="http://sourceforge.net/project/showfiles.php?group_id=222344">SourceForge</a>. You need Xcode to compile the sources. You can also consult the <a target="_blank" href="http://sourceforge.net/svn/?group_id=222344">Subversion repository</a>, and perform a checkout of the most recent source code.</P>
<P>Packages are PGP-signed: to verify them, download also the accompanying detached signature and verify the package integrity. You can use <A target="_blank" HREF="http://macgpg.sourceforge.net/">GPGDropThing</A> to do this, or in the Terminal, type:</P>
<code>gpg --verify package.dmg.asc</code>
<P>My key ID is <code>0x992020D4</code>, and my key fingerprint is <code>A5BA B3D8 4F6C AE03 8B22 76F2 5467 B616 9920 20D4</code></P>
<P>Old versions for 10.4 and 10.3 are available <A HREF="http://www.sente.ch/pub/software/GPGMail/">there</A>.</P>
<H2><A NAME="Installation">Installation</A></H2>
<UL>
<li>Download and install <code>gpg</code>/<code>gpg2</code>; binaries are available from <A HREF="http://macgpg.sourceforge.net/">MacGPG</A> and <A HREF="http://macgpg2.sourceforge.net/">MacGPG2</A> web sites.
<li>Create a PGP key if necessary (see <A target="_blank" HREF="http://www.gnupg.org/">GnuPG</A> documentation, or use <A target="_blank" HREF="http://macgpg.sourceforge.net/">GPG Keychain Access</A>)
<li>Launch the Installer (automatic install), or (manual install)
<UL>
<li>Quit Mail
<li>Delete previous installed version of GPGMail.mailbundle in the folder <code>Library/Mail/Bundles/</code> of your home folder (eventually also in <code>/Library/Mail/Bundles/</code>)
<li>Copy GPGMail.mailbundle into the folder <code>Library/Mail/Bundles/</code> of your home folder (create folders if necessary)
<li>In the Terminal, type:<BR>
<code>defaults write com.apple.mail EnableBundles -bool true</code><BR>
<code>defaults write com.apple.mail BundleCompatibilityVersion 3</code>
<li>Restart Mail
</UL></UL>
<H2><A NAME="FAQ">Frequently Asked Questions</A></H2>
<P>I wrote a little FAQ to help you solve most common problems related to GPGMail and gpg. Please, <A HREF="FAQ.html">have a look at it</A>!</P>
<H2><A NAME="More">References and further readings</A></H2>
<OL>
<li><a target="_blank" href="http://sourceforge.net/projects/gpgmail/">GPGMail project's page</a> on Sourceforge
<li><A NAME="gnupg">GnuPG</A>, <A target="_blank" HREF="http://www.gnupg.org/">GNU Privacy Guard</A>, official web site.
<li><A NAME="RFC3156">RFC 3156</A>, <A target="_blank" HREF="http://www.ietf.org/rfc/rfc3156.txt">MIME Security with OpenPGP</A>.
<li><A NAME="PGP">PGP</A>, <A target="_blank" HREF="http://www.pgpI.org/">The International PGP Home Page</A>.
<li><A NAME="PGPBook">PGP reference book</A>, <A target="_blank" HREF="http://www.oreilly.com/catalog/pgp/">PGP: Pretty Good Privacy</A>, by Simson Garfinkel.
<li><A NAME="ezgpg">MacGPG</A>, <A target="_blank" HREF="http://macgpg.sourceforge.net/">Mac GNU Privacy Guard</A>, official web site.
<li><A NAME="ezgpg2">MacGPG2</A>, <A target="_blank" HREF="http://macgpg2.sourceforge.net/">Mac GNU Privacy Guard 2</A>, official web site.
<li><A>GPGMail FAQ</A>, <A target="_blank" HREF="FAQ.html">Frequently Asked Questions</A>.
<li><A target="_blank" HREF="http://www.bretschneidernet.de/tips/secmua.html">Secure email-clients with PGP/MIME</A>.
<li><A NAME="ABKey">ABKey</A>, <A target="_blank" HREF="http://abkey.far-blue.co.uk/">Address Book GPG key manager plugin</A>, by Robert S. Goldsmith.
<li><A NAME="cuk.ch">Cuk.ch</A>, <A target="_blank" HREF="http://www.cuk.ch/articles/2659">PGP-GPG : mettez vos courriers dans des enveloppes</A>, by Olivier Pellerin (in French).
<li><a name="mio_rhapsody">GnuPG暗号化メールをMacOSXで使おう</a>, <a target="_blank" href="http://homepage.mac.com/mio_rhapsody/gnupg/index_GnuPG.html">GnuPGとGPGMailのインストール方法と使い方</a>, by 有坂富雄 (Tomio Arisaka) (in japanese).
</OL>
"PGP" and "Pretty Good Privacy" are registered trademarks of Network Associates, Inc.<BR>
"GnuPG" is Copyright 1998-2008 Free Software Foundation, Inc.
<H2><A NAME="Thanks">Thanks</A></H2>
<P>Thanks to Michel Poulain, from <A target="_blank" HREF="http://www.lashampoo.com/">La Shampoo</A>, for the artwork (icons & web site images), feedback, etc.</P>
<P>Thanks to all beta-testers and users</P>
<P>Thanks to translators: Sergio Rodríguez Concha (Spanish), Michel Poulain (French), Hauke Müller (German), Sangduk Park (Korean), Filippo Stefanelli and Roberto Bolzan (Italian), Tomio Arisaka and Kory Talmage (Japanese), Seppo Laaksonen (Finnish), Thomas Dyhr and Sebastian Adorján Dyhr (Danish), Marc-Siebren Kwadijk (Dutch), Daniel Aarno and <a target="_blank" href="http://www.gandoon.com/">Erik Hedlund</a> (Swedish).</P>
<P>Special thanks to Robert S. Goldsmith, for his bundle, his comments, etc. Thanks!</P>
<P>One more special thank to Guillaume 'LeChatNoir' Gandreau for helping me on the project.</P>
<H2>Software Library</H2>
<P>More Mac OS X, WebObjects or OPENSTEP <A HREF="http://www.sente.ch/software/">software</A> to download from Sen:te</P>
<P>More Mail plug-ins developed by other people:<UL>
<li><A target="_blank" HREF="http://www.parapunzi.ch/projects/mailpriority/">MailPriority</A>, by David Frank, to set messages priority
<li><A target="_blank" HREF="http://www.tikouka.net/mailapp/">Mail.app plugs and suggestions</A>, by Robin Benson, list of all unsupported plug-ins for Mail.app
<LI><A target="_blank" HREF="http://www.hawkwings.net/plugins.htm">Hawk Wings: Plug-ins and add-ons list</A>, by Tim Gaden, list of all unsupported plug-ins for Mail.app
<LI><A NAME="ABKey">ABKey</A>, <A target="_blank" HREF="http://abkey.far-blue.co.uk/">Address Book GPG key manager plugin</A>, by Robert S. Goldsmith.
</UL>
<HR NOSHADE SIZE=1><P ALIGN = CENTER>
<IMG SRC="../home.gif" ALT="Welcome"><A HREF="http://www.sente.ch/Welcome.html">Welcome</A>
<IMG SRC="../find.gif" ALT="Search"><A HREF="http://www.sente.ch/sente/English.wlproj/SearchForm.html">Search</A>
<IMG SRC="../info.gif" ALT="Information"><A HREF="http://www.sente.ch/sente/English.wlproj/Addresses.html">Information</A>
<IMG SRC="../mail.gif" ALT="Ask Sen:te"><A HREF="mailto:info@sente.ch">Ask Sen:te</A>
<BR>
©Copyright 2000-2009, Stéphane Corthésy. All rights reserved.
</P>
</TD></TR></TABLE></CENTER>
</body>
</html>