CDDA-TO-DB manual

This plain ∞ groff(1) HTML output has only been fixed slightly — i am sorry for false list indentions etc.!

S-cdda-to-db [v0.8.0, 2021-06-18] — read and encode audio CDs, integrated in S-Music DB

SYNOPSIS

s-cdda-to-db −h
s-cdda-to-db −g

s-cdda-to-db [−v] [−d DEVICE] [−f FORMATS] [−−frames=NUMBER] [−m PATH] [−−[

no- ]music-brainz] [−−music-brainz-tls] [−−no-volume-normalize]

s-cdda-to-db [−v] [−d DEVICE] −r
s-cdda-to-db [−v] [−d DEVICE] [−f FORMATS] [−−frames=NUMBER] [−m PATH] [−−[

no- ]music-brainz] [−−music-brainz-tls] [−−no-volume-normalize] −e CDID

TABLE OF CONTENTS
NAME[1]
SYNOPSIS[2]
TABLE OF CONTENTS[3]
DESCRIPTION[4]
Options[5]
ENVIRONMENT[6]
SEE ALSO[7]
AUTHORS[8]

DESCRIPTION

s-cdda-to-db queries the content and data of audio CDs through s-cdda(1), collects informations, like name of artist, album, song titles, etc., of desired audio tracks, if possible correlates data with a web query against MusicBrainz: https://musicbrainz.org, and integrates encoded variants of the audio tracks as well as a human readable database file in a per-CD directory under a directory tree. Multiple audio encoding formats are supported, and as much of the collected information as possible is also stored in the encoded files itself. The user will be asked to edit collected informations, and will be given documentation for the rather sophisticated (classical music aware) database layout while doing so.

Options

−d DEVICE

Specify the CD-ROM DEVICE. This is passed to s-cdda(1) via the same option if specified, please see there for more, also for which defaults come into play when not specified.

−e CDID

Only resume a −r[16] read-only session; the CDID was echoed by it.

−f FORMATS

The list of target audio encoding formats, as a comma-separated list. If not given the environment variable S_MUSIC_FORMATS[22] is used, and please see there (below) for more.

−−frames=NUMBER

Passed to s-cdda(1) as its −f[11] option, please see there for more.

−g

Only show a (the well-known MP3 info) music genre list, then exit.

−h

Show a brief usage summary, then exit.

−m PATH

The top directory of the S-Music DB. If not given the environment variable S_MUSIC_DB[21] is used, please see there for more.

−−[
no-]music-brainz

Always (do not) query information data from MusicBrainz: https://musicbrainz.org. By default an interactive prompt will appear instead.

−−music-brainz-tls

After problems with encrypted queries in the past unencrypted queries are now the default.

−−no-volume-normalize

By default time and frequency domain statistical informations over all (selected) CD audio tracks is collected, then the volume is raised by the minimum applicable value that does not cause clipping in any of the chosen tracks. Normalization can be undesireable if a CD is not encoded in one go. Remarks: without this option the program sox(1) is required.

−r

Only select and read tracks from an audio CD to a temporary working directory, echo the CD identity string, then exit. Such a session can be resumed via −e[10] .

−v

Be more verbose.

The default mode of operation (without any of −e[10] , −g[13] , −h[14] , −r[16] ) is to read and encode an audio CD.

ENVIRONMENT
EDITOR

Used if VISUAL[24] is not set (see there).

LC_ALL

The master switch to configure all locale(1)s to a specific locale(7), for example ‘export LC_ALL=en_US.UTF-8’ or ‘export LC_ALL=en_US.utf8’; locale names differ in between operating systems. Best is to run this program in an Unicode UTF-8 locale: metadata will always be stored in UTF-8, and only few encoders (like oggenc(1) and flac(1)) support command line options to (further) suppress character set conversions.

PERL5OPT

Should be set to ‘-C’ in an Unicode environment in order to configure perl(1) for UTF-8 input and output; also see perlrun(1).

S_MUSIC_DB

The top directory of the S-Music DB, that is, where the per-CD directory is to be created.

S_MUSIC_FORMATS

A comma-separated list of case-insensitive target audio encoding formats, for example ‘aac,aaclo,ogg’: here high quality AAC (MP4) and OGG output formats as well as low quality AAC output has been chosen, which means that each audio input track will be encoded to three different output files (in parallel). The full list of audio formats and quality levels can be seen in the −h[14] output, note, however, that the actual encoding software still has to be installed separately. (The script header of s-cdda-to-db can be inspected to see which tools are needed for which format, unless implicitly clear through the chosen formats; and see SEE ALSO[7] below.)

TMPDIR

This variable defines the directory where the temporary working directory shall be created under. If this is not set /tmp will be used.

VISUAL

The pathname of the text editor to use for editing purposes. EDITOR[18] will be tried if this is not set.

SEE ALSO

faac(1), flac(1), lame(1), oggenc(1), opusenc(1), s-cdda(1), sox(1)

AUTHORS

Steffen Nurpmeso <steffen@sdaoden.eu>