Short:        Get author, title etc. from PT/PSID modules.
Author:       ki9656@unidhp.uni-c.dk (Mikael Lund)
Uploader:     ki9656 unidhp uni-c dk (Mikael Lund)
Type:         mus/misc
Version:      1.0
Architecture: m68k-amigaos

INFO

   Small CLI-based tool that will let you extract info about author,
   title and copyright from Protracker- and singlefiled PSID-modules.
   The output is configurable.


REQUIREMENTS

    AmigaOS 2.0+


USAGE

   TuneInfo FILE/A TITLE/K AUTHOR/K COPYRIGHT/K

   File      - Filename of the module.
   Title     - Textstring, %s substitutes the title of the module.
   Author    - Textstring, %s substitutes the author of the module.
   Copyright - Textstring, %s substitutes the copyright info found.

   String is only printet if a result is found. The %s substitution
   may be parsed as follows:

     %[flags][width.limit][length]s

     flags  - only one allowed. '-' specifies left justification.
     width  - field width.  If the first character is a '0', the
              field will be padded with leading 0's.
     .      - must follow the field width, if specified
     limit  - maximum number of characters to output.
     length - size of input data.


EXAMPLES

   1:> TuneInfo MOD.happytune! AUTHOR "Composed by: %s*n"
   Composed by: jerry ^ rebels!

   1:> TuneInfo MOD.happytune! TITLE "*"%s*"" AUTHOR " by %.5s*n"
   "happytune!" by jerry

   1:> TuneInfo PSID.Last_Ninja COPYRIGHT "©%s*n"
   ©1987 System 3

   As with all other CLI commands *n will substitute a newline character,
   *" a double quote, ** a star etc.


KNOW FORMATS

   Format   |  Title  |  Author  |  Copyright
   ------------------------------------------
   PSid     |    x    |    x     |     x
   PT/NT/ST |    x    |    x     |

   Finding author information from PT/NT/ST modules is a bit fishy,
   since it is located in the samplenames. TuneInfo searches these for
   "By" and "#". The following samplenames will be recognized:

   "done by Morph"   -->  %s = "Morph"
   "#Jerry ^ Rebels" -->  %s = "Jerry ^ Rebels"


LIMITATIONS

   Info can only be printed in the following order:
   title - author - copyright.


DISTRIBUTION

   May be freely distributed via non-commercial software packages.
   Inclusion with commercial software is allowed as long as a copy
   of the final product is given to me free of charge.

   TuneInfo is copyrighted 1998 by Mikael Lund.


HISTORY

   1.0 22-Apr-98
       - First release.

FUTURE

   Depends on your responce.

   - Xfd unpacking
   - More formats
   - Improved author extraction
   - SUBSONGS/K keyword


AUTHOR

   Mikael Lund
   Ægirsgade 66, 2TH.
   2200 Kbh. N.
   Denmark

   ki9656@unidhp.uni-c.dk
   lund@kiku.dk

============================= Archive contents =============================
Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
    2640    1420 46.2% 22-Apr-98 21:12:10  TuneInfo/TuneInfo
    1186    1186  0.0% 23-Apr-98 10:55:58  TuneInfo/TuneInfo.e
     256     186 27.3% 23-Apr-98 10:46:38  TuneInfo/TuneInfo.example
    2737    1326 51.5% 23-Apr-98 10:39:56  TuneInfo/TuneInfo.readme
-------- ------- ----- --------- --------
    6819    4118 39.6% 23-Apr-98 10:56:46   4 files