Debian Codegraph @

upstream/fedora-44/man1/cdda2ogg.1

raw
1 '\"
2 .TH "cdda2ogg" "1"
3 .SH "NAME"
4 cdda2ogg \(em extract audio CD audio tracks and encode them
5 .SH "SYNOPSIS"
6 .PP
7 .B cdda2ogg
8 .PP
9 .SH "DESCRIPTION"
10 .PP
11 .B cdda2ogg is a simple script that uses the
12 .B icedax <fileprefix>
13 command to extract all audio tracks with the
14 .B icedax <fileprefix>
15 command and encode them using the
16 .B ogg123
17 encoder. The scripts are not intended to be full-featured music archiving
18 programs, but only for quick storing of few audio data.
19 It does not use databases like CDDB or have any extra features. You may look
20 at
21 .B icedax
22 if you need them.
23 .PP
24 .B ogg123
25 is provided by the
26 .B vorbis-tools
27 which needs to be installed separately.
28 See
29 .B www.ogg.org
30 for more information.
31
32 .SH "CONFIGURATION"
33 .PP
34 .B cdda2ogg
35 have predefined values for reading and labeling of the target files.
36 You can overwrite them with following environment variables:
37
38 .IP "CDDA_DEVICE" 10
39 Source device specification to get the data from.
40
41 .IP "LIST" 10
42 List of track numbers to be read, separated by spaces.
43
44 .IP "CDDA2WAV" 10
45 Defines the command to run the cdda2wav program
46
47 .IP "CDDA2WAV_OPTS" 10
48 Miscellaneous options passed to
49 .IR $CDDA2WAV .
50
51 .IP "MP_CODER" 10
52 The encoder program.
53
54 .IP "MP_OPTIONS" 10
55 Additional options passed to
56 .IR $MP_CODER .
57
58 .IP "FILEPREFIX" 10
59 The base part of the filename of resulting audio files. This can also be specified as the first argument to the script.
60
61 .PP
62 See cdda2ogg script file to get the default values
63 .PP
64 System administrator can also set default values by creating of a shell
65 include file, defining the variables for the POSIX shell, and storing them as
66 /etc/default/cdda2ogg.
67 .SH "EXAMPLES"
68 .PP
69 .B CDDA_DEVICE=/dev/cdrom1 cdda2ogg
70 .br
71 just stores every track in this device in audiotrackNUMBER.ogg
72 .PP
73 .PP
74 .B LIST="1 5 7" cdda2ogg PartsOfBestOfFoo
75 .br
76 stores the selected tracks from the default cdrom device as 01-PartsOfBestOfFoo.ogg, 05-PartsOfBestOfFoo.ogg, 07-PartsOfBestOfFoo.ogg.
77
78 .SH "SEE ALSO"
79 .BR icedax (1)
80 .SH "AUTHOR"
81 .PP
82 This manpage describes the program implementation of
83 .B
84 cdda2ogg
85 as shipped by the cdrkit distribution. See
86 .B
87 http://alioth.debian.org/projects/debburn/
88 for details. It is a spinoff from the original program distributed by the cdrtools project. However, the cdrtools developers are not involved in the development of this spinoff and therefore shall not be made responsible for any problem caused by it. Do not try to get support for this program by contacting the original authors.
89 .PP
90 If you have support questions, send them to
91 .PP
92 .B
93 [email protected]
94 .br
95 .PP
96 If you have definitely found a bug, send a mail to this list or to
97 .PP
98 .B
99 [email protected]
100 .br
101 .PP
102 writing at least a short description into the Subject and "Package: cdrkit" into the first line of the mail body.
103 .PP
104 This manual page was written by Eduard Bloch
105 ([email protected]) for the
106 .B "Debian GNU/Linux system (but may be used by others). Permission is granted
107 to copy, distribute and/or modify this document under the terms of the GNU
108 General Public License, Version 2 as published by the Free Software Foundation.