Installing wxSR Once you have downloaded the installer, simply run it. It will install wxSR and any files needed to run it in the directory of your choice. It will also produce a desktop icon for your convenience. Uninstalling wxSR In case you want to uninstall wxSR from your machine, simply run the uninstall entry from the start menu. All files, except the .INI and log file, if any, will be removed. If you decided to not use the program any longer, you can remove the whole entry, although in that case you would have to reconfigure the program again, if you decide to use it again later. Additional Software Requirements All OSes may will require you to install the Microsoft Visual C++ 2010 Redistributable Package (x86) from http://www.microsoft.com/en-us/download/confirmation.aspx?id=5555 This package installs MSCVP100.DLL & MSVCR100.dll Windows 8.x Due to lack of a Windows 8 system, wxSR has not been tested under Windows 8, though it is expected to install and run without problems. If you experience any issues, please contact the author. Windows 10 wxSR has been installed under Windows 10 and runs with the redistributable package installed. Running the Program: This information is also provided in the help system. First time setup. When you run wxSR for the first time, or if you delete or rename it's .INI file, you will need to enter some basic information needed for the program to run and do its job. As a minimum you will need to know: - SMTP server - the server which handles you e-main delivery; Either your ISP or sys admin should be able to help you with that. - the e-mail address you wish to use for feedback. This is needed so that whomever you send your SPAM report to has a way of contacting you for further information, if needed. Run the program and perform the following initial setup in order to provide enough information for the program to be able to fill in all of the required fields when you send a Spam report. 1. Click the New button at the top right corner of the window. 2. Fill in the blanks in the setup window for the mail server, 'from address', etc. The HELO string is the identity of the computer you are running the program on, as it will be reported to your mail server. If you need to use a port other than the standard SMTP port (25), change the port number. 3. If you want to use "Ticket Numbers", you can define their format in the "Next Report Number" window. Any combination of characters followed by some number of digits is valid. The trailing digits will be incremented after each SEND operation completes. 4. Optionally change the "Set Name:" edit box to some desirable setting, and click OK. 5. If you plan on using the program with any other identity settings, e.g. if you administer more than one domain, you may repeat the process. The currently selected configuration set may be changed by clicking the Edit button. All wxSR settings are saved in the INI file wxSR.ini which will reside in one of the data directories. The exact path depends on the OS. If you setup more than one identity for reporting SPAM, you can select which identity to use for sending e-mail from the drop- down box. Unwanted or unused identities can be deleted using the 'Delete" button. --------------------------------------------------------------------- OPTIONS Use the "Options" menu to configure the following items: The Options Dialog: Tooltip/Flyover Help: Just about everything on the program's window has a tool-tip hint associated with it, giving a brief explanation of its function when the mouse cursor is over it. If you find these as annoying as I do, uncheck the "Show Hints" box. Automatic Munge on Send: Check this box if you want to obfuscate the recipient's email address by replacing it with "*deleted*" in Received...for , X-Envelope-To:, Apparently-To:, and To: lines. If this box is not checked, Munge will not occur unless the "Munge" button is clicked. Include Report Number in Header: If this box is checked, each message will have a unique "Report Number" embedded in an "X-Report-No:" header line. The same number can be automatically added to inserted subject and body text, independent of this option, as described below. SMTP Debug Messages: If this box is checked, the status message window will show replies from the mail server and other information regarding the progress of the send mail transaction. This should normally be of interest only when it is necessary to diagnose problems sending mail. This option is automatically reset when the program is terminated. Insert Message Divider: If this box is checked, the string shown in the edit window to the right will be inserted between the message preamble and the message body. Color settings: wxSR currently only allows selection of the URL, E-Mail Address and 'Received' keywords in the message text. The string 'unknown' is also colored in purple, but this color is not changeable at present. --------------------------------------------------------------------- HOW TO USE IT The basic process is: 1. Copy the offending message with full headers from an email client to the clipboard, then click the "Paste" button below the message body window on wxSR. This will copy the message into the window. URLs, email addresses, the string 'unknown" and Received: keywords will be highlighted to assist you in locating them quickly. To paste the message, you can also click in the body of the window and press CTRL-V, but this won't trigger highlighting. 2. If you do not want the original recipient's email address to appear in the body of the report (and you aren't using the "Automatic Munge" option), click the "Munge" button. This will replace the e-mail address with "*deleted*" in Received..., for , X-Envelope-To:, Apparently-To:, and To: lines. wxSR will also munge the recipients name wherever it is found in the message. Any text in the message body that is highlighted when the "Munge" button is clicked will be replaced with "*deleted*". 3.If you wish, you may add some introductory text to the Message Preamble window The Preamble window is separate so that you can send multiple reports about the same original email to different destinations using different introductory text. This also allows you to "munge" the original message text without affecting the preamble material. 4. Set up the To: address, usually found from a lookup in a WhoIs client. 5. When the To:, Subject: and body are the way you want them to be, click the SEND button to dispatch the report to its destination. Report Numbers: In case you want to uniquely identify your outgoing messages, you should enter a number in the appropriate fields in the Sender configuration. This number can consist of an alpha and numeric trailing portion. The numeric portion will automatically be extracted and incremented each time a report is sent. The number can also be embedded in the message headers in an "X-Report-No:" header line in each message by checking the "Include Report Number in Header" option on the Options window. Differences between the ANSI build vs. the Unicode build. Initially, the program was intended to to remain a Unicode application. However, since that won't run on machines running other versions of Windows, and since the efforts to create an ANSI versionwas not excessive, an ANSI version is also currently provided, although it won't have the same priority as the Unicode version. There still are some differences, which so far appear to be more cosmetic than related to functionality. One is that some of the colring in the WhoIs data window, may be off by a few characters. Using WhoIs proxies. Initially it was intended to include a fully fucntional WhoIs client as a part of the program. However, using external proxies is far more efficient, since external proxies will more likely be updated than any internal client. Using external clients or proxies will also (very likely) include the additional benefit of more expertise in the WhoIs client area by their maintainers that I could acquire in a reasonable time ;-) The program distribution include only one external proxy - whois.geektools.com but I have found it more than adequate for the needs of wxSR. As an alternative I occasionally use the built-in WhoIS client installed on my Ubuntu box, connected to the same network as my WinXP boxes. If you know of other clients as proxies, you can add them as needed and use the ones you prefer. --------------------------------------------------------------------- DOMAIN SEARCH BOX not implemented yet --------------------------------------------------------------------- KNOWN PROBLEMS: besides unimplemented features in TESP, only: In the ANSI build WhoIs lookup 'Results field at for some sites the color highlighting is off by a few characters. Keyboard shortcut underscore does not show At times the keyboard shortcut underscore which identifies which keyboard key, if any, is available as a shortcut, fails to show. The problem is a Windows problem and the following link shows you how to fix this: http://www.winhelponline.com/blog/underline-keyboard-shortcuts-and-access-keys-in-windows-vista/