AminetBrowser - a graphical Aminet archive browser and downloader
for classic Amiga computers. Browse categories, view file listings,
sort results, and download files directly to your Amiga - all from
a native GadTools GUI.

This is a fully functional application written in a single day
using NodeAmiga (a JavaScript runtime for AmigaOS). It demonstrates
how quickly and easily complete, useful Amiga software can be
created with NodeAmiga - from concept to working program in just
a few hours.

The complete source code (aminet_browser.js, ~620 lines) is
included in the src/ directory.

Features
--------

  * Native GadTools GUI with resizable window
  * Browse all Aminet categories and subcategories
    (biz, comm, demo, dev, docs, game, gfx, misc,
    mods, mus, pix, text, util)
  * File listing with name, size, and date columns
  * Sort by name, size, or date (ascending/descending)
  * Automatic pagination ? fetches all pages of results
  * Double-click a file to download instantly
  * ASL file requester for choosing save location
  * Status bar with file description on selection
  * Keyboard shortcuts (Q or Esc to quit)
  * All gadgets disabled during download to prevent
    accidental actions
  * Proper error handling for network failures
  * Search mode
  * Display .readme
  * Show recent uploads
  * Check for new version

System Requirements
-------------------

  * MC68000 or higher CPU
  * AmigaOS 2.04 (Kickstart 37) or higher
  * 4 MB RAM
  * bsdsocket.library (active TCP/IP stack required)

Included Files
--------------

  AminetBrowser_000    Executable for MC68000
  AminetBrowser_020    Executable for MC68020+
  src/                 Complete JavaScript source code

About NodeAmiga
---------------

  AminetBrowser was created using NodeAmiga - a custom
  JavaScript runtime for classic Amiga (AmigaOS 2.x/3.x).

  NodeAmiga provides a Node.js-like environment with native
  Amiga integration: GadTools GUI, networking, file I/O,
  and more - all accessible from JavaScript.

  This program showcases what's possible: a complete, useful
  application with GUI, HTTP networking, HTML parsing, file
  downloads, and ASL requesters ? written in just ~620 lines
  of JavaScript, in a single day.

  NodeAmiga is available on Aminet: dev/lang/NodeAmiga.lha

  The standalone executables were compiled using NodeAmiga's
  built-in compiler:
    NodeAmiga -compile AminetBrowser src/aminet_browser.js

  The compiled binaries run without NodeAmiga or any external
  libs/ - everything is bundled into a single executable.

Known Limitations
-----------------

  * Download progress is not shown (status updates after
    completion)
  * Large files may take a while on slow connections
  * Sorting can be slow on slow CPU

Credits
-------

  Juen/Project R3D+Appendix+Nah-Kolor

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                   1486    3110  47.8% -lh5- 60b5 Apr 17 11:08 AminetBrowser/AminetBrowser.readme
[Amiga]                 190809  393374  48.5% -lh5- c0dd Apr 17 11:09 AminetBrowser/AminetBrowser_000
[Amiga]                 190011  389670  48.8% -lh5- 8152 Apr 17 11:09 AminetBrowser/AminetBrowser_020
[Amiga]                  10260   40172  25.5% -lh5- b506 Apr 17 11:00 AminetBrowser/src/aminet_browser.js
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         4 files  392566  826326  47.5%            Apr 17 12:26