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