4.6.3 CD commands

Command: NewCd name directory url

Creates a new cd with name name and directory directory. url should be `yes' or `no'. If it is `yes' then the doodah client will prepend http:// and the name of the server to the filename as well as encoding the filename as a URL. 4.1 Creating CDs.

Command: ScanCd name

Scans the CD named name's directory for files ending with `.mp3'. If it finds them it will check if those files are in the database and if not it will add them. It also creates a band for the MP3 if it can't find one in there already. name can be either the name of the \thing\ or a # followed by the id number of the \thing\, CD.

Command: ShowCds regexp

Lists all the CDs whose name matches the regular expression regexp.

Command: DeleteCd name

Deletes the CD named name and all the MP3s that belong to it. name can be either the name of the \thing\ or a # followed by the id number of the \thing\, CD.

Command: CheckCd name delete

Scans through each of the MP3s on the cd named name and reports (if verbose is on) if they don't actually exist on the filesystem. If delete is yes they will be removed from the database. This helps if you delete an mp3 from the collection but forget to remove it from the database.

Command: SetCdFormat name format

Sets the format for the filenames of the cd named name to format. The string is copied out to generate the filename with % symbols replaced according to the following:

%h

The hostname that the mysql server is on.

%D

The CD's directory.

%d

The MP3's directory relative to the cd directory.

%f

The MP3's filename.

%c

The name of the cd.

%b

The name of the band.

%t

The name of the track.

%i

The ID of the mp3.

For example a format of http://%h/mp3s/%d/%f could generate something like http://localhost/mp3s/rem - out of time/radio song.mp3.

The default format is %D/%d/%f which is fine for most things.