S-CDDA-TO-DB(1)

NAME
s-cdda-to-db - 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

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 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 is used, and please see there (below) for more.

- -frames=NUMBER
    Passed to s-cdda(1) as its -f 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 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.

-v  Be more verbose.

The default mode of operation (without any of -e, -g, -h, -r) is to read and encode an audio CD.

ENVIRONMENT

EDITOR
    Used if VISUAL 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 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 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 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>