======================

TKPLAYER

======================
___________________________________________________________

INTRODUCTION:
___________________________________________________________
This is a very small player for audio files. It is designed to put it into
the deficons of the supported audio formats. It opens no large and
expensive GUI, it just plays the audio file quickly, without loading
skin graphics or something. It stops playing if you close the small window
showing the title and proceeding time.

There is also an even more minimalisic version included, that
does no output and no options at all, the "TKPlayer_Lite".


___________________________________________________________

REQUIREMENTS:
___________________________________________________________
Hardware:
Any Amiga with 4MB of Fast RAM.

Software:
- OS3.0+
- AHI V4+


___________________________________________________________

FEATUES:
___________________________________________________________
Plays MP3, AIFF, WAV, MAUD, 8SVX, CDDA and RAW via ahi.device.
New: AudioConverter CLI tool for converting audio files
(format, bits, channels, samplerate).

___________________________________________________________

INSTALLATION:
___________________________________________________________
Unarchive the LHA file and copy TKPlayer anywhere you want, C: is
a good place.
Edit your default icons for audio files in ENVARC:Sys/. Set type to "Project"
and type for default tool "C:TKPlayer".
On doubleclick at these icons the audio file will now be played.
Use the Lite version if you dont want a GUI at all, e.g. for playing Samples
in your Emailer.

That`s all !


___________________________________________________________

USAGE:
___________________________________________________________
Use from CLI:

TKPlayer [?] [<filename>] [ahiunit ...] [buffersize ...] [info] [nogui] [speed ...] [offset ...] [pri ...]

Parameters:
  filename   - valid DOS filename with path
  ahiunit    - 0..3, unit of ahi.device
  buffersize - buffersize in milliseconds, default is 250
  speed      - playback speed in %, default is 100
  offset     - offset from where to start playback in ms, default is 0
  info       - display infos in shell
  nogui      - do not open playback window
  pri        - set task priority, default is 2
  ?          - display this help

Example:
TKPlayer Work:mp3/mysong.mp3 nogui speed 110 offset 20000

This will play the file "Work:mp3/mysong.mp3" without opening a window at
110% of the original speed, starting at 20 seconds.

Deficon:
Put it as default tool into the deficons of the supported fileformats and
enjoy the audio files by doublick their icons.

Same options are available via tooltypes, but CLI args override this.

___________________________________________________________

BUGS AND PROBLEMS:
___________________________________________________________
- no known bugs


___________________________________________________________

HISTORY:
___________________________________________________________
v1.5
- corrected a bug in audioconverter (wav and aiff saver was broken)

v1.4
- added parameter ahiunit
- added parameter buffersize
- added parameter pri
- added parameter ? for direct help
- some minor bugfixes (as usual)
- TKPlayer_Lite does not produce error messages as requesters anymore
- added AudioConverter tool as a powerful CLI tool for file convertion 

___________________________________________________________

FUTURE:
___________________________________________________________
- more fileformats, especially MIDI files via softsynth

Please email bug reports, suggestions or files it refuses to play to 
support@hd-rec.de

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                44578  132432  33.7% -lh5- def5 Oct  9  2005 TKPlayer/AudioConverter
[generic]                43188  122184  35.3% -lh5- 0fbd Sep 22  2005 TKPlayer/TKPlayer
[generic]                 2037    2719  74.9% -lh5- 16a1 Jan 21  2005 TKPlayer/TKPlayer.info
[generic]                 1532    3901  39.3% -lh5- a880 Oct  9  2005 TKPlayer/TKPlayer.readme
[generic]                 1667    1892  88.1% -lh5- 9501 May 21  2004 TKPlayer/TKPlayer.readme.info
[generic]                38780  110232  35.2% -lh5- 5286 Sep 22  2005 TKPlayer/TKPlayer_Lite
[generic]                 1956    2614  74.8% -lh5- 6856 May 21  2004 TKPlayer/TKPlayer_Lite.info
[generic]                 1362    1694  80.4% -lh5- 7ef5 May 21  2004 TKPlayer.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         8 files  135100  377668  35.8%            Oct 10  2005