File	Date	Author	Commit
images	2015-05-16	martydem	[c6502b] Initial commit
AvailableGroupsView.cpp	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
AvailableGroupsView.h	2015-05-16	martydem	[c6502b] Initial commit
COPYING	2015-05-16	martydem	[c6502b] Initial commit
HeaderBase.cpp	2015-05-16	martydem	[c6502b] Initial commit
HeaderBase.h	2015-06-18	martydem	[7d0624] Further memory management changes
INSTALL	2015-08-01	martydem	[e3801c] Updated for code release
IdListWidgetItem.cpp	2015-05-16	martydem	[c6502b] Initial commit
IdListWidgetItem.h	2015-05-16	martydem	[c6502b] Initial commit
JobList.cpp	2015-05-16	martydem	[c6502b] Initial commit
JobList.h	2015-05-16	martydem	[c6502b] Initial commit
MultiPartHeader.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
MultiPartHeader.h	2015-05-16	martydem	[c6502b] Initial commit
Quban.pro	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
QueueScheduler.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
QueueScheduler.h	2015-05-16	martydem	[c6502b] Initial commit
README	2015-08-01	martydem	[e3801c] Updated for code release
RawHeader.cpp	2015-05-16	martydem	[c6502b] Initial commit
RawHeader.h	2015-05-16	martydem	[c6502b] Initial commit
SaveQItems.cpp	2015-06-23	martydem	[fc8e0b] Improved memory management and thread sync arou...
SaveQItems.h	2015-05-16	martydem	[c6502b] Initial commit
SinglePartHeader.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
SinglePartHeader.h	2015-05-16	martydem	[c6502b] Initial commit
about.cpp	2015-07-18	martydem	[ba27d7] Adding Operating System details to 'About' dialog
about.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
about.ui	2015-07-21	martydem	[6fb076] Fixed problem with header download sticking bec...
addschedule.cpp	2015-05-16	martydem	[c6502b] Initial commit
addschedule.h	2015-05-16	martydem	[c6502b] Initial commit
addschedule.ui	2015-05-16	martydem	[c6502b] Initial commit
addserver.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
addserver.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
addserver.ui	2015-05-16	martydem	[c6502b] Initial commit
addserverwidget.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
addserverwidget.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
addserverwidget.ui	2015-05-16	martydem	[90f700] Started introduction of SSL protocol - to allow...
appConfig.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
appConfig.h	2015-06-14	martydem	[fab6e4] Started more efficient memory management for he...
articlefilterdialog.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
articlefilterdialog.h	2015-05-16	martydem	[c6502b] Initial commit
articlefilterdialog.ui	2015-05-16	martydem	[c6502b] Initial commit
autounpackconfirmation.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
autounpackconfirmation.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
autounpackconfirmation.ui	2015-05-16	martydem	[c6502b] Initial commit
availablegroups.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
availablegroups.h	2015-05-16	martydem	[c6502b] Initial commit
availablegroupswidget.cpp	2015-05-16	martydem	[c6502b] Initial commit
availablegroupswidget.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
availablegroupswidget.ui	2015-05-16	martydem	[c6502b] Initial commit
binheader.cpp	2015-05-16	martydem	[c6502b] Initial commit
binheader.h	2015-05-16	martydem	[c6502b] Initial commit
bulkDelete.cpp	2015-06-23	martydem	[fc8e0b] Improved memory management and thread sync arou...
bulkDelete.h	2015-05-16	martydem	[c6502b] Initial commit
bulkHeaderGroup.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
bulkHeaderGroup.h	2015-07-05	martydem	[261f6a] Initial version of Advanced Header Grouping ......
bulkLoad.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
bulkLoad.h	2015-06-21	martydem	[94e60c] Revised bulk header loading
catman.cpp	2015-05-16	martydem	[c6502b] Initial commit
catman.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
catman.ui	2015-05-16	martydem	[c6502b] Initial commit
common.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
common.h	2015-06-28	martydem	[6d62d3] Safer deletion policy
decodeManager.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
decodeManager.h	2015-05-16	martydem	[c6502b] Initial commit
decoder.cpp	2015-05-16	martydem	[c6502b] Initial commit
decoder.h	2015-06-18	martydem	[7d0624] Further memory management changes
downloadselect.cpp	2015-05-16	martydem	[c6502b] Initial commit
downloadselect.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
downloadselect.ui	2015-05-16	martydem	[c6502b] Initial commit
droptree.cpp	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
droptree.h	2015-05-16	martydem	[c6502b] Initial commit
expireDb.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
expireDb.h	2015-05-16	martydem	[c6502b] Initial commit
fileviewer.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
fileviewer.h	2015-05-16	martydem	[c6502b] Initial commit
grouplist.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
grouplist.h	2015-05-16	martydem	[c6502b] Initial commit
groupprogress.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
groupprogress.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
groupprogress.ui	2015-05-16	martydem	[c6502b] Initial commit
header.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
header.h	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
headerGroup.cpp	2015-06-23	martydem	[fc8e0b] Improved memory management and thread sync arou...
headerGroup.h	2015-07-05	martydem	[261f6a] Initial version of Advanced Header Grouping ......
headerLoad.cpp	2015-05-16	martydem	[c6502b] Initial commit
headerLoad.h	2015-05-16	martydem	[c6502b] Initial commit
headerQueue.h	2015-05-16	martydem	[c6502b] Initial commit
headerReadNoCompression.cpp	2015-06-28	martydem	[6d62d3] Safer deletion policy
headerReadNoCompression.h	2015-05-16	martydem	[c6502b] Initial commit
headerReadWorker.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
headerReadWorker.h	2015-06-23	martydem	[fc8e0b] Improved memory management and thread sync arou...
headerReadXfeatGzip.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
headerReadXfeatGzip.h	2015-06-23	martydem	[fc8e0b] Improved memory management and thread sync arou...
headerReadXzVer.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
headerReadXzVer.h	2015-06-23	martydem	[fc8e0b] Improved memory management and thread sync arou...
headergroupingwidget.cpp	2015-05-16	martydem	[c6502b] Initial commit
headergroupingwidget.h	2015-05-16	martydem	[c6502b] Initial commit
headergroupingwidget.ui	2015-07-05	martydem	[261f6a] Initial version of Advanced Header Grouping ......
headergrouptestdialog.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
headergrouptestdialog.h	2015-07-05	martydem	[261f6a] Initial version of Advanced Header Grouping ......
headergrouptestdialog.ui	2015-05-16	martydem	[c6502b] Initial commit
headerlist.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
headerlist.h	2015-07-05	martydem	[261f6a] Initial version of Advanced Header Grouping ......
headerlistwidget.cpp	2015-05-16	martydem	[c6502b] Initial commit
headerlistwidget.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
headerlistwidget.ui	2015-05-16	martydem	[c6502b] Initial commit
helpdialog.cpp	2015-05-16	martydem	[c6502b] Initial commit
helpdialog.h	2015-05-16	martydem	[c6502b] Initial commit
helpdialog.ui	2015-05-16	martydem	[c6502b] Initial commit
hlistviewitem.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
hlistviewitem.h	2015-06-14	martydem	[fab6e4] Started more efficient memory management for he...
logAlertList.cpp	2015-06-28	martydem	[6d62d3] Safer deletion policy
logAlertList.h	2015-05-16	martydem	[c6502b] Initial commit
logEventList.cpp	2015-05-16	martydem	[c6502b] Initial commit
logEventList.h	2015-05-16	martydem	[c6502b] Initial commit
main.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
maintabwidget.cpp	2015-05-16	martydem	[c6502b] Initial commit
maintabwidget.h	2015-05-16	martydem	[c6502b] Initial commit
newsgroup.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
newsgroup.h	2015-07-05	martydem	[261f6a] Initial version of Advanced Header Grouping ......
newsgroupcontents.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
newsgroupcontents.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
newsgroupcontents.ui	2015-05-16	martydem	[c6502b] Initial commit
newsgroupdetail.cpp	2015-05-16	martydem	[c6502b] Initial commit
newsgroupdetail.h	2015-05-16	martydem	[c6502b] Initial commit
newsgroupdetail.ui	2015-05-16	martydem	[c6502b] Initial commit
newsgroupdialog.cpp	2015-07-05	martydem	[261f6a] Initial version of Advanced Header Grouping ......
newsgroupdialog.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
newsgroupdialog.ui	2015-05-16	martydem	[c6502b] Initial commit
nntphost.cpp	2015-06-28	martydem	[6d62d3] Safer deletion policy
nntphost.h	2015-05-17	martydem	[271962] Added changes to support choice of SSL protocol.
nntpthreadsocket.cpp	2015-07-21	martydem	[6fb076] Fixed problem with header download sticking bec...
nntpthreadsocket.h	2015-05-16	martydem	[c6502b] Initial commit
nzbform.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
nzbform.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
nzbform.ui	2015-05-16	martydem	[c6502b] Initial commit
pendingoperations.cpp	2015-05-16	martydem	[c6502b] Initial commit
pendingoperations.h	2015-05-16	martydem	[c6502b] Initial commit
prefdecode.cpp	2015-05-16	martydem	[c6502b] Initial commit
prefdecode.h	2015-05-16	martydem	[c6502b] Initial commit
prefdecode.ui	2015-05-16	martydem	[c6502b] Initial commit
prefdialog.cpp	2015-05-16	martydem	[c6502b] Initial commit
prefdialog.h	2015-05-16	martydem	[c6502b] Initial commit
prefdialog.ui	2015-05-16	martydem	[c6502b] Initial commit
prefgeneral.cpp	2015-05-16	martydem	[c6502b] Initial commit
prefgeneral.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
prefgeneral.ui	2015-05-16	martydem	[c6502b] Initial commit
prefstartup.cpp	2015-05-16	martydem	[c6502b] Initial commit
prefstartup.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
prefstartup.ui	2015-05-16	martydem	[c6502b] Initial commit
prefunpack.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
prefunpack.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
prefunpack.ui	2015-05-16	martydem	[c6502b] Initial commit
prefunpackexternal.cpp	2015-05-16	martydem	[c6502b] Initial commit
prefunpackexternal.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
prefunpackexternal.ui	2015-05-16	martydem	[c6502b] Initial commit
prefview.cpp	2015-05-16	martydem	[c6502b] Initial commit
prefview.h	2015-05-16	martydem	[c6502b] Initial commit
prefview.ui	2015-05-16	martydem	[c6502b] Initial commit
qmgr.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
qmgr.h	2015-05-16	martydem	[c6502b] Initial commit
qnzb.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
qnzb.h	2015-05-16	martydem	[c6502b] Initial commit
quban.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
quban.h	2015-06-11	martydem	[232864] Fixed memory leaks
quban.qrc	2015-05-16	martydem	[c6502b] Initial commit
quban.ui	2015-05-16	martydem	[c6502b] Initial commit
qubanDbEnv.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
qubanDbEnv.h	2015-05-16	martydem	[c6502b] Initial commit
qubanwizard.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
qubanwizard.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
qubanwizard.ui	2015-06-14	martydem	[fab6e4] Started more efficient memory management for he...
queueparts.cpp	2015-06-28	martydem	[6d62d3] Safer deletion policy
queueparts.h	2015-06-28	martydem	[6d62d3] Safer deletion policy
queueschedulerdialog.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
queueschedulerdialog.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
queueschedulerdialog.ui	2015-05-16	martydem	[c6502b] Initial commit
rateController.cpp	2015-06-11	martydem	[232864] Fixed memory leaks
rateController.h	2015-06-11	martydem	[232864] Fixed memory leaks
ratecontroldialog.cpp	2015-05-16	martydem	[c6502b] Initial commit
ratecontroldialog.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
ratecontroldialog.ui	2015-05-16	martydem	[c6502b] Initial commit
serverconnection.cpp	2015-05-16	martydem	[c6502b] Initial commit
serverconnection.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
serverconnection.ui	2015-05-16	martydem	[c6502b] Initial commit
serverslist.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
serverslist.h	2015-06-11	martydem	[232864] Fixed memory leaks
sslerrorchecker.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
sslerrorchecker.h	2015-05-18	martydem	[7dc2f9] Amended to work with Qt4 or Qt5
sslerrorchecker.ui	2015-05-16	martydem	[c6502b] Initial commit
unpack.cpp	2015-07-15	martydem	[56a11c] Tidied up pointer initialisation
unpack.h	2015-07-21	martydem	[6fb076] Fixed problem with header download sticking bec...
unpackgroup.cpp	2015-05-16	martydem	[c6502b] Initial commit
unpackgroup.h	2015-05-16	martydem	[c6502b] Initial commit
uudecoder.cpp	2015-06-23	martydem	[fc8e0b] Improved memory management and thread sync arou...
uudecoder.h	2015-06-18	martydem	[7d0624] Further memory management changes
yydecoder.cpp	2015-06-23	martydem	[fc8e0b] Improved memory management and thread sync arou...
yydecoder.h	2015-06-18	martydem	[7d0624] Further memory management changes

Read Me

README file for Quban - a Qt usenet binary news grabber 

Version 0.7.5 - 1st August 2015

* What it is:
Quban is a Qt4 program to download encoded articles from the usenet news
service, using the nntp protocol. It supports multiple servers, multiple
download threads per server, automatic joining and decoding of articles.

* What's included:
 - built in ssl support
 - .nzb support
 - Automatic repair and unpacking for par2, rar, zip and 7z files.
 - Compressed header file downloading.
 - File viewer for image and text files
 - Drag and drop for downloading from nzb files
 - Wizard for simple configuration
 - Server priorities and balancing
 - Getting a list of available newsgroups and subscribing/unsubscribing to them
 - Getting headers, sorting, filtering by subject, state and "completeness" 
 - Downloading and decoding of binary posts (including yEnc).
 - Versitile Queue management
 - Requeueing: if an article fails on a server, it is automatically tried on
   the other servers.
 - Jobs console: for monitoring and cancelling background jobs
 - Newsgroup categories and aliases
 - Server download limits
 
* How does it do it:
 - Quban uses Qt4 libraries for the interface, Berkeley DB for
   storing the newsgroups' headers, and a set of internal decoders for decoding the 
   posts.
 
Dependencies:
 - Qt 4.6 or greater
 - Berkeley Db 4.x  or 5.x 
   (http://www.oracle.com/technetwork/database/berkeleydb/overview/index.html) 
   with C++ support. If you compile it from source, remember to  pass the 
   "--enable-cxx" option to configure.
 - zlib version 1

* How to compile:

 - Full details are contained in the INSTALL file.

* Getting started:

 Type "quban" to start the program. To get it working:
  - Configure the directories (defaults are provided)
  - Add your servers using the Wizard 
  - Get the newsgroup list if required (Server->Download list of available groups)
  - When the list of groups is displayed, subscribe to some groups (right click on group and
    select Subscribe to newsgroup...)
  - NewsGroup->Group properties
  - Enjoy :)
  
* A note about error model: 

Quban divides errors in two branches, fatal (i.e.: article not found) and not
fatal (i.e.: timeout). Fatal errors cause the download of the item to fail, 
while non-fatal errors trigger a retry.

In the server options, there are three values that control the connection 
timeout/errors: 
1. Server timeout: this is the value of timeout for the server (in seconds), 
i.e.: if no response/data come from the server in "timeout" seconds, a timeout 
error is triggered (and the item is generally retried)
2. Retries: this value only applies to post downloads (i.e.: not to headers 
updates) and represents the number of times a download is retried in the event 
of a *fatal* error. Example: Quban tries to download an article. The server 
answers "article not found". The download is retried "Retries" times 
(default: 3). Why, you may ask? Because some servers are lame/overloaded/whatever,
and when you try to download an article you get "article not found" the first time, 
but if you retry in a few seconds, the download succeeds. If your servers don't 
show this behavior, put "retries" to 0.
3. Thread timeout: this is the timeout (in minutes) for the connection thread. 
When a thread fails to successfully connect/login to a server for "thread_timeout" 
minutes, the thread is paused and must be restarted manually (via the context menu). 
This is considered a communication error, so it doesn't cause any item in the queue 
to fail. 

More in depth: when a thread gets a login error, it is paused for n seconds. 
"n" depends on the number of *consecutive* fails: first time 1 seconds, second 
5 seconds, third 10 seconds, then 30, then one minute. After that, the thread 
is always paused for one minute. After "thread_timeout" minutes, the thread is 
put in paused state, and doesn't try to connect anymore until the user restarts 
it manually. Why? Because a login error can have to much causes:
- network is down
- wrong login/password
- thread limit exceeded
- download limit exceeded
- etc...
Servers often return custom error codes, so in the event of a failed login there 
is no easy/automated way to know if the login failed because of a wrong password, 
exceeded daily download limit, too many connected threads, or whatever. So the best 
thing to do (IMHO) is to pause the thread and retry later.

* The story behind it:

 - I wanted to carry on using Klibido ... but saw issues going forward as it's a Qt3 app (beneath KDE).
   Now that it's working and has been tested on several Linux distributions and multiple versions of Berkeley Db and Qt4 I feel that it's time for others to see if it's of any use to them as well.
 - Future enhancements that I'm working on are:
     + Extending the existing par2, rar, 7z support.
     + The re-introduction of drag and drop 
     + A few other ideas that are on the back burner at the moment... 
 
The main goals for Klibido were:
 - Keeping memory usage as low as possible. Update/load/browse large groups
   (groups with over one million of articles) without using 1 Gb of RAM and
   swapping for days.
 - Multiple server support
 - Multiple download threads support
 - Fine-grained manipulation of the download queue.

* Credits
 - Alessandro "Bauno" Bonometti for the work he put into developing Klibido 0.2.5,
   from which Quban was forked. 
 - Sourceforge for hosting this project
 - The guys at Qt for the great IDE they've made.
 - Sleepycat (and Oracle) for the great Berkeley Db
 - David Pye (.nzb parsing, yy/uu decoder)
 - KNode and Pan developers for their icons

Quban is released under version 3 of the GNU General Public License.
   
Good luck!
Martin Demet, <martydem_at_users.sourceforge.net>