TuneFinder 1.5

Search and play online radio stations

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

Description:
TuneFinder enables users to search and play online radio stations with
various filter options, including country, codec, tags stream filters. Results
are displayed in a list with detailed station information, and the app
includes options to save selections as either a complete playlist or
individual station files.

Main features:

- GUI with filterable search
- PLS playlist compatible with AmigaAMP for seamless playback
- Ability to play PLS playlist directly from TuneFinder interface
- Options to save results as a PLS playlist or individual station files for
  compatible media players
- Native AmigaOS GUI interface
- Favorites management
- Sort by name, votes, popularity, bitrate or random; "More" loads the
  next page of results
- HTTPS filter: all stations, HTTPS only, or no HTTPS (for systems
  without AmiSSL)
- Playback starts in the background; the status line shows Connecting
  and then Playing, and the current track is shown while playing
- HLS streams (not playable by AmigaAMP) and stations that failed their
  last check are marked
- ARexx port for scripting

REQUIREMENTS
------------

- AmigaOS 3.0+, any 68000 or better (68040/68060 recommended for MP3)
- 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". 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         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
  QUIT                 quit TuneFinder
Commands that use the window fail with RC 10 while iconified.
Example:
  ADDRESS TUNEFINDER
  OPTIONS RESULTS
  SEARCH jazz
  SELECT 0
  PLAY

ADDING NEW COUNTRIES
-------------------

To add new countries to TuneFinder:

1. Navigate to "ENVARC:TuneFinder/countries.cfg"
2. Edit the file with any text editor
3. Add each country on a new line using format:  CODE:Name
   For example:
   PL:Poland
   US:United States
   GB:United Kingdom
   SE:Sweden
   NO:Norway
   DK:Denmark

The code must be a 2-letter country code according to ISO 3166-1 alpha-2 standard.
Changes will take effect after restarting TuneFinder.

Default entries will be created automatically if the file doesn't exist.


Release 0.2 (beta release)

- Fixed bsdsocket.library handling in UAE, which doesn't support timeouts.
- Added configuration for API host.
- Source code released on https://github.com/sandlbn/TuneFinder 

TuneFinder 0.3 (03.11.2024)

New features:
- Add user-configurable country list via ENVARC:config/countries.cfg
- Add auto generation of station name for single station entry
- Add better menu support with Settings, About and Quit options

Fixes:
- Fix GUI stability issues on different Amiga systems
- Fix window initialization for AmigaOS 3.0
- Improve menu handling and visibility
- Add proper cleanup of GUI resources
- Add better error handling and debugging messages

TuneFinder 0.4 (05.11.2024)

New features:
- Improved Station Details View
- Increased window size for better readability
- Add cleaner layout with proper spacing between fields

Fixes:
- Fixed text overflow in station details window
- Fixed memory leaks in list handling
- Removed unused variables and functions
- Fixed issues with screen lock/unlock

TuneFinder 0.99 (08.11.2024)

- Improved Station Details View and GUI building.
- Added ability to play streams directly from the station details window.

Fixes:

- Fixed settings directory inconsistency between country and API settings.

TuneFinder 1.00 (09.11.2024)

- Improved settings window creation

Fixes:

- Fixed text padding in msg text gadget

TuneFinder 1.1 (15.11.2024)

Changes since version 1.0:
- Redefined GUI to single screen layout
- Added configurable result limit in settings
- Improved save settings functionality
- Enhanced GUI highlighting and visibility
- Improved REXX communications
- Added German translation (Thomas Blatt)
- Added Polish translation
- Added Amigaguide doc

TuneFinder 1.2 (23.11.2024)

- Added Italian translation (Samir Hawamdeh)
- Added German readme (Thomas Blatt)
- Added new icons (Thomas Blatt)
- Added new memory allocation algo
- Increased max amount of countries 
- Added example countries config (Alexander Gent)
- Fix Countries List - not displaying names with spaces properly
- Fix API settings limit defaults to 100

TuneFinder 1.3 (08.12.2024)
- Users can now select a program (AmigaAMP) to launch together with TuneFinder
- Added favorites management system
- Added Favorites menu item under Project menu
- Added iconification support
- Added list content preservation during iconification
- Added window position persistence
- Added functionality to save last used country and codec on exit
- Added Fav+ and Fav- buttons for adding/removing favorites
- Added French translation (Eric 'Tarinz' LUCZYSZYN)
- Stations can be saved to and loaded from favorites list
- Renamed Save buttons to 'All' and 'One' for better fit
- Bug fixes and UI improvements

TuneFinder 1.3a (09.12.2024)

- Added Iconify AmigaAMP on start to automatically minimize AmigaAMP

TuneFinder 1.5 (30.10.2026)

- Fixed the Hide Broken and HTTPS Only filters, which had no effect
- Fixed crashes: playing after a new search, quitting from the menu,
  long stream URLs, and several memory leaks (iconify, favorites)
- Searches with short names or tags (1-2 letters) and with accented
  letters (umlauts, Polish letters, ...) now work
- An empty search result is no longer reported as an error
- Plays the direct stream address instead of a playlist URL, so more
  stations start in AmigaAMP
- Playback starts in the background with Connecting/Playing status
- HLS streams are marked and not sent to AmigaAMP; stations that failed
  their last check are shown in italics
- Favorites with '|' in the name or an empty codec are stored correctly
- Status and station details no longer show garbage after redraws
- Connection and AmigaAMP timeouts, no system-wide freezes
- Reports played stations to Radio Browser, as the service asks
- Sorting (name, votes, popularity, bitrate, random) and a "More"
  button for further results
- HTTPS filter is now All / HTTPS only / No HTTPS
- The current track is shown and updated while playing
- More compact window: fits a 640x256 Workbench; the selected station
  is shown on one line with codec, bitrate and full country name
- ARexx port "TUNEFINDER"
- Larger stack; Ctrl-C quits

Special thanks to Flype, Thomas, Ponki1986, Samir, Alexander, Paluch and many others for their help testing TuneFinder!