Short:        GUI for MelodyRec audio recorder V3.0
Author:       mEDi of dSd (medi_dsd@gmx.de), Ramboy of Warp9 (rby@w-9.de)
Uploader:     rby w-9 de (Ramboy)
Type:         mus/edit
Version:      3.0.0
Replaces:     mus/edit/MelodyRecGUI.lha; mus/edit/MelodyRecGUI_3.0.lha
Requires:     triton.library, rexxreqtools.library, reqtools.library
Architecture: m68k-amigaos
Distribution: Aminet

                    MelodyRec GUI V3.0.0
          A GUI for Melody Record Audio Recorder
    (Audio-record program for Katos Melody Soundcard)

Authors: mEDi of Darkside (http://drive.to/dsd)
         Ramboy of Warp9  (http://www.w-9.de)


DESCRIPTION
-----------
MelodyRecGUI is an ARexx-based graphical user interface for the
MelodyRec audio recording program. It uses the Triton GUI system
for a clean, font-sensitive interface.

This is a major update after 25+ years, adding modern usability
features while maintaining full backward compatibility.


NEW IN VERSION 3.0.0
--------------------
- Bug fix: File requester pattern was broken (unclosed parenthesis)
- Bug fix: Error signal handler was incorrectly configured
- Bug fix: Removed invalid 32-bit option (hardware supports 8/16-bit)
- Bug fix: Fixed character encoding for Amiga compatibility
- NEW: Configurable MelodyRec program path in GUI
- NEW: Auto-detection of MelodyRec in C: and PROGDIR:
- NEW: "Locate" dialog if MelodyRec is not found
- NEW: Preferences saving (ENVARC:MelodyRecGUI.prefs)
- NEW: Recent files list (last 5 files remembered)
- NEW: Keyboard shortcuts for quick operation
- NEW: Better error messages for missing input fields
- NEW: MD5 checksum file for integrity verification
- Updated copyright year range


KEYBOARD SHORTCUTS
------------------
Ctrl+R    Start recording
Ctrl+Q    Quit program
Ctrl+S    Save preferences
Ctrl+O    Open file requester


INSTALLATION
------------
1. Copy the MelodyRecGUI drawer to your preferred location

2. Copy libraries to LIBS: (if not already present):
   - libs/triton.library       -> LIBS:
   - libs/tritonrexx.library   -> LIBS:
   - libs/rexxreqtools.library -> LIBS:

3. Copy error text files to S: (optional, for localized errors):
   - s/error_text_e.txt -> S:
   - s/error_text_d.txt -> S:

4. Copy C/MelodyRec and C/Kill to C: or keep in program directory

5. Double-click MelodyRecGUI-eng (English) or MelodyRecGUI-de (German)


REQUIREMENTS
------------
- AmigaOS 2.0 or higher (3.x recommended)
- ARexx (rexxsyslib.library)
- triton.library (included)
- tritonrexx.library (included)
- rexxreqtools.library (included)
- reqtools.library (usually in your LIBS:)
- Melody audio hardware + melodyaudio.device

SUPPORTED BIT DEPTHS
--------------------
The Kato Melody 1200 soundcard has 20-bit AD/DA converters.
Recording is supported at 8-bit and 16-bit (industry standard).
The 32-bit option from V2.0 was removed as it was never supported
by the hardware.


PREFERENCES
-----------
Settings are automatically saved to:
- ENVARC:MelodyRecGUI.prefs (permanent)
- ENV:MelodyRecGUI.prefs (session)

Recent files are saved to:
- ENVARC:MelodyRecGUI.recent


HISTORY
-------
21.01.2026  V3.0.0  Major update: Bug fixes, preferences, recent
                    files, keyboard shortcuts, path configuration
12.11.1999  V2.0.1  Minor fixes (Ramboy)
07.05.1999  V1.0.5  New device name (Ramboy)
14.02.1999  V1.0.4  English version, bug fixes (Ramboy)
25.01.1999  V1.0.3  First Aminet release
24.01.1999  V1.0.2  Minor bug fixes (Ramboy)
22.01.1999  V1.0.1  First working version (mEDi)


ARCHIVE CONTENTS
----------------
MelodyRecGUI/
  MelodyRecGUI-eng       - Main program (English)
  MelodyRecGUI-eng.info  - Workbench icon
  MelodyRecGUI-de        - Main program (German)
  MelodyRecGUI-de.info   - Workbench icon
  CHECKSUM.md5           - MD5 checksums for file verification
  VerifyFiles            - AmigaDOS script to verify checksums
  C/
    MelodyRec            - Audio recorder binary
    Kill                 - Process killer utility
  libs/
    triton.library       - Triton GUI library V6.115
    tritonrexx.library   - Triton ARexx interface
    rexxreqtools.library - ReqTools ARexx interface V1.3
  s/
    error_text_e.txt     - Error messages (English)
    error_text_d.txt     - Error messages (German)


DISCLAIMER
----------
This program is provided as-is and without warranty.
No responsibility is accepted for data loss or other damage.


CONTACT
-------
Ramboy/Warp9: rby@w-9.de
              http://www.w-9.de

mEDi/Darkside: medi_dsd@gmx.de