Short:        Browse/download from Aminet + SRC
Author:       Juen/Project R3D+Appendix+Nah-Kolor
Uploader:     j@ki.je (Pawel Nowak)
Type:         util/misc
Version:      1.5
Architecture: m68k-amigaos; ppc-amigaos; ppc-morphos; i386-amithlon
Requires:     Kick 2.04, 2 MB RAM, bsdsocket.library

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
