TuneFinderMUI 1.0-beta

Search+play online radio stations (MUI)

Short:        Search+play online radio stations (MUI)
Author:       marcin@spoczynski.com (Marcin Spoczynski)
Uploader:     marcin spoczynski com (Marcin Spoczynski)
Type:         comm/misc
Version:      1.0-beta
Replaces:     comm/misc/TuneFinderMUI.lha
Requires:     MUI 3.8+, TCP/IP stack, AmigaAMP + mpega.library
Architecture: m68k-amigaos >= 3.0
Distribution: Aminet

Description:
TuneFinderMUI is a MUI version of TuneFinder that enables users to search and
play online radio stations from the Radio Browser directory
(www.radio-browser.info). It provides filters for name, tags, country,
codec and HTTPS, sorting by votes or popularity, and plays stations
directly in AmigaAMP, showing the current track while playing. Stations
can be kept as favorites or saved as PLS playlists.

Main features:
- MUI-based interface with filterable search
- Sort by name, votes, popularity, bitrate or random; "More" loads the
  next page of results
- Direct station playback in AmigaAMP, without blocking the interface
- Current track shown and updated while playing
- HTTPS filter: all stations, HTTPS only, or no HTTPS (for systems
  without AmiSSL)
- HLS streams and stations that failed their last check are marked
- Favorites management
- Save results as PLS playlists
- ARexx port for scripting and hotkeys
- AmigaAMP auto-start and iconify options
- European UTF-8 language character support
- Native AmigaOS application

Requirements:
- AmigaOS 3.0+, any 68000 or better (68040/68060 recommended for MP3)
- MUI 3.8+
- TCP/IP stack with bsdsocket.library (Roadshow, AmiTCP, Miami, ...)
- AmigaAMP and mpega.library (Aminet: util/libs/mpega_library.lha)
  for playback
- AmiSSL for HTTPS streams (optional, AmigaAMP side)

ARexx:
The ARexx port is "TUNEFINDER MUI.1". Commands:
  SEARCH [NAME]          search (other filters as set in the window)
  MORE                   load the next page of results
  SORT NAME|VOTES|POPULAR|BITRATE|RANDOM
  COUNT                  number of stations in the list
  SELECT INDEX/N/A       make a station active (0 = first)
  ACTIVE                 name|url|codec|country|bitrate of the active one
  PLAY, STOP             playback in AmigaAMP
  ADDFAV, REMOVEFAV      add/remove the active station
  FAVORITES              show the favorites list
  STATUS, TRACK          status line, current track
Example:
  ADDRESS 'TUNEFINDER MUI.1'
  OPTIONS RESULTS
  SORT VOTES
  SEARCH 'jazz'
  SAY RESULT

Credits:
- Developed by Marcin Spoczynski @sandlbn
- Interface design by Philippe Carpentier @flype44 
- Icons design by Thomas Blatt

Source code: https://github.com/sandlbn/TuneFinderMUI

TuneFinderMUI 0.2 beta (23.12.2024)

- Added TuneFinderMUI guide
- Add option to keep AmigaAMP running after TuneFinderMUI exit

TuneFinderMUI 0.3 beta (27.12.2024)

- Added country name conversion from ISO codes to full names
- Improved button layout with Settings shortcut

TuneFinderMUI 0.4 beta (1.01.2024)

- Reorganize interface layout

TuneFinderMUI 0.6 beta (12.01.2024)

- Configurable HTTPS streams filter with state persistence
- Number of small fixes

TuneFinderMUI 0.7 beta (20.04.2025)
- Added automatic Radio Browser API server rotation
- Implemented DNS discovery of available API servers
- Added "Next Server" button to manually switch between servers
- Improved resilience against server outages with multi-server fallback
- Enhanced error recovery with automatic retries on different servers

TuneFinderMUI 0.8 beta (26.10.2025)
- Added track info to the main TuneFinder screen
- Fixed bug with server rotation

TuneFinderMUI 0.9 beta (20.01.2026)
- Fix JSON parsing: add array type check to prevent crash, use HTTP/1.0
to avoid chunked encoding
- Fix URL parameters

TuneFinderMUI 1.0 beta (30.10.2026)
- Sorting by name, votes, popularity, bitrate or random
- "More" button loads further pages of results
- ARexx port with search, playback and favorites commands
- Playback starts in the background: the window stays usable while
  AmigaAMP connects, and the status shows Connecting/Playing
- Current track is updated every few seconds while playing
- Searches with accented letters (umlauts, Polish letters, ...)  
- Plays the direct stream address instead of a playlist URL, so more
  stations start in AmigaAMP
- Reports played stations to Radio Browser, as the service asks
- Favorites with '|' in the name or an empty codec are stored correctly
- Fixed buffer overflows with long stream URLs and long searches
- Settings are read from ENV: and saved to ENV: and ENVARC:
- Larger stack for stability on systems with a small default stack