(Generated by  groff(1))

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.6.2, 2021-01-30] — 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-volume-normalize]

s-cdda-to-db [−v] [−d DEVICE] −r
s-cdda-to-db
[−v] [−d DEVICE] [−f FORMATS] [−−frames=NUMBER] [−m PATH] [−−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[20] 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[19] is used, please see there for more.

−−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[22] is not set (see there).

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>

Copyright (c) 1997 - 2021, Steffen Nurpmeso <steffen@sdaoden.eu>
@(#)code-cdda-to-db.html-w42 1.3 2021-01-28T23:06:18+0000