Short:        Ultimate64 / II+ SID Player
Author:       marcin@spoczynski.com (Marcin Spoczynski)
Uploader:     marcin spoczynski com (Marcin Spoczynski)
Type:         mus/play
Version:      0.3.2
Requires:     MUI 3.8+, bsdsocket.library, Ultimate64/Ultimate-II device
Architecture: m68k-amigaos >= 3.0
Distribution: Aminet

Ultimate64 SID Player is a full-featured C64 SID music player for AmigaOS that 
connects to Ultimate64 and Ultimate-II devices over network. It provides  
playlist management, multi-subsong navigation, and integrates with the HVSC song 
length database for accurate playback timing.

The player features a MUI interface with drag-and-drop playlist management, 
real-time search and filtering, shuffle/repeat modes, and automatic subsong 
advancement. It can download and integrate song length databases directly from 
the HVSC server for precise timing information.

Key Features:
- Playlist management with save/load functionality
- Multi-subsong SID file support with automatic navigation
- HVSC Songlengths.md5 database integration with auto-download
- Real-time search and filter functionality across playlists
- Shuffle and repeat playback modes
- Visual progress tracking with accurate timing display  
- Automatic subsong advancement and playlist progression
- Network-based Ultimate64/Ultimate-II device control
- Native MUI interface with tabbed organization
- Persistent configuration through ENV: variables

SID File Support:
- PSID and RSID format compatibility
- Multi-subsong detection and navigation
- Automatic title and author extraction from SID headers
- SID model detection (6581/8580) with display
- MD5 hash calculation for song database matching

Playlist Features:
- Add multiple SID files with multi-select file requester
- Drag-and-drop support for easy playlist building
- Save/Load playlists in M3U-compatible format
- Real-time search across titles and filenames
- Filter mode to show only matching entries
- Visual indication of current playing track
- Subsong information display ([current/total] format)

Song Database Integration:
- Automatic detection of local Songlengths.md5 files
- Direct download from HVSC server with progress indication
- Automatic playlist updates when database is loaded
- Precise timing for individual subsongs
- Integration with High Voltage SID Collection format

Network Control:
- TCP/IP connection to Ultimate64/Ultimate-II devices
- Real-time SID configuration display (chip types and addresses)
- Automatic device reset on stop/playlist end
- Connection status monitoring and management
- Password-protected connection support

Usage Instructions:
1. Configure Ultimate64 IP address in Settings menu
2. Optionally download Songlengths.md5 database for timing
3. Connect to your Ultimate64 device
4. Add SID files to playlist using "Add Files" button
5. Double-click any entry to start playback
6. Use search/filter to find specific tracks
7. Save playlists for future use

System Requirements:
- AmigaOS 3.0 or higher
- MUI 3.8+ (Magic User Interface)
- bsdsocket.library
- TCP/IP stack (AmiTCP, Miami, Roadshow, etc.)
- Ultimate64 or Ultimate-II device with network connectivity
- Minimum 2MB RAM (16MB recommended for long playlist and Song database)
- Hard disk installation recommended for song databases

Installation:
1. Extract archive to desired location
2. Ensure MUI 3.8+ is installed
3. Configure TCP/IP stack
4. Run u64sidplayer from Workbench or CLI
5. Configure Ultimate64 connection in Settings

File Formats:
- SID files: .sid (PSID/RSID format)
- Playlists: .pls (standard pls format)
- Song database: Songlengths.md5 (HVSC format)

Network Setup:
Your Ultimate64 device must have network connectivity enabled and be 
accessible from your Amiga. The player will connect using the configured 
IP address and optional password for secure connections.

Credits:
- Developed by Marcin Spoczynski (@sandlbn)
- HVSC song length database support
- Tested with Ultimate64 firmware 3.12a+
- Built with m68k-amigaos-gcc cross-compiler
- MD5 implementation for song database matching

Source: https://github.com/sandlbn/u64ctl

History:
Version 0.3.2 (2025):
- Initial release of dedicated SID player
- Full playlist management with M3U support
- HVSC Songlengths.md5 database integration
- Multi-subsong navigation and timing
- Search and filter functionality
- Shuffle/repeat playback modes
- Network-based Ultimate64 control
- Native MUI interface design
- Automatic song database updates
- Real-time progress tracking