1ubh - The Usenet Binary Harvester 2 3README 4 5------------------------------------------------------------------------------ 6 71.0 Introduction 8 9 ubh - the Usenet Binary Harvester - is a GPL'ed Perl console 10 application which automatically discovers, downloads, and decodes 11 single-part and multi-part Usenet binaries. Automatically assembles 12 multi-part binaries. Provides searching via Perl regular expression 13 syntax. Also provides a pre-selection capability whereby the user can 14 interactively choose which binaries to download. Uses a standard 15 .newsrc file to control which groups and articles to process. 16 Runs anywhere Perl runs. Tested under Unix-based Perl, Active Perl 17 on Win32 platforms, and Mac OS X. Requires Net::NNTP and News::Newsrc 18 (which itself requires Set::IntSpan), MIME::Parser, MIME::Base64, 19 IO::Stringy, and MailTools (distribution). 20 21 Send comments, questions, suggestions, and bug reports to 22 gerard 'at' users.sourceforge.net. 23 24 252.0 Requirements 26 27 ubh runs anywhere Perl runs. You will need the following modules 28 on your system: 29 30 Net::NNTP (part of the libnet distribution) 31 32 News::Newsrc 33 34 Set::IntSpan (not used directly, required by News::Newsrc) 35 36 MIME::Parser (from the MIME-tools distribution) 37 38 MIME::Base64 39 40 IO::Stringy 41 42 The MailTools distribution 43 44 453.0 Getting Started 46 47 Here is a set of steps to get ubh up and running: 48 49 1. Un-zip/un-tar the distribution. 50 51 2. Decide which newsgroups you wish to process. In the top-level 52 ubh directory, create a text file called ".newsrc" (just "newsrc" 53 on Windows systems). List the groups you wish to process, 54 one per line, followed by a colon. For example - 55 56 alt.binaries.sounds.mp3.1990s: 57 alt.binaries.pictures.autos: 58 59 3. Create a text file called ".ubhrc" (just "ubhrc" on Windows 60 systems). Specify the name of your news server. If your 61 server requires an account name and a password, you must 62 specify these. Make sure the NEWSRCNAME matches the file 63 name you used in the previous step. 64 65 NNTPSERVER = news 66 NEWSRCNAME = .newsrc 67 DATADIR = data 68 MULTI_EXT = (?i)asf|avi|gif|jpg|mov|mpg|rm 69 SINGLE_EXT = (?i)asf|avi|gif|jpg|mov|mpg|rm 70 # ACCOUNT = fred 71 # PASSWORD = flint+stone 72 73 4. Make the top-level ubh directory be your current working 74 directory. Invoke the ubh program 75 76 Windows: perl ubh 77 Unix: ./ubh 78