Version: 0.34a
quick start download reference history todo details contact
This font indicates things you can type in.
Italic in addition indicates parameters, which have to be replaced by meaningful values.
You need in addition to this Programm either an Internet connection or a local copy of the freedb database.
In addition you need the EMX runtime version >= 0.9d.
You can download the database for instance at www.freedb.org. A local CDDB server is not required. Unfortunately this database is very bulky. That means: it consists of several tenthousends of files with a total size of several 100 MB (80 MB compressed).
On the other side you can use a CDDB server. If you have a dial up connection you may want to collect the queries first and execute them later, when you are online.
- via Internet:
- Copy the CMD script and the file RXMMUTL.DLL to some directory you like.
Set up the CDDB server once: CDDBMMCD -w -sserver, where server is the name of the CDDB server.
Remember that the 'official' CDDB servers do not accept unknown CDDB applications. www.freedb.org and many mirrors will provide an alternative service for free.
Example: CDDBMMCD -w -sfreedb.freedb.org
or CDDBMMCD -w -shttp:\\freedb.freedb.org -Pproxyserver behind a firewall- with a local database:
- Copy the CMD script and the file RXMMUTL.DLL into the directory of the local CDDB database (where the folders misc, rock etc. resides).
It is recommended to create a program object on the desktop or somwhere else.
- with a dial up connection:
- with audio CD in your CD-ROM drive: CDDBMMCD -oc
later, when you are online: CDDBMMCD -oQou- otherwise:
- Simply execute the script with a audio CD inside the CD-ROM.
If the OS/2 CD player is running, the information is updated on the next seek respectively the next media change. However, the information is stored in any case.
Unfortunately the internal data of the OS/2 player is insufficient for a automatic CDDB requests for each audio CD whitch had ever been inserted. So you have to call the program once for every unrecognized CD.
This program will remember unsuccessful queries and check them periodically. Future versions may upload the information automatically, if you enter it in the OS/2 CD-Player.
ZIP file with source and this guide: Version 0.34
Option |
Description |
Default |
|||||||||||||||||||||||||||
-ddevice or --device=device |
MCI name of the CD-Audio device to query (for TOC). Multiple devices may may be separated by komma. |
cdaudio | |||||||||||||||||||||||||||
-lpath or --local=path |
Path to a local CDDB. This path shoult point to the directory where the subdirectories rock etc. are locateted. -l- or --nolocal disables the use of a local CDDB. | . current directory |
|||||||||||||||||||||||||||
-ttype or --type=type |
Type of the local CDDB. S[tandard] or W[indows] or [auto]. see also standard version vs. windows version |
auto | |||||||||||||||||||||||||||
-fthreshold or --fuzzy=threshold |
Execute fuzzy search, if no exact match is found. The threshold defines the number of frames which each TOC entry may deviate. -f0 disables fuzzy search. | 41 | |||||||||||||||||||||||||||
-sserver or --server=server |
currently unimplemented! Name or IP of the CDDB server. Multiple servers may be entered comma delimited (without blanks). The entries have the form: [protocol:\\]server[:port][1]. |
no server | |||||||||||||||||||||||||||
-Pproxy oder --proxy=proxy |
Name or IP of the HTTP proxy. Syntax: proxy[:port]. Port defaults to 80. |
no proxy | |||||||||||||||||||||||||||
-uusername or --user=username |
Username for cddb hello. | %USER% | |||||||||||||||||||||||||||
-hhostname or --host=hostname |
Hostname for cddb hello. | %HOSTNAME% | |||||||||||||||||||||||||||
-cclient or --client=client |
Name of the CDDB client including the version (for cddb hello also). Official servers are very choosy. | cddbmmcd/2 | |||||||||||||||||||||||||||
-o[+|-]op-codes --op=[+|-]op-codes | One or more of the following operations may be specified:
|
cqQou | |||||||||||||||||||||||||||
-pfile or --profile=file |
Profile for CDDBMMCD | .\CDDBMMCD.INI | |||||||||||||||||||||||||||
-w or --write |
Save all settings (except for -p) as new defaults to the profile. |
The options apply according to the following (decreasing) precedence:
Notes:
There are two versions of the freedb. The native and a Windows version (freedb-win*).
In the original each file is one CD. The filenames are 8 digit hex numbers, e.g. d70b6b11. It contains folders with 70000 and more files. This overloads every FAT filesystem. OS/2 (with HPFS) is capable of this, but you may use the Win version, too.
In the Win variant files with similar initial digits are concatenated. They have the form 00to01 ...
original
Windows variant
+ incremental update possible - update requires complete download[1] - significant filesystem overhead
(even with HPFS which has 512 bytes per allocation unit)+ space saving + significantly faster access - slower access + possible on FAT volumes Notes:
The MMPM CD player stores the information about CDs in the file CDP.INI in the MMOS2 folder. This file is in binary OS/2 profile format and should be accessed by the suitable profile functions.
The applications are the CD keys, calculated as follows:
MMSSmmss.ff Example: 46043612.40Within this application the following values ae defined:CDs with only one track have mmss.ff = 0000.00.
- MM
- total length of the CD, minutes [00..99]
- SS
- total length of the CD, seconds, truncated [00..59]
- mm
- total length of the CD minus length of the last track, minutes [00..99]
- ss
- total length of the CD minus length of the last track, seconds [00..59]
- ff
- total length of the CD minus length of the last track, frames (1/75 s) [00..74]
IMMCDDiscTitle CD title, ASCII 1 title track 1, ASCII 2 title track 2, ASCII ...
Application key: Settings
Application key: PendingCDs
value meaning belonging option CDAudioDevice Space separated list of CDaudio device names -d LocalCDDBPath path to the local CDDB -l LocalCDDBType type of the local CDDB -t FuzzyThreshold threshold for fuzzy search -f CDDBservers list of CDDB servers, delimited with blanks -s ProxyServer HTTP proxy address -P Username username used at cddb hello -u Hostname hostname used at cddb hello -h ClientString name and version of the client program used at cddb hello, delimited by a blank. -c OperationCodes list of functions to execute -o CDDBType kind of CDDB query
L local database lookup S server lookup LS both -l, -s CDPiniLocation path to the internal database of the MMOS/2 CD player
Here is the state information about previously checked CDs stored. The name of the values is the table of contents of the CD. The assigned data is the state information.The TOC is coded as follows:
The items are blank delimited.
· number of tracks · total CD length in frames · first frame of track 1 · first frame of track 2 ... · first frame of track n · last frame of track n +1 The state is one of:
1 CD is to be queried 2 time CDDB query was unsuccsessful at time
(unix time format = seconds since 01/01/1970)3 upload packet is pending
Suggestions, help, complaints (but not too much:-): mueller@maazl.de
Original homepage: http://www.maazl.de/project/cddbmmcd/index.html