home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / awgt1512.zip / awget.eng < prev    next >
Text File  |  1999-07-24  |  6KB  |  191 lines
  1. Auto Wget Daemon
  2. Great idea and first release (C) 1998 by Steve Trubachev
  3. Final release (C) 1998,1999 by Dmitry A.Steklenev
  4.  
  5. Short description
  6. -----------------
  7.  
  8. If you know what GNU Wget is, so Auto Wget Daemon is for you.
  9. As mentioned in OS/2 E-zine (http://www.os2ezine.com/v3n17/awget.htm)
  10. Auto Wget Daemon (AWget) is a tool for "bulletproof downloading".
  11. If you are bored with copying link in Netscape Navigator and manually
  12. launching Wget then AWget is what you need. Now you can
  13. start downloading with Drag'n'Drop. All you need is to drag url into
  14. dedicated folder. Auto WGet supports download queue and redownloading if
  15. you got any troubles.
  16.  
  17. Installation
  18. ------------
  19.  
  20. Copy all files to the directory where you decided to place Auto WGet
  21. and run INSTALL.CMD. You'll be prompted to answer a few simple questions.
  22. Installation script will create "ToDo" folder on your Desktop with two folders
  23. inside it - "Info" and "Running". Also file %ETC%\AWGET.CFG will be created or
  24. refreshed. Program object for launching Auto Wget Daemon will be placed in
  25. "Desktop\OS/2 System\Startup" folder. It is not necessary to reboot now
  26. cause awgetd.cmd will be launched by install.
  27.  
  28. How does it works
  29. -----------------
  30.  
  31. Auto Wget Daemon looks into the "ToDo" folder and launch Wget when
  32. any file appears to be there. It is considered that file placed in
  33. the "ToDo" contains an URL. Daemon moves file to the "Running".
  34. With help of them Daemon can decide how many Wget-sessions are running.
  35.  
  36. If downloading processes were not completed due to power failure
  37. or anything else, files are moved into the "ToDo" folder again.
  38. After that everything works as usual.
  39.  
  40. So just drag url into the "ToDo" folder and relax - awget will put task to
  41. the queue and after some time you'll get your files.
  42.  
  43. If you use Netscape Communicator for OS/2, which is not able to drop URL in
  44. folders, just set the key "use_desktop" to "1" in a configuration file
  45. and drop URL on Desktop. The daemon itself will move them to a folder "ToDo".
  46.  
  47. Configuration
  48. -------------
  49.  
  50. Configuration file awget.cfg must be located in %ETC% (\MPTN\ETC usually)
  51. and consists of some strings:
  52.  
  53. # Folder for downloaded files
  54.  
  55. download = D:\CONTAINER\DOWNLOAD
  56.  
  57. # No comments :)
  58.  
  59. maximum_downloads_simultaneously = 3
  60.  
  61. # "Start downloading" and "Download completed"
  62. # popup messages On (1) or Off (0)
  63.  
  64. messages = 1
  65.  
  66. # Options for GNU Wget
  67.  
  68. wget_parameters = -c -t 0
  69.  
  70. # How often daemon must check folder "ToDo" in seconds
  71.  
  72. scan_interval = 30
  73.  
  74. # Where to write "Start downloading" and "Download completed" messages
  75.  
  76. log_file = D:\USR\AWGet\ToDo\Info\awget.log
  77.  
  78. # Where to write error messages
  79.  
  80. error_log = D:\USR\AWGet\ToDo\Info\awget_error.log
  81.  
  82. # What to say when download completed
  83. # %F means downloaded file name
  84. # %U means URL.
  85.  
  86. message_done = send "Done %F: %U" glass
  87.  
  88. # What to say when download was not successful
  89. # %F means downloaded file name
  90. # %U means URL.
  91.  
  92. message_error = send "Error %F: %U" glass
  93.  
  94. # Is it necessary or not to check PPP connection before downloading
  95. # anything. Default is Off (0)
  96.  
  97. check_connection = 0
  98.  
  99. # This key is necessary for Netscape Communicator support.
  100. # If set to 1 then daemon scans Desktop for files with URL's
  101. # and moves them to ToDo folder
  102.  
  103. use_desktop = 1
  104.  
  105. # If set to 1 then daemon moves failed URL's to Failed folder
  106.  
  107. keep_failed_url = 1
  108.  
  109. # If set to 1 then daemon moves succesfull URL's to Done folder
  110.  
  111. keep_done_url = 1
  112.  
  113. Programs used
  114. -------------
  115.  
  116. pmpopup2.exe Ulrich Sturmberg PM Popup Version 1.0
  117.  
  118. also "netstat" is used for checking PPP connection
  119.  
  120. History of changes
  121. ------------------
  122.  
  123. Revision 1.5.1.2
  124.  
  125.    upd: Because of bugs in old versions OBJECT REXX the subsystem 
  126.         of locking is completely rewritten.
  127.    upd: The waiting of start of process of downloading with 
  128.         timeout per 30 seconds is added.
  129.    add: French language support
  130.    add: Italian language support
  131.  
  132. Revision 1.5.1.0
  133.  
  134.    fix: error in installation script.
  135.  
  136. Revision 1.5.0.9
  137.  
  138.    fix: error in procedure of check existence of the download directory.
  139.  
  140. Revision 1.5.0.8
  141.  
  142.    fix: problem with URLs containing '&()^'
  143.  
  144. Revision 1.5.0.7
  145.  
  146.    fix: error in WpsMove().
  147.  
  148. Revision 1.5.0.6
  149.  
  150.    fix: PPP connection check (for PPP1-PPP7)
  151.    add: At a error the output of the WGet is append in a error log 
  152.         for the further analysis
  153.    add: uninstallation program.
  154.    add: new icons :)
  155.    add: error log file.
  156.    add: after end of downloading URL is placed in the extended
  157.         attribute .SUBJECT of the downloaded file.
  158.    add: Netscape Communicator/2 support.
  159.    add: after processing URL can move in special folders
  160.         "Failed" or "Done", depending on what finished downloading.
  161.    upd: refreshing of folders at moving files.
  162.    add: object "Add Url" in a folder "Info" for manual addition URL.
  163.    add: creation of a tray "Auto WGet Daemon" in WarpCenter during
  164.         installation.
  165.    fix: many small bugs :)
  166.  
  167. Revision 1.4.0.3
  168.  
  169.    fix: problem with URLs containing '%'
  170.    upd: process complete message automaticaly disposed after
  171.         one hour
  172.  
  173. Authors
  174. -------
  175.  
  176. Great idea and first release (C) 1998 by Steve Trubachev
  177. Final release (C) 1998,1999 by Dmitry A.Steklenev
  178. glassman_ru@geocities.com
  179.  
  180. Special thanks
  181. --------------
  182.  
  183. My acknowledgements to Steve Trubachev (aka Aztek) for assistance 
  184. in translation of all this on English.
  185.  
  186. My acknowledgements to Gian Luca PROSPERINI <gian-luca@hotpop.com>
  187. for translation of a message file on Italian.
  188.  
  189. My acknowledgements to Guillaume Gay <gay@mail.dotcom.fr> for
  190. translation of a message file on French.
  191.