ubh - The Usenet Binary Harvester README ------------------------------------------------------------------------------ 1.0 Introduction ubh - the Usenet Binary Harvester - is a GPL'ed Perl console application which automatically discovers, downloads, and decodes single-part and multi-part Usenet binaries. Automatically assembles multi-part binaries. Provides searching via Perl regular expression syntax. Also provides a pre-selection capability whereby the user can interactively choose which binaries to download. Uses a standard .newsrc file to control which groups and articles to process. Runs anywhere Perl runs. Tested under Unix-based Perl and Active Perl on Win32 platforms. Requires Net::NNTP and News::Newsrc (which itself requires Set::IntSpan). Send comments, questions, suggestions, and bug reports to gerard@users.sourceforge.net. 2.0 Requirements ubh runs anywhere Perl runs. You will need the following modules on your system: Net::NNTP (part of the libnet distribution) News::Newsrc Set::IntSpan (not used directly, required by News::Newsrc) 3.0 Getting Started Here is a set of steps to get ubh up and running: 1. Un-zip/un-tar the distribution. 2. Decide which newsgroups you wish to process. In the top-level ubh directory, create a text file called ".newsrc" (just "newsrc" on Windows systems). List the groups you wish to process, one per line, followed by a colon. For example - alt.binaries.sounds.mp3.1990s: alt.binaries.pictures.autos: 3. Create a text file called ".ubhrc" (just "ubhrc" on Windows systems). Specify the name of your news server. If your server requires an account name and a password, you must specify these. Make sure the NEWSRCNAME matches the file name you used in the previous step. NNTPSERVER = news NEWSRCNAME = .newsrc DATADIR = data MULTI_EXT = (?i)asf|avi|gif|jpg|mov|mpg|rm SINGLE_EXT = (?i)asf|avi|gif|jpg|mov|mpg|rm # ACCOUNT = fred # PASSWORD = flint+stone 4. Make the top-level ubh directory be your current working directory. Invoke the ubh program Windows: perl ubh.pl Unix: ./ubh
