home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / cdrom / diskid2asim / readme < prev    next >
Text File  |  1977-12-31  |  7KB  |  203 lines
  1. Uploader: Thomas Aglassinger <agi@giga.or.at>
  2. Author:   Thomas Aglassinger <agi@giga.or.at>
  3. Type:     disk/cdrom
  4. Short:    transfer DiskID-file to AsimCDFS-CDDA (v1.1)
  5. Kurz:     DiskID-Datei auf AsimCDFS-CDDA uebertragen (v1.1)
  6. Requires: AsimCDFS 3.5
  7.  
  8. TITLE
  9.  
  10.   DiskID2Asim
  11.  
  12. VERSION
  13.  
  14.   1.1
  15.  
  16. AUTHOR
  17.  
  18.   Thomas Aglassinger <agi@giga.or.at>
  19.  
  20. DESCRIPTION
  21.  
  22.   Transfers an already existing DiskID-file to an Audio-CD (CDDA):
  23.   relabels the disk and renames the tracks using the information
  24.   found in the DiskID-file.
  25.  
  26. SPECIAL REQUIREMENTS
  27.  
  28.   AsimCDFS 3.5, SCSI-CD-Rom with support for Audio-CDs, AmigaOS 2.x.
  29.   and DiskID-files (which can be created and modified by several
  30.   CDDA-Players, like MCDPlayer and OptyCDPlayer).
  31.  
  32.   It also might work with older versions of AsimCDFS, but I didn't
  33.   test this.
  34.  
  35. AVAILABILITY
  36.  
  37.   Every Aminet-mirror, file "disk/cdrom/DiskID2Asim.lha"; for example
  38.   "ftp://ftp.wustl.edu/pub/aminet/disk/cdrom/DiskID2Asim.lha".
  39.  
  40. PRICE
  41.  
  42.   Free.
  43.  
  44. DISTRIBUTABILITY
  45.  
  46.   DiskID2Asim is copyrighted freeware. It may be distributed freely 
  47.   as long as no modifications are made to the executable and this 
  48.   document. A nominal fee may be asked to cover distribution costs.
  49.  
  50.   DiskID2Asim may not be used for any commercial purposes or 
  51.   included with any commercial product without the written permission
  52.   of the author.
  53.  
  54. MOTIVATION
  55.  
  56.   AsimCDFS supports CDDAs is quite nifty way: You can access every
  57.   track immediatly as file. By default, they are named like 
  58.   "Track.1", "Track.2" and so on. These names can be changed (from 
  59.   Workbench or using AsimTunes), but this is a rather dull task.
  60.  
  61.   There already exists a large pool of DiskID-files (see Aminet),
  62.   but unfortunatly, no converter is included into AsimCDFS.
  63.   
  64. INSTALLATION
  65.  
  66.   Drag the icon anywhere you want and modify the tooltypes according
  67.   to your needs.
  68.  
  69. TEMPLATE
  70.  
  71.   DEVICE/K,UNIT/N/K,DISKIDPATH/K,TRACKPATH/K,
  72.   NOTITLE/S,NOTRACKS/S,NOBLANKS/S,RESET/S,VERBOSE/S
  73.  
  74. USAGE
  75.  
  76.   DiskID2Asim can be invoked from CLI or Workbench. The arguments
  77.   for the tooltypes are the same as for CLI.
  78.  
  79.   DEVICE     scsi-device the CD-Rom is connected to;
  80.              default "scsi.device"
  81.   UNIT       scsi-unit the CD-Rom is mounted as;
  82.              default 5
  83.   DISKIDPATH directory, where the DiskID-files ("ID#?") are located
  84.   TRACKPATH  directory, where the "Track.#?"-files are located.
  85.              default "CD0:AIFF_Stereo"; usually, there should be no
  86.              need to change this.
  87.              NOTE: Renaming a file in one of the directories for 
  88.              different audio-formats also affects all corresponding 
  89.              files in all other directories.
  90.   NOTITLE    do not relabel disk with album-title
  91.   NOTRACKS   do not rename files with track-title
  92.   NOBLANKS   replace blanks in titles by underscores ("_")
  93.   RESET      reset title and/or tracks to defaults ("Title_Unknown"
  94.              and "Track.#?")
  95.   VERBOSE    enable verbose output
  96.  
  97.   The required DiskID-file needs already to exist, and, of course, 
  98.   the CDDA you want to apply the DiskID-file on needs to be inserted
  99.   in your CD-Rom-drive.
  100.  
  101.   DiskID2Asim does some manipulation on the original title when 
  102.   converting it to a filename:
  103.   - surrounding blanks are removed
  104.   - text inside brakets is removed
  105.   - some special characters ("#?|~..") are replaced by "-"
  106.   - "/" is replaced by "\"
  107.  
  108.   If the filename is still too long, it will be cut-down to the
  109.   filesystem-maximum (30 characters for the album-title, 25 
  110.   characters for track-titles) and the last two characters will be 
  111.   "..".
  112.  
  113.   If several tracks exist with the same name or tracks don't result
  114.   in unique filenames after 25 characters, an unique filename will
  115.   be computed (extensions like ".1", ".2".. are appended).
  116.  
  117. EXAMPLE
  118.  
  119.   DiskID-file: ID100081EC029E71
  120.     ("[xyz]" denotes comments which are not part of the DiskID-file)
  121.  
  122.     Half Man Half Biscuit                        [artists]
  123.     Mc Intyre, Treadmore And Davitt              [title]
  124.     Outbreak Of Vitas Gerulaitis                 [track#1]
  125.     Prag Vec At The Melkweg                      [track#2]
  126.     Christian Rock Concert                       [track#3]
  127.     Lets Not                                     [track#4]
  128.     Yipps (My Baby Got The)                      [track#5]
  129.     Hedley Verityesque                           [track#6]
  130.     A Lilac Harry Quinn                          [track#7]
  131.     Our Tune                                     [track#8]
  132.     Girlfriend's Finished With Him               [track#9]
  133.     Everything's A.O.R.                          [track#10]
  134.  
  135.   Command call (for my machine):
  136.  
  137.     DiskID2Asim DEVICE=SCSI-Apollo.device UNIT=5 \
  138.                 DISKIDPATH=appl:sound/disks VERBOSE
  139.  
  140.   Program output:
  141.  
  142.     DiskID2Asim - transfer DiskID-file to AsimCDFS-CDDA (v1.1, 03.09.96)
  143.     (C) Thomas Aglassinger 1996 - This is Freeware!
  144.     Rename `CD0:' to `Mc Intyre, Treadmore And..'
  145.     Rename `Track.1' to `Outbreak Of Vitas..'
  146.     Rename `Track.2' to `Prag Vec At The Melkweg'
  147.     Rename `Track.3' to `Christian Rock Concert'
  148.     Rename `Track.4' to `Lets Not'
  149.     Rename `Track.5' to `Yipps'
  150.     Rename `Track.6' to `Hedley Verityesque'
  151.     Rename `Track.7' to `A Lilac Harry Quinn'
  152.     Rename `Track.8' to `Our Tune'
  153.     Rename `Track.9' to `Girlfriend's Finished..'
  154.     Rename `Track.10' to `Everything's A.O.R.'
  155.     10 out of 10 track-titles modified
  156.  
  157.   Comments:
  158.  
  159.     For the title, "Mc Intyre, Treadmore And Davitt", the text is
  160.     reduced to fit 30 characters and ends with ".."
  161.     For track#1, "Outbreak Of Vitas Gerulaitis", the text is reduced
  162.     to fit 25 charaters and ends with "..". This still allows a
  163.     ".info" to be appended to the filename.
  164.     For track#5, "Yipps (My Baby Got The)", the text inside brakets
  165.     is removed and results in "Yipps".
  166.  
  167. PROBLEMS
  168.  
  169.   - When updating the album-title (with NOTITLE not specified), 
  170.     CDDAs currently playing are interrupted. This is a bug of 
  171.     AsimCDFS.
  172.   - DiskID2Asim asumes that Examine() and ExNext() return the 
  173.     track-sequence in correct order. This is the case for version
  174.     3.5 of AsimCDFS, but if this changes in future, the filenames
  175.     won't fit the corresponding tracks anymore.
  176.   - If, for some reason, the filenames get totally trashed, you
  177.     can repair them using the editor of AsimTunes. I needed this
  178.     once during development, when two files got identical names.
  179.   - As a feature of AsimCDFS, the usage of DiskID2Asim also affects
  180.     the database used by AsimTunes, but the artist-field remains
  181.     untouched.
  182.  
  183. DISCLAIMER
  184.  
  185.   No responsibilities are taken for damaged CDs, CDROM drives, Amigas
  186.   or any other components or data involved while using DiskID2Asim.
  187.  
  188.   If you find any bugs, let me know.
  189.  
  190. HISTORY
  191.  
  192.   Version 1.1, 3-Sep-1996
  193.   - uses more sophisticated algorithm to create unique filenames
  194.   - no more insists on tracks named "Track.#?" and therefor
  195.     can be applied multiple times (if the DiskID-file has been
  196.     modified)
  197.   - removes only whole words from long names
  198.   - checks if "l:AsimCDFS" is available
  199.   - added RESET option
  200.  
  201.   Version 1.0, 2-Sep-1996
  202.   - initial release
  203.