Short:        Multiformat player and net radio
Author:       Darren Banfi (boingball)
Uploader:     boingball gmail com (Darren Banfi)
Type:         mus/play
Version:      1.0.0
Requires:     68030+; TCP/IP stack for radio; util/libs/AmiSSL-v5-OS3.lha for HTTPS
Architecture: m68k-amigaos >= 3.1.0

MintAMP - Mini Internet Amiga Media Player
==========================================

MintAMP is a lightweight audio player and internet radio client for classic
Amiga computers. It uses fixed-point decoders designed for m68k systems and
outputs directly through Paula using audio.device, so AHI and a sound card are
not required.

Two front-ends are included:

  MintAMP     ReAction/ClassAct edition
  MintAMP-GT  GadTools edition for systems without ReAction

Features
--------

  - Local MP3 playback using the Helix fixed-point decoder
  - Local and streamed AAC-LC ADTS/AAC+ playback
  - Local FLAC playback
  - Local Ogg Vorbis playback using the fixed-point Tremor decoder
  - Experimental classic WMA playback (WMAv1/WMAv2 in ASF containers)
  - Uncompressed PCM WAV playback (8/16/24/32-bit, mono or stereo)
  - Amiga IFF-8SVX playback, including Fibonacci-delta compression
  - Bundled modular AAC, FLAC, Ogg, WMA, WAV and IFF decoders
  - HTTP and HTTPS internet radio
  - Radio Browser station search and favourites
  - Live ICY station, artist and title information
  - Station artwork using JPEG, PNG, WebP, ICO and a subset of SVG
  - Playlist loading and saving
  - ID3 tag display and track ratings
  - Configurable output rate, quality, channel mode and buffering
  - Reduced-rate and reduced-subband modes for slower systems
  - Direct Paula audio output; no AHI installation required

Requirements
------------

  - AmigaOS 3.1 or later
  - Motorola 68030 or better
  - Fast RAM is strongly recommended
  - A running TCP/IP stack providing bsdsocket.library for internet radio
  - AmiSSL 4.x or 5.x for HTTPS streams
  - ReAction/ClassAct v44 classes for MintAMP

Use MintAMP-GT if ReAction/ClassAct is not installed. Local playback does not
need a TCP/IP stack or AmiSSL.

Installation
------------

Extract the complete archive to a drawer and keep the decoders drawer beside
the two player executables:

  MintAMP/
    MintAMP
    MintAMP-GT
    decoders/
      aac.decoder
      flac.decoder
      ogg.decoder
      wma.decoder
      wav.decoder
      iff.decoder

Start MintAMP or MintAMP-GT from Workbench. For internet radio, start the
TCP/IP stack first. Install AmiSSL from util/libs/AmiSSL-v5-OS3.lha to play
HTTPS stations.

Notes
-----

AAC support is for ADTS files and direct ADTS/AAC+ streams. HLS/M3U8 streams
are not supported; internet stations must provide a direct MP3 or AAC stream.

FLAC decoding is considerably more demanding than MP3. Usable settings depend
on the processor, file complexity and selected output rate.

WMA support covers the classic WMAv1 and WMAv2 codecs in ASF containers. This
includes compatible WMA Standard files, but not WMA Pro, Lossless or Voice.

Source code and development information:

  https://github.com/boingball/amiga-libhelix-mp3

Credits
-------

Amiga port, GUI front-ends, decoder integration, internet radio, artwork and
m68k optimisation by Darren Banfi (boingball).

Audio decoder components:

  - MP3: Helix fixed-point decoder from RealNetworks
  - AAC: Helix AAC through ESP8266Audio by Earle F. Philhower III
  - FLAC: libfoxenflac by Alexander Stoeckel
  - Ogg Vorbis: Xiph.Org Tremor via Phil Schatzmann's Arduino port,
    together with Xiph.Org libogg
  - WMA: Rockbox fixed-point libwma, derived from FFmpeg's WMA decoder

Artwork decoder components:

  - JPEG: picojpeg-compatible decoder; picojpeg was created by Rich Geldreich
  - PNG: LodePNG by Lode Vandevenne
  - WebP: compact implementation using parts of Google's libwebp reference
    decoder under its BSD licence

The MintAMP-specific ASF/WMA integration, WAV/PCM and IFF-8SVX decoders, and
ICO, SVG and compact WebP artwork handlers were developed with assistance from
Anthropic Claude.

These components remain under their respective licences, including the Helix
RPSL, LGPL, BSD-style and LodePNG terms. See the licence files and source
repository for the complete terms and source code.

History
-------

1.0.0  Initial Aminet release.