XMCD(1)XMCD(1)NAMExmcd - CD digital audio player utility for X11/Motif
SYNOPSISxmcd [toolkitoption ...] [-dev device] [-outport mask#]
[-instcmap] [-remote] [-rmthost hostname] [-help] [-debug
level#] [-c device] [-X] [-o] [command [arg ...]]
DESCRIPTION
Xmcd is a program that allows the use of the CD-ROM, CD-R,
CD-RW or DVD drive as a full-featured stereo compact-disc
player and "ripper" for the X window system. See cda(1)
for the command-line CD player. xmcd and cda uses the
same configuration and support files.
Most of the features found on "real" CD players are
available in xmcd, such as shuffle and repeat, track
programming functions, a numeric keypad and track warp
slider for direct track access. Additional functions
include sample play, A to B segment play, volume control,
balance control, etc. Several automation options are also
available on CD load, eject, play completion and program
exit. A Channel Routing feature allow you to select from
several stereo or mono routing options. The volume
control slider taper characteristics can also be altered.
CDDA (CD digital audio) data extraction, playback, save-
to-file, and pipe-to-program are supported on many
platforms. For data extraction to file or pipe, xmcd can
generate the data in MP3 (MPEG layer 3), OggVorbis, WAV,
AU, AIFF, AIFF-C and raw headerless formats. Simultaneous
extraction to file/pipe and real-time playback is possible
on high performance computers.
Multi-disc changers are also supported. There are buttons
to switch to the next or previous disc in the changer, as
well as a way to specify a specific disc via the keypad.
You can select to play only a single disc or auto-play all
discs in normal or reverse order.
The Gracenote CDDB(R) Music Recognition Service(sm) is
supported by xmcd, which allows the CD artist/title and
track titles, and other information associated with the
loaded CD to be displayed. You may also add/modify and
submit information to the CDDB service. For CDDA
extraction to MP3 and OggVorbis formats, xmcd can auto-
fill the CD information tags embedded in these files.
This release of xmcd supports the enhanced Gracenote
CDDB2(R) service on a number of platforms, and offers much
richer features and content than the "classic" CDDB
service. Moreover, CDDB2-supplied information is now in
UTF-8 data format, providing localization support. See
"LOCALIZATION" below.
Xmcd provides the ability to drive a web browser and
search for web sites related to the currently playing CD
artist or track. You may also access online music reviews
and go to the official xmcd and Gracenote web sites,
invoke the CDDB Music Browser(tm), as well as CDDB-
provided links to related content. Moreover, the browser
integration gives users the ability to manage Local
Discography information pertaining to their CD
collections.
In addition to CDDB, this release of xmcd supports reading
CD-TEXT data from the disc for the disc/track artist and
title information.
Full feature-specific pop-up help is available for all
controls, indicators, text input fields, and lists.
On systems with more than one CD drive, multiple
invocations of xmcd can be used to operate each drive
independently.
Xmcd is designed to be easy to use, as the main window is
purposely made to resemble a real CD player front panel.
All other pop-up windows are also designed to be as
intuitive as possible. Moreover, while the use of a mouse
is natural with xmcd, all functionality can also be
operated via the keyboard. This is in conformance to the
guidelines published in the OSF/Motif Style Guide from the
Open Software Foundation.
Many functions on a running xmcd session can be "remote
controlled" from the command line via the -remote option.
See the "OPTIONS" section below.
The internal architecture of xmcd is designed to be easily
portable to many UNIX operating system variants, and
adaptable to the myriad of CD drives available.
OPTIONS
All standard Xt Intrinsics toolkit options are supported
(such as -display, -geometry.-iconic, etc.). In
addition, xmcd supports the following options:
-dev device
Specifies the path name to the raw CD device. If
this option is not used, the default device to be
used is the first drive set up with the xmcd
configuration program (See below).
-outport mask#
Specifies the audio output port for CDDA real-time
playback mode. The mask specifies the output
port(s) desired:
1 Internal speaker
2 Headphone
4 Line-out
You may add the values together to enable multiple
output ports (i.e., A value of 3 turns on both
Internal Speaker and Headphones). When the mask is
set to 0, the port setting is unmodified, and an
external audio control utility may be used to
change the settings. Note that this option may be
meaningful only on some platforms, and only certain
ports may be available on a particular
architecture. See the PLATFORM file for details.
-help Causes command line usage information to be
displayed on stderr.
-debug level#
Causes verbose debugging diagnostics to be
displayed on stderr. The level specifies the type
of debugging messages desired:
1 General debugging
2 Device I/O debugging
4 CD information debugging
8 User interface debugging
16 Remote control debugging
32 Sound DSP and output file/pipe debugging
You may add the values together to enable multiple
debugging types (i.e., A value of 3 turns on both
General and Device I/O debugging).
-instcmap
Causes xmcd to install its own colormap. This may
be desirable if xmcd is to be used at the same time
as other color-intensive applications, which would
otherwise cause xmcd to be unable to allocate all
its needed colors. Note that when running on an X
display that does not support many concurrent
colormaps, this may cause other windows to change
colors when xmcd has the input focus.
-remote
Causes a command to be sent to another running xmcd
process. The command and appropriate arguments are
specified at the invoking shell (or shell script)
as command-line arguments, After the command is
delivered, the "sender" xmcd process exits, and the
"receiver" process responds by executing the
command. In effect, the sender becomes a remote
control for a running xmcd session. See "COMMANDS"
below for a list of supported commands.
The sender xmcd process can be invoked on the same
host or on a different host than the receiver xmcd
process. By default, the sender will attempt to
locate an xmcd process running on the same X
display (determined by the DISPLAY environment
variable or the -display option), and controlling
the same default CD device. You may specify the
device via the -dev option to override the default.
Use of the -dev and -rmthost options on the
sender's command line can resolve ambiguities when
there are multiple xmcd clients displaying on the
same X server.
-rmthost hostname
This may be used with the -remote option to specify
the host on which the receiver xmcd client must be
running.
-c device (Solaris only)
Same as the -dev option.
-X (Solaris only)
Causes the exitOnEject parameter to be set to True.
-o (Solaris only)
This option has no effect.
The -c, -X and -o options are provided only on the Solaris
platform for compatibility with the action_workman.so
auto-startup program, running under the Solaris Volume
Manager (vold). See the README file in the xmcd
distribution about configuring xmcd for the Solaris Volume
Manager.
X RESOURCES
Xmcd has many adjustable X resources to customize its look
and feel, as well as its behavior. Notably, the colors of
virtually every feature on xmcd's windows can be changed,
as well as the text fonts. All text labels can also be
changed (for example, to another language).
There are too many resources to list here, but the
resource names and their defaults (plus descriptive
comments) can be found in the XMCDLIB/app-defaults/XMcd
file (where XMCDLIB is the xmcd library directory
specified during installation, typically
/usr/lib/X11/xmcd). It is not recommended that you change
values in the XMCDLIB/app-defaults/XMcd file, unless you
want the changes to be forced upon all users of xmcd on
the system. Instead, make a copy of this file, change the
copy as you see fit, then place it in your $HOME/.xmcdcfg
directory. Your custom resource settings will then
override the defaults when xmcd is subsequently started.
Alternatively, you may also place specific resources you
wish to override in the .Xdefaults file in your home
directory.
COMMANDS
You may specify a command as an xmcd command line
argument, to make xmcd execute the command after initial
startup. For example, the following command starts xmcd
and then begins playing at track 4:
xmcd play 4 &
If the -remote option is used, then the command is sent to
another running xmcd process for execution (See "OPTIONS"
above).
The supported commands are:
stop Stop playback.
play [track# | min:sec | track#:min:sec]
Start playback. You may also specify the starting
track number, and/or the starting minute and second
offset.
pause Pause the playback. You may resume the playback by
using either the pause command again, or the play
command.
sample Start sample playback. This will play the first 10
seconds of each track.
disc <load | eject | prev | next | disc#>
Perform a disc operation: Load or eject the CD, or
change to another disc on a multi-disc changer.
track <prev | next | track#>
Perform a track operation: Change to the previous
or next track, or a specified track number.
index <prev | next>
Perform an index operation: Change to the previous
or next index.
lock <on | off>
Enable or disable the caddy (or disc tray) lock.
When enabled, pressing the eject button on the
drive will not eject the CD.
shuffle <on | off>
Enable or disable shuffle (random play) mode.
repeat <on | off>
Enable or disable repeat mode.
program <clear | save track# ...>
Clear, save or set a track program sequence. Track
numbers may be space or comma-separated.
volume <value# | linear | square | invsqr>
Volume control operation. You can specify a
numeric value to set the volume level (The range is
0 to 100), or change the volume control's taper
characteristic: linear, square, or inverse-square.
balance value#
Balance control. The value should be between 0 and
100. 50 is center, 0 is full-left, and 100 is
full-right.
route <stereo | reverse | mono-l | mono-r | mono | value#>
Channel routing control. Use one of the
appropriate keywords, or a value as follows:
0 Normal stereo
1 Reverse stereo
2 Mono-L
3 Mono-R
4 Mono-L+R
time <elapse | e-seg | e-disc | r-trac | r-seg | r-disc>
Change the time display mode. Select from elapsed
track time, elapsed segment time, elapsed disc
time, remaining track time, remaining segment time
or remaining disc time.
on-load <none | spindown | autoplay | autolock |
noautolock>
Enable or disable options when a CD is loaded. The
spindown option will cause the CD to stop after
loading to conserve the laser and motor. The
autoplay option will cause the CD to automatically
start playing after loading. The autolock option
causes the caddy or disc tray to be automatically
locked. The none, spindown and autoplay options
are mutually-exclusive.
on-exit <none | autostop | autoeject>
Enable or disable options when xmcd exits. The
autostop option will cause xmcd to stop playback,
and the autoeject option will cause xmcd to eject
the CD. Use none to cancel these options.
on-done <autoeject | noautoeject | autoexit | noautoexit>
Enable or disable options when xmcd is done with
playback. The autoeject option causes xmcd to
eject the CD. The autoexit option will cause xmcd
to exit.
on-eject <autoexit | noautoexit>
Enable or disable options when xmcd ejects a CD.
The autoexit option will cause xmcd to exit after
ejecting the CD.
changer <multiplay | nomultiplay | reverse | noreverse>
Enable or disable multi-disc changer options. The
multiplay option specifies that xmcd plays all
discs in sequence. The nomultiplay option will
cause xmcd to stop after the current disc is done.
The reverse option implies multiplay, except that
the disc order is reversed.
mode <standard | cdda-play | cdda-save | cdda-pipe>
Selects the playback mode. See "PLAYBACK MODES"
below for details about the modes.
jittercorr <on | off>
Enable or disable CDDA jitter correction.
trackfile <on | off>
For cdda-save mode, specifies whether a separate
file should be created for each CD track.
subst <on | off>
For cdda-save mode, specifies whether space and tab
characters in the output file path name should be
substituted with underscores ('_'). This makes the
files easier to manipulate while using the UNIX
command shell.
filefmt <raw | au | wav | aiff | aiff-c | mp3 | ogg>
Specifies the output audio file format if running
in cdda-save or cdda-pipe modes.
outfile <template>
Specifies the output audio file path name template
if running in cdda-save mode (default is audio.ext,
where ext is dependent upon the file format
selected). See the help file for the CDDA output
file path template text box for a description on
the special tokens that could be used in the
template.
pipeprog <path [arg ...]>
Specifies the external program to which the audio
stream will be piped to when running in cdda-pipe
mode.
compress <<cbr | abr> [bitrate#] | <vbr | vbr2> [qual#]>
If the output file format is mp3 or ogg, this
command selects the file compression scheme to be
used. The cbr method indicates "constant bitrate",
the abr method denotes "average bitrate", and the
vbr modes indicate "variable bitrate". There are
two variable bitrate algorithms to choose from.
Vbr is a time-tested algorithm, whereas the vbr2
mode is a newer, faster algorithm that also
produces great results. For the cbr and abr modes,
an optional bitrate (in kb/s) sub-argument can be
specified. The supported bitrates are a discrete
set of numbers from 32 to 320. A value of 0 can
also be used to indicate the use of an internal
default. For the vbr modes, an optional quality
factor (from 1 to 10) sub-argument can be used.
Lower bitrates and quality factor values yield
smaller files whereas higher numbers produce higher
audio quality.
Note: For the ogg format, cbr and abr selects the
same internal algorithm and the two vbr modes are
synonymous.
min-brate <bitrate#>
In average bitrate and variable bitrate modes, this
commands lets you specify a low bitrate limit. The
encoder will not drop below this limit while
dynamically changing the bitrate. A value of 0 can
be specified to indicate the use of an internal
default.
max-brate <bitrate#>
In average bitrate and variable bitrate modes, this
commands lets you specify a high bitrate limit.
The encoder will not go above this limit while
dynamically changing the bitrate. A value of 0 can
be specified to indicate the use of an internal
default.
mp3 <stereo | j-stereo | force-ms | mono | algo#>
If the output file format is mp3, this command
selects the stereo mode and encoding noise-
shaping/psychoacoustics algorithm. The algorithm
is a number from 1 to 10. Lower numbers gives
faster encoding whereas higher numbers produce
higher audio quality.
lowpass <off | auto | freq# [width#]>
For encoding to mp3 files, this allows a lowpass
filter to be added. The off setting means no
filter, the auto setting causes the encoder to
determine whether a filter should be added and its
parameters. Specifying a frequency (and
optionally, a width) will enable the filter in
manual mode. The frequency and width are both in
Hz. The valid frequency range is from 16 to 50000
Hz.
highpass <off | auto | freq# [width#]>
For encoding to mp3 files, this allows a highpass
filter to be added. The off setting means no
filter, the auto setting causes the encoder to
determine whether a filter should be added and its
parameters. Specifying a frequency (and
optionally, a width) will enable the filter in
manual mode. The frequency and width are both in
Hz. The valid frequency range is from 500 to 50000
Hz. The lower limit is imposed by the polyphase
filter implementation in the MP3 encoder.
flags <[C|c][O|o][P|p][E|e][I|i]>
This allows you to specify some mp3 header and
frame flags. The letter c denotes the "copyright"
flag, the letter o denotes the "original" flag, the
letter n denotes the "no res" (disable bit
reservoir) flag, the letter e denotes the addition
of a 2-byte checksum to each frame for error
correction, and the letter i indicates strict ISO
compatibility. The use of a upper-case letter
turns on the flag, and lower-case turns off the
flag. Multiple flags may be specified together.
tag <off | v1 | v2 | both>
This command specifies whether an ID3tag should be
added to an mp3 output file (and which version of
the ID3 tag should be added). For ogg files, a
comment tag is added if the argument is not set to
off.
Note: A ID3v2 tag will not be added to the cdda-
pipe stream regardless of the setting of this
command.
window <modechg | iconify | deiconify | raise | lower>
Xmcd window control. The modechg command causes
the main window to toggle between the normal mode
and basic mode. In normal mode, all controls and
indicators are available. In basic mode, xmcd
shrinks to a smaller size and only basic controls
are shown. The iconify, deiconify, raise and lower
commands cause the xmcd window to change as
specified.
quit Causes xmcd to exit.
debug <level#>
Set the debug level. When debug level is non-zero,
xmcd generates verbose debugging diagnostics to be
displayed on stderr. See the description for the
-debug option above for supported level values.
Some of these commands, when used in start-up mode, do not
perform a meaningful function. For example, the "track
prev" command is not useful just after xmcd startup. It
is more appropriate to use this command in the remote
control mode.
DEVICE CONFIGURATION
The X resources described in the previous section affect
the general appearance and behavior of xmcd. There are
two additional configuration files which are used to adapt
xmcd to your site requirements. The first of these
contain common parameters, and the second contain
configurable parameters that must vary on a per-drive
basis. For example, in some cases xmcd must operate the
drive differently depending upon the brand and model of
the drive. Thus, there must be a separate configuration
file for these parameters per-device. The common
parameters file is XMCDLIB/config/common.cfg and the
device-specific parameters file is XMCDLIB/config/DEVICE
(where XMCDLIB is typically /usr/lib/X11/xmcd and DEVICE
is the base name of the raw device special file for the CD
drive; e.g., /usr/lib/X11/xmcd/config/rcd0). A
configuration program XMCDLIB/config/config.sh is provided
to make maintaining these configuration file easy (Note:
on SCO UNIX/Open Desktop/Open Server systems the
configuration program can also be invoked as "mkdev
xmcd").
You should always use the configuration program to set the
configuration parameters when installing xmcd for the
first time, or when the CD hardware configuration has
changed. If this is not done then xmcd will probably not
operate correctly with your CD drive.
WARNING: If xmcd is not correctly configured, you may
cause xmcd to deliver commands that are not supported by
your CD drive. Under some environments this may lead to
system hang or crash.
You can override some of the device-specific configuration
parameters by adding your own configuration files. Xmcd
will also look in the $HOME/.xmcdcfg/common.cfg and
$HOME/.xmcdcfg/DEVICE files for common and device-specific
parameters (where $HOME is your home directory and DEVICE
is as specified above). Parameters found in this file
will override the system defaults (except those parameters
that cannot be overridden; see the comments in the
XMCDLIB/config/device.cfg for details).
USING XMCD
The basic functions of xmcd are designed to operate the
same way as on a real stereo CD player. The pictorial
symbols used on the main window buttons are intended to
illustrate the function in a non-language-specific manner.
If enabled, a small "tooltip" will appear after a short
delay, when you position the mouse cursor over any xmcd
main window feature. The tooltip contains textual
description of the feature.
The CD information and track programming functions are
operated via the CD Information subwindow. You open the
subwindow by clicking the CD Information button (file
cabinet symbol) on the main window (See "CD DATABASE"
below).
There is not a per-item description of all the features
here, because full on-line help is available (See "ONLINE
HELP" below).
ONLINE HELP
For general information about xmcd, click the wwwWarp
(world symbol) button on the xmcd main window and select
'Xmcd help...' in the menu. You can also get specific
help information about each button, control, indicator,
text entry area, selection list by positioning the mouse
cursor over the desired item, then clicking the third
mouse button. A pop-up window will appear, containing the
relevant help text.
TRACK PROGRAMMING
You can program xmcd to play only certain tracks, in a
custom sequence. To do so, invoke the CD Information
window (by clicking the CD Information button on the main
window). Select the desired track by clicking on the
entry in the Track list, and click the Add button to add
to the play sequence. Notice that the track number
appears in the Program sequence text field. You can also
type the track numbers, separated with commas or spaces,
directly in the Program sequence field. Repeat until all
desired tracks have been entered, then click the
Play/Pause button (on the main window) to start the
program play.
When a program sequence is defined, the prog indicator in
the main window display area "illuminates". To erase the
program sequence, click the Clear button on the CD
Information window. You may also Save a program sequence,
so that the next time you load the same CD the program
will automatically be applied. The button will also
delete the saved program.
CD DATABASE
Unless explicitly disabled, xmcd will automatically query
the Gracenote CDDB Music Recognition Service for
information about the loaded CD. This information
includes the artist/title, track titles, genre, and much
more, and is displayed on the CD Information window and
several of its sub-windows.
You may also add, modify or enhance the displayed
information, in the rare circumstance that CDDB does not
have data pertaining to your CD, or if the CDDB-supplied
data is incomplete or in error. You can then submit the
changes back to CDDB.
You should perform a "submit" operation (click the Submit
button) after typing in the changed information before
ejecting the CD or exiting, or the information will be
lost.
The CD Information window should prove to be intuitive to
use. You may use the on-line help system to obtain
specific help information about the various buttons and
items.
The CD information, once queried from CDDB, is stored in a
local cache and managed by the CDDB library. This reduces
unnecessary Internet connections to the CDDB servers.
This release of xmcd also supports reading the CD-TEXT
data from the disc for CD information. Only some recent
CDs are produced with CD-TEXT data and this data can only
be read on CD drives with CD-TEXT capability.
For backward compatibility, this release of xmcd will also
read the old-style local CD database files previously
generated by xmcd versions 1.x and 2.x. No capability is
retained in this release to write/update the old-style CD
database files.
The priority of the CD information schemes (CDDB, CD-TEXT
or local CD database files) is controlled via the
cdinfoPath parameter in the common.cfg file.
For more information about Gracenote CDDB, read the CDDB
file included with this release, and visit the
http://www.cddb.com web site for details.
While xmcd is running, the file /tmp/.cdaudio/curr.nnnn
(where nnnn is the hexadecimal representation of the CD
drive's device number) contains the device node path, CD
database category and disc identifier information
pertaining to the currently loaded CD. Other applications
may read this file to identify the currently loaded disc.
PLAYBACK MODES
This release supports the following user-selectable
playback modes (via the Options pop-up window):
Standard playback
When playing an audio CD, the audio output is the
analog "line out" connection on the back of your CD
drive. There should be an audio cable connecting
this output to your computer audio hardware CD
input (or to an externally amplfied speaker or
stereo system). The audio output is also available
at the CD drive's front panel headphone connection,
if so equipped. The volume control slider bar on
xmcd affect the CD drive's built-in volume control,
if the drive has such controls. This is the mode
that previous releases (xmcd version 1.x through
3.0) supported.
CDDA playback
When playing a CD in this mode, xmcd extracts the
CD digital audio data off the CD drive over the
data cable (e.g., SCSI or ATAPI/IDE). Then, it
sends the data to the DSP (digital signal
processor) device in your computer's audio hardware
for real-time playback. The audio is typically
heard through the computer's built-in speakers. No
signal is produced at the line-out or headphone
connections of the CD drive. The xmcd volume
control slider bar affects the computer's DSP
device.
CDDA save to file
When playing a CD in this mode, xmcd extracts the
CD digital audio data off the CD drive over the
data cable (e.g., SCSI or ATAPI/IDE). Then, it
writes the data into a file of your choosing. The
xmcd volume control slider does not affect the data
written to the output file. The output file format
can be selected to be one of the following:
Format Ext Description
------ ----- ---------------------------------------
RAW .raw Little-endian, 16 bit, 44.1 kHz, stereo
AU .au Big-endian, 16 bit, 44.1 kHz, stereo
WAV .wav Little-endian, 16 bit, 44.1 kHz, stereo
AIFF .aiff Big-endian, 16 bit, 44.1 kHz, stereo
AIFF-C .aifc Big-endian, 16 bit, 44.1 kHz, stereo
MP3 .mp3 Compressed
OGG .ogg Compressed
The file can be played later using an appropriate
playback utility, or converted to another format.
This mode will typically run faster than real-time
with the non-compressed formats. With the
compressed formats, it depends on the CPU
performance of your system.
CDDA pipe to program
When playing a CD in this mode, xmcd extracts the
CD digital audio data off the CD drive over the
data cable (e.g., SCSI or ATAPI/IDE). Then, it
pipes the data stream to an external program that
you specify. The output format is selected as in
the CDDA save to file mode. This mode can be used
with an external audio player, encoder, or other
digital audio manipulation program. The external
program must be capable of accepting audio data on
its standard input, in one of the formats listed
above.
More than one of the three CDDA modes can be selected at
the same time. For example, if both the CDDA playback and
the CDDA save to file buttons are selected, the two
functions will be performed simultaneously. Note that on
most systems, only one program can access the system's DSP
at a time, therefore you will likely not be able to select
CDDA playback and CDDA pipe to program at the same time,
where the external program is itself an audio player.
NOTE: The CDDA (CD digital audio) modes will function only
on CD drives that provides this capability, and only on
some OS and hardware platforms. See the RELNOTES file for
details about platform support and other CDDA related
notes.
LOCALIZATION
There is full localization support in xmcd if it is
compiled with X11R5 or later header files and libraries.
The "classic" CDDB service supplies data in the ISO
Latin-1 format only, multi-byte characters are not
supported.
The CDDB2 service supplies data is in UTF-8 data format,
which is identical to ISO Latin-1 for single-byte
characters. Multi-byte character sets are also supported
when xmcd is linked with X11R5 or later. On platforms
that provides the iconv(3) function, xmcd will attempt to
convert UTF-8 strings to the default character set as
specified by the LANG environment variable. This
conversion will occur only if the system's list of locales
also support UTF-8. Otherwise xmcd will display the UTF-8
strings without modification. As distributed, xmcd is
configured to display in a generic family of X fonts
denotes similar to the following:
-*-helvetica-bold-o-*--14-140-*
This will normally work correctly with English and any ISO
Latin-1 European character set, as long as your X display
server supports all the required fonts. To display in
other languages, you must set your LANG environment
accordingly, and change xmcd to use the appropriate fonts.
That can be accomplished by modifying the various
XMcd*classname.fontList parameters in the XMCDLIB/app-
defaults/XMcd file (system wide) or your
$HOME/.xmcdcfg/XMcd file (per-user). Be sure that the
fonts you specify is actually supported by your X display
server. See xlsfonts(1) and your X window system
documentation about font configuration.
Moreover, all titles and descriptions in xmcd are
configurable in the XMcd X resource file. US-English is
distributed by default, but the file may be modified to
use any other language as desired. See "X RESOURCES"
above.
NOTES
Not all platforms and CD drives support all the features
of xmcd. For example, some drives do not support a
software-driven volume control. On these drives the xmcd
volume control slider may have no effect, or in some cases
it is made to function as a mute control (i.e., it will
snap to the full-off or full-on positions only).
Similarly, the caddy lock, eject and index search buttons
found on xmcd may not have any effect on drives that do
not support the appropriate functionality.
The remote control feature (using the -remote option) is
governed by the standard display server security
mechanisms of the X window system. In order for an xmcd
sender client to communicate with a running xmcd receiver
client, the sender must have the appropriate access
permissions to the receiver client's X display. See
xhost(1), xauth(1) and Xsecurity(1) for more information.
If logging is enabled, remote control activity is logged
by the xmcd receiver client in the
$HOME/.xmcdcfg/remote.log file for each xmcd user.
The lame(1) MP3 encoder program must be installed on your
system in order for xmcd to perform CD ripping to .mp3
format files.
Your copy of the xmcd executable must be compiled and
linked with the OggVorbis encoder libraries in order to
perform CD ripping to .ogg format files.
ENVIRONMENT VARIABLES
The LANG environment variable sets the default character
set. See "LOCALIZATION" above.
For the wwwWarp feature, xmcd invokes the Netscape,
Mozilla, Galeon or Opera web browser to display the
contents. Xmcd searches a number of "standard" locations
for the web browser executable. If you have multiple
browsers installed and would like to direct xmcd to use a
particular executable, or if your browser executable is
installed in a non-standard location, then you may set the
BROWSER_PATH environment variable on the shell command
line to the web browser executable you desire.
An example:
(For Bourne Shell and Korn Shell users):
BROWSER_PATH=/usr/local/bin/netscape; export BROWSER_PATH
(For C Shell users):
setenv BROWSER_PATH /usr/local/bin/netscape
you may put the above command in your $HOME/.profile
(sh/ksh) or $HOME/.cshrc (csh) to set this automatically
each time you log in.
The LAME_PATH environment variable may be used to specify
the path to the lame(1) MP3 encoder program.
The AUDIODEV environment variable may be used to specify
an alternate audio device when running xmcd in the CDDA
playback mode. The default audio device is write method
dependent as follows:
AIX write method: /dev/paud0/1 (PCI audio)
AIX write method: /dev/baud0/1 (MCA audio)
ALSA write method: plughw:0,0
HP-UX write method: /dev/audio
Linux/OSS write method: /dev/dsp
OSF1 write method: 0
Solaris write method: /dev/audio
In addition, with the OSS and ALSA write methods, the
MIXERDEV environment variable may be used to specify the
PCM mixer channel device. The default is /dev/mixer for
OSS, and default for ALSA.
FILES
$HOME/.cddb2/*
$HOME/.xmcdcfg/*
XMCDLIB/app-defaults/XMcd
XMCDLIB/cdinfo/*
XMCDLIB/discog/*
XMCDLIB/doc/*
XMCDLIB/config/config.sh
XMCDLIB/config/common.cfg
XMCDLIB/config/device.cfg
XMCDLIB/config/.tbl/*
XMCDLIB/config/*
XMCDLIB/help/*
BINDIR/xmcd
MANDIR/xmcd.1
/tmp/.cdaudio/*
RELATED WEB SITES
Xmcd/cda web site: http://www.amb.org/xmcd/
Gracenote web site: http://www.cddb.com/
Xmmix web site: http://www.amb.org/xmmix/
LAME MP3 encoder: http://www.mp3dev.org/
OggVorbis: http://www.xiph.org/ogg/vorbis/
Sox audio format conversion utility:
http://www.spies.com/Sox/
SEE ALSOcda(1), X(1), xhost(1), xauth(1), Xsecurity(1),
xlsfonts(1), lame(1), sox(1)
Xmcd's README and INSTALL files
AUTHOR
Ti Kan (xmcd@amb.org)
AMB Laboratories, Sunnyvale, CA, U.S.A.
Xmcd also contains code contributed by several dedicated
individuals. See the ACKS file in the xmcd distribution
for information.
Comments, suggestions, and bug reports are always welcome.
v3.2.0 02/11/18 XMCD(1)
