"Picture Sucker" and "Picture Sucker Pro" Automated News Download Programs for Windows 95/NT by L.P. Glaister Picture Sucker and Picture Sucker Pro are 32 bit multi-threaded Winsock and WIN32 compatible applications which execute on both Windows 95 and Windows NT platforms. These products were developed for the internet surfer who is a collector of fine internet artwork. These programs connect to any NNTP compatible news server and will automatically download UUENCODED pictures to your hard disk. The programs may be run minimized and will run concurrently while you are using your web browser, mail system, news readers or other internet applications. The user is able to configure the programs to select news articles for download using a variety of selection criteria. With over 16,000 news groups available and around 300 of them catering to the "visual crowd" you cannot afford to waste connect time with manually initiated downloads. The Picture Sucker family of software was developed in Visual C++ running under a multiprocessor version of Windows NT 3.51. "Picture Sucker Pro" has several advanced features: * windows listbox selection of newsgroups to search * history file to avoid duplicate downloads and crossposted articles * improved download statistics on the run screen * faster scanning of news groups for possible pictures * files are stored in a subdirectory to avoid accidental program deletion *** "Picture Sucker" will not operate correctly on Windows 3.x or 3.11. *** This is because Picture Sucker is written as a full 32 bit multi-threaded winsock compliant application. Multithreading is only supported under Windows 95 and Windows NT. The program searches a list of user programmable news groups looking for articles ranging in length of approximately 500 to 8500 lines in length (most good pictures fall in this range) with the subject line containing the strings "1/1" or "01/01" ( this avoids downloading partial pictures ). Several other tests may be optionally applied as a selection criteria for downloads. This version connects to a user specified news server and uses only low level news commands that should be supported by any NNTP server. Getting Started With Picture Sucker: 1. unzip the supplied file into any desired directory preferably on a hard disk with lots of free space. One overnite download may net 2000 pictures using about 200mb. You should have this file (help.txt) and sucker.exe. 2. You will have to use your news reader program and text editor to generate a file called groups.txt. A sample file is included with the Picture Sucker. Add or remove news groups as required from this file. 3. dial up your internet service provider via the dialup networking option in windows 95 or RAS in Windows NT. 4. when connected start sucker.exe 5. The setup window should appear. Fill in your news server IP address. This should look something like news.xyzcorp.com. Numeric fields for the IP address will not work. Normally, the rest of the fields default settings will be a good starting point. If your news server requires additional user authentication, check the "required" box and fill in the username and password supplied by your news service provider. Note: dont use this unless it is required. 6. From the main window just click on "start sucking" button. This will connect to your news server and display status in the main window areas on a regular basis. 7. You may exit the program at any time during downloading. Be sure to use the Close button, this will insure that all the history and setup files are stored properly on the hard drive. 8. Now that the program is setup, starting it again just requires starting sucker.exe and clicking on the Start Sucking button. Getting Started With Picture Sucker Pro: 1. unzip the supplied file into any desired directory preferably on a hard disk with lots of free space. One overnite download may net 2000 pictures using about 200mb. You should have this file (help.txt) and sucker.exe. 2. dial up your internet service provider via the dialup networking option in windows 95 or RAS in Windows NT. 3. when connected start sucker.exe 4. you will get a message warning that no subscribed news groups were found... this is normal until you get things setup. Click on OK. You will also be warned that no setup file was found, again this is all ok during intial installation. Click on OK, this will bring you to the setup window. 5. Fill in your news server IP address. This should look something like news.xyzcorp.com. Numeric fields for the IP address will not work. Normally, the rest of the fields default settings will be a good starting point. If your news server requires additional user authentication, check the "required" box and fill in the username and password supplied by your news service provider. Note: dont use this unless it is required. 6. Click on OK. This will take you to the main picture sucker window. Before you can download pictures, you will have to get a current list of news groups from the news server. 7. Click on the newsgroups button. This will advise you that you need to click on the "refresh list" button. So... doit. This may take a while as there are over 16000 news groups on some servers. The title bar will give you a blow by blow description of what is happening. You should see the left hand window fill up with a list of every newsgroup available from your news server. 8. After the groups are downloaded, the buttons will become enabled once again. Select the groups you wish to search for articles by double clicking on the group name in the left hand window, by highlighting a group of groups using the ctrl key and mouse clicks or by using the shift and arrow keys to select a group of groups. Once a group of groups is selected, it may be subscribed to or unsubscribed to be clicking on the --> or <-- buttons. The quickest way to get started is to just click on the Defaults--> button. This will scan the left hand window for groups of interesting subjects and will move the groups to the right hand subscribed window. Now click on OK. The groups will be stored in the newsrc file... this may take a few seconds to complete the write to the hard disk. 9. From the main window just click on "start sucking" button. This will connect to your news server and display status in the main window areas on a regular basis. 10. You may exit the program at any time during downloading. Be sure to use the Close button, this will insure that all the history and setup files are stored properly on the hard drive. 11. Now that the program is setup, starting it again just requires starting sucker.exe and clicking on the Start Sucking button. New Features: 6April96 * version indicated on title bar of main window * status window cleaned up on connection and disconnection to news server * new setup fields for those of you who have to use a user name and password to get access to your news server. * Connected To: window now shows "Nobody" when downloads are finished or have errored out. Pro 04May96 * contains dialog for interactively selecting news groups to be scanned * defaults button added news group selection dialog. This selects all groups from the unsubscribed window which contain "sex", "erotic", or "picture" * programmable number of downloaded history IDs keep around to avoid duplicate pictures. A count of cross posted articles or articles you have already downloaded (matching ID's in history window) is displayed as "duplicates skipped" in the Pictures window. Windows 95 maximum history selection should be limited to 32767 articles due to limit in the Windows 95 API. Under Windows NT, history is limited by Picture Sucker to numbers between 250 and 50000 downloaded articles. * download history is saved to disk every 50 pictures in case of power failures during prolonged downloads * program name which shows on toolbar when minimized is programmable for those that wish to run the program minimized while at work. Suggested title "4th Quarter Summary". * groups may now be subscribed or unsubscribed by double clicking on the individual group or by selecting a range of groups with the shift or control keys in conjunction with the arrow keys * pictures are now downloaded and stored in the subdirectory "pictures". This should help prevent the unwanted deletion of Picture Sucker Pro. * percentages are now displayed for progress through: groups, articles, and download of a particular article. * pictures that fail uudecode are saved in their raw text form in files with names like WTF008E0ACC.TXT in the pictures subdirectory. These may be decoded with other external decoders (such as base64) that are not yet supported by Picture Sucker Pro. The number of these files generated is listed on the run screen as "unknown format". * Typical performance with a 28.8 modem and a good news server connection is around 2000 pictures downloaded overnite. Questions and Answers: Q: where can I get the lastest copy of the free "Picture Sucker"? A: either by email request from glaister@nanaimo.ark.com or at ftp://ftp.infusion.de/pub/win95/sucker.zip or at http://nanaimo.ark.com/~glaister Q: how can I download files with different extensions? A: you can turn off the option to check for jpg and gif files and it will then download anything that matches the rest of the options. Q: how do I download multipart files? A: multipart files are really difficult.... I gave up on them because it seemed that at least 1 piece was missing from the currently posted news articles. You will get more pictures than you can ever look at without wasting time on the multipart files. Use your news reader to manually download the multiple part files if you really need them. Q: how do I tell if I need to set up the user name and password? A: Try with the authorization option not checked. If you see something like "480 Authentication Required for Command" in the message status window then you need to check the Required box on the setup screen and enter you news server user name and password. (the items are usually supplied to you by your internet service provider). Q: how do I decode this file to get the file sucker.exe? A: Most mail programs have a decode option available. If not, use your mail program to save this message as a text file. Then you can use a program called uudecode to unpack the following section. If all this escapes you, send me a message and I will try sending you the executable directly as a mail attachment. Q: what files are required to run "Picture Sucker" A: at a bare minimum, you need sucker.exe and groups.txt. If the program doesnt find the .ini file, it will present you with the setup window and will create the file with your choices. If you have "Picture Sucker Pro", all you need is the sucker.exe. The rest will be generated once you setup the IP address of your news server and refresh the list of news groups. Q: what is the file format and content of groups.txt? A: this file is a list of all the news groups that you wish to search for potential news articles fitting your selection criteria. It is formated as a text file with each news group listed on a separate line. (groups.txt is not used by Picture Sucker Pro, instead, the list of all groups, subscribed or otherwise is stored in a file called newsrc) for example: alt.binaries.pictures.nudism alt.binaries.erotic.senior-citizens alt.binaries.pictures.erotic.senior-citizens alt.binaries.pictures.black.erotic.females alt.binaries.pictures.erotic.anime alt.binaries.pictures.erotica alt.binaries.pictures.erotica.amateur.female alt.binaries.pictures.erotica.art.pin-up alt.binaries.pictures.erotica.autos alt.binaries.pictures.erotica.balls alt.binaries.pictures.erotica.bears alt.binaries.pictures.erotica.bestiality alt.binaries.pictures.erotica.black.females alt.binaries.pictures.erotica.black.male alt.binaries.pictures.erotica.blondes alt.binaries.pictures.erotica.bondage alt.binaries.pictures.erotica.breasts Groups.txt should be in the same directory as sucker.exe. Use your existing news reader to locate groups that you want to download pictures from and add these group names to groups.txt with one group per line. You need to put at least 1 group name in groups.txt. Q: how come I don't get any pictures when I run the program? A: If your news provider is selectively censoring your news groups, you may find that none of the groups listed in the groups.txt file are available from your news provider. Try using your regular news reader (winvn, netscape etc) to search for groups that contain the material you wish to automatically download. Make sure these groups are listed in the groups.txt file. If all else fails, try looking for a public news provider that carries the groups you are interested in. I found a good list using my WEB browser and searching for NNRP. Q: where do the pictures that are downloaded get stored? A: in the current directory, (the same one that contains sucker.exe) Picture Sucker Pro stores all its downloaded files in a subdirectory called "pictures". Q: how do I view these pictures? A: use a jpeg or gif viewer. There are many different ones available on the net. I like LVIEW as it has lots of interesting editing features available. Q: how can I order a version of "Picture Sucker Pro"? A: "Picture Sucker" (free version) is available from several sites listed above. For the enhanced "Picture Sucker Pro" send a postal money order or personal check for $19.95US to: L. P. Glaister Box 64 - Madrona Drive RR #1 Nanoose Bay B.C. Canada V0R 2R0 Please include your email address and media desired. The preferred method of distribution is via email but I can arrange to send the program on floppy if you need the media. Updates will be supplied via email only. Q: Does it matter if I am using Win 95 with dial up networking to access my Internet provider? DU networking is 32 bit. A: This will work just fine. Dialup networking under Windows 95 and RAS under Windows NT are the most common connections. For those lucky enough to have a direct internet connection, this should also work. Q: Can a news provider block use of this program? A: As far as a news server is concerned, this program looks just like a news reading program. If you can download pictures using winvn, free agent or netscape, or another generic NNTP news reader, picture sucker should work. To the news server, it looks like you are a very fast reader who stays up all night reading news in the alt.binaries groups. :} Q: Does "pix_suck.ini" need to be in the windows directory? A: No, everything stays in one directory... If you want to give it to a friend, just give them everything in the directory. (you dont need to give them pix_suck.ini as this may contain your username and password for news server access). Q: When I go to the Main Screen I cannot type in any of the options such as NewsGroup, News Server, etc. Am I doing something wrong? A: The main window consists of status displays only. These are used to indicate the progress of picture sucker during the download process. If you press the SETUP button on the main screen, you will get the setup screen. This is where you need to enter the IP address of your news provider. The default settings for the rest of the check boxes should work as a starting point. You may need to check the Required Box and enter a news server username and password (see question above) but most news servers allow access to local users without this extra authorization. Q: How can I tell if the program is working and downloading pictures? A: You should see a message like "line 243 of 723 ( 33% )" that increments every few seconds until it gets to 100%. This indicates that the article was downloaded. If the decode option is checked, picture sucker will attempt to uudecode the file into whatever the original filename was listed as. The file will be placed in the same directory as the sucker.exe. If the file is not uuencoded (netscape encodes files in a format called base64) then no output file (or an empty file) may result. Keep trying, most of the pictures on the news servers I have access to are uuencoded. In the Picture Sucker Pro, files that cannot be decoded by uudecode will be stored in their original format with file names like WTF003DF.TXT. You can then try and decode these using other decoding programs available off the net.