TITLE
cdid2asim
VERSION
1.4
AUTHOR
Thomas Aglassinger <agigiga.or.at>
DESCRIPTION
Transfers an already existing CDID-file to an Audio-CD (CDDA):
relabels the disk and renames the tracks using the information
found in the CDID-file.
SPECIAL REQUIREMENTS
AsimCDFS 3.5, SCSI-CD-Rom with support for Audio-CDs, AmigaOS 2.x.
and CDID-files (which can be created and modified by several
CDDA-Players, like MCDPlayer and OptyCDPlayer).
It also might work with older versions of AsimCDFS, but I didn't
test this.
AVAILABILITY
Every Aminet-mirror, file "disk/cdrom/cdid2asim.lha"; for example
"ftp://ftp.wustl.edu/pub/aminet/disk/cdrom/cdid2asim.lha".
PRICE
Freeware.
DISTRIBUTABILITY
Cdid2asim is copyrighted freeware. It may be distributed freely as
long as no modifications are made to the executable and this
document. A nominal fee may be asked to cover distribution costs.
Cdid2asim may not be used for any commercial purposes or included
with any commercial product without the written permission of the
author.
MOTIVATION
AsimCDFS supports CDDAs is quite nifty way: You can access every
track immediately as file. By default, they are named like "Track.1",
"Track.2" and so on. These names can be changed (from Workbench or
using AsimTunes), but this is a rather dull task.
There already exists a large pool of CDID-files (for example,
aminet:disk/cdrom/CDIDCollection.lha), but unfortunately, no
converter is included with AsimCDFS.
INSTALLATION
Drag the icon anywhere you want and modify the tooltypes to fit your
needs.
If you want to use it from CLI, make sure that stack has been set
to at least 16 KB (enter "stack 16384" in CLI).
TEMPLATE
CDIDPATH/K,TRACKPATH/K,NOTITLE/S,NOTRACKS/S,NOBLANKS/S,
RESET/S,VERBOSE/S
USAGE
Cdid2asim can be invoked from CLI or Workbench. The arguments
for the tooltypes are the same as for CLI.
CDIDPATH directory, where the CDID-files ("ID#?") are located
TRACKPATH directory, where the "Track.#?"-files are located.
default "CD0:AIFF_Stereo"; usually, there should be no
need to change this.
NOTE: Renaming a file in one of the directories for
different audio-formats also affects all corresponding
files in all other directories.
NOTITLE do not relabel disk with album-title
NOTRACKS do not rename files with track-title
NOBLANKS replace blanks in titles by underscores ("_")
RESET reset title and/or tracks to defaults ("Title_Unknown"
and "Track.#?")
VERBOSE enable verbose output
The required CDID-file needs already to exist, and, of course,
the CDDA you want to apply the CDID-file on needs to be inserted
in your CD-ROM-drive.
Cdid2asim does some manipulation on the original title when
converting it to a filename:
- surrounding blanks are removed
- text inside brackets is removed
- some special characters ("#?|~..") are replaced by "-"
- "/" is replaced by "\"
If the filename is still too long, it will be cut down to the
filesystem-maximum (30 characters for the album-title, 25 characters
for track-titles) and the last two characters will be "..".
If several tracks exist with the same name or tracks don't result
in unique filenames after 25 characters, an unique filename will
be computed (extensions like ".1", ".2".. are appended).
Of course, the original CDID-file remains unchanged during the
whole process.
EXAMPLE
CDID-file: ID100081EC029E71
("[xyz]" denotes comments which are not part of the CDID-file)
Half Man Half Biscuit [artist]
Mc Intyre, Treadmore And Davitt [title]
Outbreak Of Vitas Gerulaitis [track#1]
Prag Vec At The Melkweg [track#2]
Christian Rock Concert [track#3]
Lets Not [track#4]
Yipps (My Baby Got The) [track#5]
Hedley Verityesque [track#6]
A Lilac Harry Quinn [track#7]
Our Tune [track#8]
Girlfriend's Finished With Him [track#9]
Everything's A.O.R. [track#10]
Command call (for my machine):
cdid2asim CDIDPATH=appl:sound/disks VERBOSE
Program output:
cdid2asim - apply CDID-file on AsimCDFS-CDDA (v1.4, 24.09.97)
(C) Thomas Aglassinger 1996,1997 - This is Freeware!
Rename `CD0:' to `Mc Intyre, Treadmore And..'
Rename `Track.1' to `Outbreak Of Vitas..'
Rename `Track.2' to `Prag Vec At The Melkweg'
Rename `Track.3' to `Christian Rock Concert'
Rename `Track.4' to `Lets Not'
Rename `Track.5' to `Yipps'
Rename `Track.6' to `Hedley Verityesque'
Rename `Track.7' to `A Lilac Harry Quinn'
Rename `Track.8' to `Our Tune'
Rename `Track.9' to `Girlfriend's Finished..'
Rename `Track.10' to `Everything's A.O.R.'
10 out of 10 track-titles modified
Comments:
For the title, "Mc Intyre, Treadmore And Davitt", the text is
reduced to fit 30 characters and ends with ".."
For track#1, "Outbreak Of Vitas Gerulaitis", the text is reduced
to fit 25 characters and ends with "..". This still allows a
".info" to be appended to the filename.
For track#5, "Yipps (My Baby Got The)", the text inside brackets
is removed and results in "Yipps".
PROBLEMS
- If CLI-Version crashes, make sure that a stack of at least 16 KB
is used (enter "stack 16384" in CLI)
- When updating the album-title (with NOTITLE not specified),
CDDAs currently playing are interrupted. This is a feature of
AsimCDFS.
- Cdid2asim asumes that Examine() and ExNext() return the
track-sequence in correct order. This is the case for version
3.x of AsimCDFS, but if this changes in future, the filenames
won't fit the corresponding tracks anymore.
- As a feature of AsimCDFS, the usage of cdid2asim also affects
the database used by AsimTunes, but the artist-field remains
untouched.
If, for some reason, the filenames get totally trashed, you
can repair them using the editor of AsimTunes. I needed this
once during development, when two files got identical names
(of course, this bug has already been fixed).
DISCLAIMER
No responsibilities are taken for damaged CDs, CDROM drives, Amigas
or any other components or data involved while using cdid2asim.
If you find any bugs, let me know.
CREDITS
Thanks to Boris Jakubaschk for MCDPlayer; most of the SCSI-stuff
is based on his sources.
HISTORY
Version 1.4, 25-Sep-1997
- characters with an ASCII-code greater than 128 are now treated
like alphanumeric characters; for instance J.Karjalainen's
"Rockin' Kyöstin rokkibändi" now results in "Rockin' Kyöstin.."
instead of "Rockin' Kyöstin rokkibä.."
- now CD-title only is updated if necessary
Version 1.3, 21-May-1997
- no more SCSI device and unit necessary, as this information
is now obtained from the device name (usually CD0:)
- removed CLI options DEVICE and UNIT (as a result of the above)
- check, if CD drive is handled by AsimCDFS, is now performed in a
better way (scans OS-data structures instead just checks for
existence of l:AsimCDFS)
- fixed some inconsistencies in this README.
Version 1.2, 16-May-1997
- renamed from "DiskID2Asim" to "cdid2asim"
- increased stack to 16 KB (WB-Version could crash with smaller
stack)
- improved track name conversion:
- non-alphanumeric characters (except "." and "!") at end of
track names are removed
- blanks before the ".." at the end of long filenames are
removed
- double blanks are converted to a single one
- renamed option DISKIDPATH to CDIDPATH
Version 1.1, 3-Sep-1996
- uses more sophisticated algorithm to create unique filenames
- no more insists on tracks named "Track.#?" and therefor
can be applied multiple times (if the DiskID-file has been
modified)
- removes only whole words from long names
- checks if "l:AsimCDFS" is available
- added RESET option
Version 1.0, 2-Sep-1996
- initial release
|