The Tiny WinPT FAQ. Version 1.0 Last modified May 22, 2006 Initial version created by Rich Wielgosz ----------------------------------------------------------------- 1. General 1.1 What is WinPT? 2. Information Sources 2.1 Where can I download WinPT? 2.2 Where can I get more information about WinPT? 2.3 Does WinPT require anything else to work? 3. Usage 3.1 How do I use WinPT? 4. Problem and errors 4.1 WinPT wouldn't let me register a hotkey. Why not? 4.3 People can't verify my signatures. Why? 4.4 I get a "no data" error when trying to decrypt text. How come? 4.5 What is "Debug Mode" ? 4.6 Why isn't "Current Window" mode working properly for me? ----------------- 1. General 1.1 Q: What is WinPT? A: WinPT is a "Frontend" which allows access to the Gnu Privacy Guard (GnuPG) encryption engine. WinPT is a Windows application which resides in the System Tray and "mimics" the look and feel of another popular System Tray application. WinPT contains no crypto routines so it may be exported freely to any country in the world. WinPT is in essence, a universal plug-in for all email programs because it allows you to cut and paste from any email application, and encrypt the data while it resides in your clipboard. WinPT also has a built-in file browser for the encryption of files on your harddrive. WinPT will also handle all of your key-management and key-server access needs. 2. Information Sources 2.1 Q: Where can I download WinPT? A: WinPT can be downloaded from the WinPT.org website or via http://wald.intevation.org (section: Files) 2.2 Q: Where can I get more information? A: There is always more info to be had at the WinPT.org website. You can also get more information from the winpt-users mailing list. To subsribe to this list visit wald.intevation.org (section: Lists). 2.3 Q: Does WinPT require anything else to work? A: WinPT requires that you have installed the Gnu Privacy Guard (GnuPG) encryption engine version 1.4.3 or greater, for Win32. 3. Usage 3.1 Q: How do I use WinPT? A: The use of WinPT is VERY straightforward, and it is beyond the scope of this document to detail all of its many features. For more information consult the included manual and see the WinPT DOC page. 4. Problems and Errors 4.1 Q: WinPT tells me "Couldn't register hotkey" - What does it mean and how can I fix it? A: This is because another application has already installed those hotkey definitions. It's also possible that in an NT/Win2K environment you need admin privs to redefine hotkeys. (This we're not entirely sure of, does anyone know if this is true?). You can redefine your hotkeys to something that is available (or more to your liking) by selecting "preferences" from the WinPT menu and changing them there. The default Hotkey definitions are: Encrypt Clipboard: CTRL+ALT+E Decrypt/verify Clipboard: CTRL+ALT+D Sign Clipboard: CTRL+ALT+S Export to clipboard: CTRL+ALT+X Import from clipboard: CTRL+ALT+I Encrypt current window: ALT+SHIFT+E Decrypt/verify current window: ALT+SHIFT+D Sign current window: ALT+SHIFT+S Please note that the "Export to clipboard" and "Import from clipboard" hotkeys can not be redefined. 4.3 Q: Why are people having trouble verifying my signatures in the email that I send them? A: That is very likely because your email is wrapping the text of your signature in a place it isn't supposed to, therein "breaking" your signature. WinPT solves this problem with a "Wordwrap" feature of its own. This breaks the lines BEFORE signing and as a result won't break your signatures. This feature can be found under the PREFERENCES option of the WinPT menu. The biggest useable value to put in that field (from what they tell me) is 76. To disable the feature put in a '0' (zero). 4.4 Q: I can't decrypt text (error: No Data), but the clipboard is set with valid GPG data. A: Check your line endings and for broken lines. The easiest way to do this is to use the 'Edit Clipboard' option in the WinPT menu and look at the text. This used to happen to me quite frequently when I was using the mailer that was built into the Opera web browser (Don't misunderstand, we LOVE Opera). All you need to do it edit the Open-PGP message so that its LAYOUT looks like this: -----BEGIN PGP MESSAGE----- Version: GnuPG v1.0.6 (MingW32) - WinPT 10.3.0 Comment: See http://www.gnupg.org/ hQIOA5K/4SdC8KCgEAf/ej46PTbHQ7CA8MvtYyTYtivJ4hQ6oo//V2aHsl6/E/HK u81oJzop7QzCvK1CLjzK4hqhlZZYb07s/2n40zBSvy4apGVas6DxfpqoX2SFFlnC 5wqvNt8BekM3w9JIKsfGj2x5E/xMe0slJUegiiBkUup0BtzcGJB7Yzpts1FSE/QM wFzJLiyTJ4m5XOMLEvnNS9U3PjWXyzlNWG3RNtyCHCLG/ovV3oGR1H+TCVBOmuft NhfSHau4jKSffjShWWB5pMIxE7ZrHtJT838Ch57VR8oamZbszmtQo+gLg83ip8Er QrpxiTuFLu/l5+0YUDjZN6nYPSNbbGDDdTYSbjF1VwgAxR1er7hw3FysrS0j7yBB ZHiT+O6VZzcXUZMO1UsbZSf5htrS2t6Qf13DAoYahBFJCUWVCRxLprutKRyqy/KZ U2p//gvXfoalDLJZNGwBXXvNodkt3kzzGjT5DxREEYuHPMlrsZ8RABeaEzlTuBDD O6y6Sk0Qc72FJlQO2jP82wCOQTKvxX5QpJmUHVC4er5Hzkd8FNMbMlbGwV9zyvQW PUPyT3llHIuv8FLHyBLr60nmJYBAbA1Wy5vYaGyhRS8NwQQbIR5cVBRDs0f5mv8= =c5uG -----END PGP MESSAGE----- ...and not like this (or some other similarly mangled way): -----BEGIN PGP MESSAGE----- Version: GnuPG v1.0.6 (MingW32) - WinPT 10.3.0 Comment: See http://www.gnupg.org/hQIOA5K/4SdC8KCgEAf/ej46P TbHQ7CA8MvtYyTYtivJ4hQ6oo//V2aHsl6/E/HK u81oJzop7QzCvK1CLjzK4hqhlZZYb07s/2n40zBSvy4apGVas6DxfpqoX2SFFlnC 5wqvNt8BekM3w9JIKsfGj2x5E/xMe0slJUegiiBkUup0BtzcGJB7Yzpts1FSE/QM wFzJLiyTJ4m5XOMLEvnNS9U3PjWXyzlNWG3RNtyCHCLG/ovV3oGR1H+TCVBOmuft NhfSHau4jKSffjShWWB5pMIxE7ZrHtJT838Ch57VR8oamZbszmtQo+gLg83ip8Er QrpxiTuFLu/l5+0YUDjZN6nYPSNbbGDDdTYSbjF1VwgAxR1er7hw3FysrS0j7yBB ZHiT+O6VZzcXUZMO1UsbZSf5htrS2t6Qf13DAoYahBFJCUWVCRxLprutKRyqy/KZ U2p//gvXfoalDLJZNGwBXXvNodkt3kzzGjT5DxREEYuHPMlrsZ8RABeaEzlTuBDD O6y6Sk0Qc72FJlQO2jP82wCOQTKvxX5QpJmUHVC4er5Hzkd8FNMbMlbGwV9zyvQW PUPyT3llHIuv8FLHyBLr60nmJYBAbA1Wy5vYaGyhRS8NwQQbIR5cVBRDs0f5mv8= =c5uG -----END PGP MESSAGE----- It's also important to make sure that there are 5 '-' characters before and after the 'Begin PGP Message', and 'End PGP Message' tags. 4.5 Q: What is "Debug Mode"? A: Debug Mode is a mode of operation built into WinPT which causes WinPT to output error code to two files on your harddisk. If WinPT crashes, take these debug files, zip them up with a compression utility, and mail them to Timo with a detailed explanation of what happened. One file is in the same directory as your WinPT executable and is called "gpgme.dbg". The other file is called "winpt.log" and can be found in your C:\$USER\TEMP directory. If you can't find the "winpt.log" file don't worry, sometimes it isn't generated, but "gpgme.dbg" is always generated. To enable debug mode in WinPT use the "--enable-debug" switch on the command line when invoking WinPT. If you've set up WinPT to run from an icon, right-click on the WinPT icon and select "properties," then select the "shortcut" tab and type "--enable-debug" (without quotes) in the end of the "Target" field. Be sure there is a space between the last character of what was originally in that field, and what you add. 4.6 Q: Why isn't "Current Window" mode working properly for me? A: Current Window mode works better with the hotkeys, so try using them first. Currently not all window types are supported, so in some cases it might not work at all (we're working on that). If this mode does not work the first time, merely try it again a second time. If it still does not work then the window you're trying to operate on is an unsupported type, and this will be addressed with a future release. Q: Why in an earlier example does it say there's a version 10.3.0 of WinPT? A: Because I'm pulling your leg. :-) -------------