whdfetch - Retroplay WHDLoad Downloader for AmigaOS
===================================================

whdfetch is a CLI tool for AmigaOS 3.0+ that automates downloading,
extracting, and organising WHDLoad game, demo, and magazine packs from
the Retroplay collection on the Turran FTP server.  On a subsequent run
it compares what is already installed against the latest pack listings
and downloads only what is new or updated.


Features
--------

  - Downloads Games, Demos, Magazines, and Beta packs from Retroplay
  - Compares installed titles against current DAT listings - only new
    or updated archives are downloaded
  - Disk space estimator before committing to a download
  - Chipset and region filters (AGA, CD32/CDTV, NTSC, non-English)
  - Automatic extraction via c:lha or c:unlzx
  - Optional drawer icon replacement after extraction
  - INI file for persistent settings; all options overridable from CLI
  - Runs on any 68000+ AmigaOS 3.0+ machine; prefers Fast RAM


Quick Start
-----------

Before committing to a large download, check how much disk space you
will need:

  whdfetch ESTIMATESPACE

This downloads the latest DAT files, reads the archive sizes, and prints
an estimate without downloading any game archives. It also accepts filter
flags so the estimate reflects your actual setup:

  whdfetch ESTIMATESPACE SKIPAGA SKIPCD SKIPNTSC SKIPNONENGLISH

When you are ready to start, try the smallest pack first to verify that
downloading, extracting, and folder creation all work correctly on your
system:

  whdfetch DOWNLOADBETADEMOS EXTRACTTO=Work:WHDLoad/

EXTRACTTO redirects extracted files to a separate volume while keeping
the downloaded archives in the GameFiles folder alongside whdfetch. Once
you are satisfied, move on to the larger packs:

  whdfetch DOWNLOADGAMES EXTRACTTO=Work:WHDLoad/



This is very much in its early days of development, so feedback is
very welcome. If you have any suggestions or find any bugs,
please let me know by email or at the projects home page on GitHub:
www.github.com/Kwezza/WHDFetch

License
-------

This software is freeware for personal use.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                  65951  170300  38.7% -lh5- 29bf Mar 25 10:46 whdfetch
[Amiga]                  17891   55174  32.4% -lh5- 05d1 Mar 25 10:00 whdfetch.guide
[Amiga]                    274     517  53.0% -lh5- 7908 Mar  6 15:40 whdfetch.guide.info
[Amiga]                   5102   14068  36.3% -lh5- c2a5 Mar 23 17:56 whdfetch.ini.sample
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         4 files   89218  240059  37.2%            Mar 26 10:49