ZetaBoards topic fetcher 1.8.5.

http://i-know-nothing.co.cc/ZetaBoards_topic_fetcher

    LICENSE

Licensed under the GNU General Public License, version 3; if this was not
included, you can find it here:
    http://www.gnu.org/licenses/gpl-3.0.txt

    INSTALLATION

(On Windows, there's no installation process, but you'll have to give
zb-fetcher a '.py' extension before running anything.)

To build on Unix-like systems, with bash, sed, gzip, find, GNU make or
equivalent, gettext and po4a, run

    ./configure
    make

Then to install, run (probably as root; the DESTDIR argument is supported)

    make install

This step can be skipped if you just want to run it in-place.  To uninstall,
run (probably as root; again using DESTDIR as necessary)

    make uninstall

Other supported make targets are 'clean' and 'distclean'.

    DEPENDENCIES

Python: http://www.python.org; version 2.6 or later 2.x
PycURL: http://pycurl.sourceforge.net
PyGTK: http://www.pygtk.org (for the optional GUI); at least version 2.6

    USAGE

To launch the GUI, run

    zb-fetcher gui

For help with the CLI, run

    zb-fetcher --help

or, on Unix-like OSs, once installed,

    man zb-fetcher

On Windows, prepend 'python ' to each of these; there's no installation
process, so you'll have to navigate to the source directory first.

    NOTES

The 'forum' argument in all cases is the whole of the URL without the protocol
prefix (http://), up to and not including the '/index/' when viewing the forum
index, without a trailing slash.  If this is s1.zetaboards.com/IDENTIFIER, you
can just use IDENTIFIER.

Note that, since the HTML for the part of the forum that indicates whether a
subforum or topic has new posts is completely customisable, this program cannot
possibly identify which have new posts with absolute certainty.  If some HTML
extract is used for both read and unread states, either for the same
topic/forum or for different ones, identifying new posts in those topics/forums
is done wrongly.

Similarly, it is impossible to tell whether a topic is locked in certain
situations; the current method used is checking for the quickpost form, but
this can be disabled for topics in any state.  More information can be found
here: http://if.invisionfree.com/topic/5100633/

ZetaBoards forums do not differentiate between locked topics and locked topics
with new posts, so this program will miss posts made between the last check
and when a topic is locked, and posts made by those with sufficient rights
after a topic has already been locked. 

A note regarding the 'appear offline' option in both CLI and GUI: it is
possible to disable this feature at ZetaBoards forums, and so this may not
work.  Also note that admins can see 'invisible' users.

    CUSTOM ICONS

To create a custom icon set to replace the displayed status icons, you need
five images:

    new.png         - new posts
    old.png         - no new posts
    work.png        - currently fetching
    disabled.png    - fetching is disabled
    error.png       - an error is queued up

Each of these should be square, and at least 30 pixels.  There is no need for
size consistency, but it's always nice.

Next, create a file called 'data' containing the name of the icon set.  For
consistency, this should be lowercase, quite short, and not contain any
characters not allowed in filenames for any of the program's target OSs.

Place the images and text file in a tar archive, optionally with gzip or bz2
compression, and you're done.