1 |
WinPT - The Windows Privacy Tray |
WinPT - The Windows Privacy Tray |
2 |
|
================================= |
3 |
|
|
4 |
|
|
5 |
Index |
Bugs and Improvements |
6 |
1. Note |
--------------------- |
7 |
2. Bugs and improvements |
|
8 |
2.1 Legacy Windows versions |
Because of the long phase of inactivity, it is very likely that the |
9 |
3. What is WinPT? |
current code has problems with a recent GnuPG and Windows version. You |
10 |
4. Install |
can find an (outdated) tracker at <http://wald.intevation.org>. |
|
4.1 Keyserver config file |
|
|
5. Verify the packet signature |
|
|
6. Native language support |
|
|
7. Other documentation |
|
|
8. Mailing lists |
|
|
9. Hotkeys for common commands |
|
|
10. Current window support |
|
|
11. Word wrapping |
|
|
12. Default key for signing |
|
|
13. Commands |
|
|
13.1 File manager |
|
|
13.2 Key manager |
|
|
13.2.1 Edit |
|
|
13.2.2 UserID |
|
|
13.2.3 Delete |
|
|
13.2.4 Sign |
|
|
13.2.5 Revoke cert |
|
|
13.2.6 Check sigs |
|
|
13.3 Keyserver |
|
|
13.3.1 Keyserver searching |
|
|
13.3.2 Proxy support |
|
|
14. Debug mode |
|
|
16. Features of the dialogs |
|
|
16. Features of the dialogs |
|
|
|
|
|
|
|
|
1. Note |
|
|
--------- |
|
|
|
|
|
This is only a quick guide for WinPT. For the moment the program is its own |
|
|
documentation. This is subject to change. |
|
|
|
|
|
|
|
|
2. Bugs and improvements |
|
|
------------------------ |
|
|
|
|
|
I have tried to thoroughly test this program, but if you've found a bug, |
|
|
please send me a message with a full error description or go directly |
|
|
to http://wald.intevation.org and use the WinPT bug tracking system. |
|
11 |
|
|
12 |
Please include as much detail as possible including OS version, WinPT |
Please include as much detail as possible including OS version, WinPT |
13 |
version, and GPG version in use. Please summarize your gpg configuration |
version, and GPG version in use. Please also summarize your gpg configuration |
14 |
and describe any special programs or configurations on your machine. |
and describe any special programs or configurations on your machine. |
15 |
|
|
16 |
I try to fix bugs as quickly as possible and will upload all updates to |
Update and new releases will be available at: |
17 |
http://www.winpt.org |
<http://wald.intevation.org/projects/winpt> |
18 |
|
|
19 |
|
|
20 |
2.1 Legacy Windows versions |
Legacy Windows versions |
21 |
|
----------------------- |
22 |
|
|
23 |
I know a lot of people still user old versions of WinPT but it is very |
WinPT requires at least Windows XP or higher. Currently, the support |
24 |
hard to test the code on all these platforms and thus I decided to |
for Windows 7 is limited and we do not give any support for Vista. |
|
obsolete the support for these OS versions: Win95, WinME/98. The code |
|
|
works on 98/ME without known limitations but if you will encounter |
|
|
a serious problem, I doubt I can fix it without having this OS and |
|
|
this is the major problem! |
|
25 |
|
|
26 |
|
|
27 |
3. What is WinPT? |
What is WinPT? |
28 |
----------------- |
-------------- |
29 |
|
|
30 |
WinPT is a front-end for the GNU Privacy Guard. It just provides |
WinPT is a front-end for the GNU Privacy Guard. It just provides |
31 |
a convinient interface to GPG while GPG does the actual (cryptographic) work. |
a convinient interface to GPG while GPG does the actual (cryptographic) work. |
45 |
it's like a real graphical GPG user interface. |
it's like a real graphical GPG user interface. |
46 |
|
|
47 |
|
|
48 |
4. Install |
Install |
49 |
---------- |
------- |
50 |
|
|
51 |
First you should install the GPG binary, version 1.4.x or later. |
First you should install the GPG binary, version 1.4.11 or later. |
52 |
(If you want to use a directory other than the default you must modify |
(If you want to use a directory other than the default you must modify |
53 |
the preferences in the WinPT program at Preferences->GPG Preferences). |
the preferences in the WinPT program at Preferences->GPG Preferences). |
54 |
|
|
55 |
Next, download the WinPT binary package from the Internet. You can find the |
Next, download the WinPT binary package from the Internet. You can find the |
56 |
latest WinPT version at http://www.winpt.org. Create a directory and |
latest WinPT version at http://wald.intevation.org/projects/winpt. |
57 |
extract all WinPT files from the archive. |
Create a directory and extract all WinPT files from the archive. |
58 |
|
|
59 |
|
|
60 |
4.1 Keyserver config file |
Keyserver Config File |
61 |
------------------------- |
--------------------- |
62 |
|
|
63 |
Now the keyserver config is read dynamically. That means there is a file |
Now the keyserver config is read dynamically. That means there is a file |
64 |
which WinPT reads the keyserver from. The name of this file MUST be |
which WinPT reads the keyserver from. The name of this file MUST be |
71 |
dialog in WinPT to keep this file consistent. |
dialog in WinPT to keep this file consistent. |
72 |
|
|
73 |
|
|
74 |
5. Verify the packet signature |
Verify the Packet Signature |
75 |
------------------------------ |
--------------------------- |
76 |
|
|
77 |
To verify that the source (or the binary) wasn't changed, you should |
To verify that the source (or the binary) wasn't changed, you should |
78 |
verify the package signature with GnuPG. For the process you will need |
verify the package signature with GnuPG. For the process you will need |
79 |
my OpenPGP public key. If you don't have it, please take a look at |
my OpenPGP public key. If you don't have it, please take a look at |
80 |
http://www.winpt.org/twoaday.asc |
http://www.stud.uni-hannover.de/~twoaday/twoaday.asc or fetch it |
81 |
|
via a keyserver (I suggest subkeys.pgp.net). |
82 |
|
|
83 |
# gpg --verify winpt-x.x.x-exe.zip.asc |
# gpg --verify winpt-x.x.x-exe.zip.asc |
84 |
# gpg --verify winpt-x.x.x-src.zip.asc |
# gpg --verify winpt-x.x.x-src.zip.asc |
90 |
0x27F36D14: 'Timo Schulz (Laptop Key) <[email protected]> |
0x27F36D14: 'Timo Schulz (Laptop Key) <[email protected]> |
91 |
|
|
92 |
|
|
93 |
6. Native language support |
Native Language Support (NLS) |
94 |
-------------------------- |
----------------------------- |
95 |
|
|
96 |
As a new feature WinPT now can handle multiple languages. To activate this |
As a new feature WinPT now can handle multiple languages. To activate this |
97 |
do the following: |
do the following: |
109 |
|
|
110 |
- Now WinPT runs in the language you have selected. |
- Now WinPT runs in the language you have selected. |
111 |
|
|
112 |
For the moment, WinPT supports these languages: |
For an overview what languages are supported take a look at |
113 |
|
Po/LINGUAS. It contains all actively maintained languages. |
|
* German winpt-de.mo |
|
|
* Japanese winpt-jp.mo |
|
114 |
|
|
115 |
If you are interested in translating WinPT in your native language, please |
If you are interested in translating WinPT in your native language, please |
116 |
let me know :-). It's not much work and you do NOT need to be a developer! |
let me know :-). It's not much work and you do NOT need to be a developer! |
117 |
|
|
118 |
|
|
119 |
7. Other documentation |
Other Documentation |
120 |
---------------------- |
------------------- |
121 |
|
|
122 |
For those who are inexperienced with GnuPG it makes sense to download the |
For those who are inexperienced with GnuPG it makes sense to download the |
123 |
GnuPG guide or a HOWTO. There are many sites for this, but you can start |
GnuPG guide or a HOWTO. There are many sites for this, but you can start |
128 |
http://www.gnupg.org |
http://www.gnupg.org |
129 |
|
|
130 |
General questions (look first at the topic point), can be sent to one of the |
General questions (look first at the topic point), can be sent to one of the |
131 |
mailing lists. All GnuPG lists are in English. |
mailing lists. |
132 |
|
|
133 |
GPG user list [email protected] |
GPG user list [email protected] |
134 |
GPG developer list [email protected] |
GPG developer list [email protected] |
137 |
future releases I will include HTML documentation. |
future releases I will include HTML documentation. |
138 |
|
|
139 |
|
|
140 |
8. Mailing lists |
Mailing Lists |
141 |
---------------- |
------------- |
142 |
|
|
143 |
If you want to get the latest information, reports, or discussions about |
If you want to get the latest information, reports, or discussions about |
144 |
WinPT you can subscribe to one of the WinPT mailing lists. There is a list |
WinPT you can subscribe to one of the WinPT mailing lists. There is a list |
150 |
is already answered there! |
is already answered there! |
151 |
|
|
152 |
|
|
153 |
9. Hotkey for common commands |
Hotkey for Common Commands |
154 |
----------------------------- |
-------------------------- |
155 |
|
|
156 |
WinPT supports shortcuts, or 'Hotkeys', for the main gpg commands. These |
WinPT supports shortcuts, or 'Hotkeys', for the main gpg commands. These |
157 |
keys are registered system wide, so you can use them from any window. If you |
keys are registered system wide, so you can use them from any window. If you |
170 |
so it's easier to figure out which hotkey caused the problem. |
so it's easier to figure out which hotkey caused the problem. |
171 |
|
|
172 |
|
|
173 |
10. Current window support |
Current Window Support |
174 |
-------------------------- |
---------------------- |
175 |
|
|
176 |
WinPT allows you to use the main operations (sign and encrypt) |
WinPT allows you to use the main operations (sign and encrypt) |
177 |
within the current window. This only works if the current window contains |
within the current window. This only works if the current window contains |
192 |
entry. I recommend to use it with the hotkeys until I fix this problem. |
entry. I recommend to use it with the hotkeys until I fix this problem. |
193 |
|
|
194 |
|
|
195 |
11. Word wrapping |
Word Wrapping |
196 |
----------------- |
------------- |
197 |
|
|
198 |
As a new feature, WinPT can wrap lines at a specific column. You can set |
As a new feature, WinPT can wrap lines at a specific column. You can set |
199 |
the value for this feature in the preferences dialog. If you don't want |
the value for this feature in the preferences dialog. If you don't want |
200 |
to use this feature, you only need to set the value to "0". |
to use this feature, you only need to set the value to "0". |
201 |
|
|
202 |
|
|
203 |
12. Default keyid for signing |
Default keyid for Signing |
204 |
---------------------------- |
------------------------- |
205 |
|
|
206 |
There are two ways to set the default keyid. The best solution is to |
There are two ways to set the default keyid. The best solution is to |
207 |
set the "default-key" entry in the GPG options file. |
set the "default-key" entry in the GPG options file. |
210 |
the secret key cache. |
the secret key cache. |
211 |
|
|
212 |
|
|
213 |
13. Commands |
File Manager |
214 |
------------ |
------------ |
215 |
|
|
|
|
|
|
13.1 Filemanager |
|
|
---------------- |
|
|
|
|
216 |
The filemanager is used to perform GPG operations on files. In further releases |
The filemanager is used to perform GPG operations on files. In further releases |
217 |
I'll add more commands. Currently, encrypt, decrypt, sign and verify |
I'll add more commands. Currently, encrypt, decrypt, sign and verify |
218 |
is available. To add a file to the list element, you can use drag & drop |
is available. To add a file to the list element, you can use drag & drop |
223 |
feel free to mail me about any bugs! |
feel free to mail me about any bugs! |
224 |
|
|
225 |
|
|
226 |
13.2 Keymanager |
Proxy Support |
|
--------------- |
|
|
|
|
|
13.2.1 Edit |
|
|
----------- |
|
|
|
|
|
Here you access some of the "edit-key" command from the GPG command |
|
|
line. |
|
|
|
|
|
|
|
|
13.2.3 Delete |
|
|
------------- |
|
|
|
|
|
With it you can delete public keys and/or key pairs. |
|
|
|
|
|
|
|
|
13.2.4 Sign |
|
|
----------- |
|
|
|
|
|
This is an interface to sign a public key. |
|
|
|
|
|
|
|
|
13.2.5 Revoke cert |
|
|
------------------ |
|
|
|
|
|
Generate a revocation certificate for the chosen key. |
|
|
|
|
|
|
|
|
13.2.7 Check sigs |
|
|
----------------- |
|
|
|
|
|
With this command you can check the signatures from a special public key. |
|
|
|
|
|
|
|
|
13.2.7 Key properties |
|
|
--------------------- |
|
|
|
|
|
This dialog is an easy way to get an overview about the given key. |
|
|
To activate this dialog, you've to double click on a key item in the |
|
|
key management dialog. Then a dialog with all related information about |
|
|
the selected key will open. |
|
|
|
|
|
|
|
|
13.3 Keyserver |
|
227 |
-------------- |
-------------- |
228 |
|
|
|
13.3.1 Keyserver searching |
|
|
-------------------------- |
|
|
|
|
|
This new feature works exactly like the normal keyserver support. |
|
|
You have to enter the pattern, then chose a keyserver. The command |
|
|
is started with the "Search" button. The next dialog contains all |
|
|
found keys from the keyserver. If you want, you can import a key |
|
|
from this list by select the key and press the "Receive" button. |
|
|
|
|
|
13.3.2 Proxy support |
|
|
-------------------- |
|
|
|
|
229 |
If you are not able to connect directly to the internet, you can |
If you are not able to connect directly to the internet, you can |
230 |
use the proxy settings. To enable proxy support, you need to start |
use the proxy settings. To enable proxy support, you need to start |
231 |
the keyserver dialog and use the "change" button to set a proxy. |
the keyserver dialog and use the "change" button to set a proxy. |
238 |
me if you've problems with your proxy server. |
me if you've problems with your proxy server. |
239 |
|
|
240 |
|
|
241 |
14. Debug mode |
Debug Mode |
242 |
-------------- |
---------- |
243 |
|
|
244 |
To make the detection of bugs and programming mistakes easier, WinPT |
To make the detection of bugs and programming mistakes easier, WinPT |
245 |
contains a built-in debug mode. |
contains a built-in debug mode. |
255 |
After an error has occured, it would be very useful to send this file to me. |
After an error has occured, it would be very useful to send this file to me. |
256 |
Which file you'll send depends on the occured error. Don't use the debug |
Which file you'll send depends on the occured error. Don't use the debug |
257 |
mode for your usual work; it slows down both GPG and WinPT. |
mode for your usual work; it slows down both GPG and WinPT. |
|
|
|
|
|
|
|
16. Features of the dialogs |
|
|
---------------------------- |
|
|
|
|
|
This sections contains hints about the special features of some dialogs. |
|
|
Currently this is only valid for dialog with listview controls. |
|
|
|
|
|
o Selection of an entry for the GPG main commands |
|
|
|
|
|
If you only want to select one recipient, you can also double click |
|
|
the line which the recipient you want to choose. Then the command |
|
|
is automatically invoked and you don't need to click the "OK" button. |
|
|
|
|
|
o Context menu for the key manager |
|
|
|
|
|
Now the keymanager supports a context menu. To activate it, you should |
|
|
click with the right mouse button on a selected item. |
|
|
|
|
|
o Generic keys known from the Explorer |
|
|
|
|
|
For example the key manager supports generic keys like: |
|
|
DELETE = secure the selected key. |
|
|
|
|
|
o Context menu for the file manager |
|
|
|
|
|
This popup menu is similar to the key manager menu. |
|
|
|
|