-------------------- X M C D version 1.4 patchlevel 2 -------------------- by Ti Kan This is xmcd version 1.4, a package including xmcd, an X11/Motif-based CD player utility and cda, a command-line driven, non-graphical CD audio player. This software represents many months of development and refinements, as well as a beta test program involving many dedicated individuals around the world. The source code of this version of xmcd and cda supports the following operating systems environments: 1. Apple A/UX (on Apple Macintosh 680x0) - A/UX version 3.0 or later (with devscsi module installed) 2. Data General DG/UX (on DG AViiON m88k) - DG/UX version 5.4R3.00 or later 3. DEC OSF/1 (on DEC Alpha AXP) - DEC OSF/1 version 1.3 or later 4. DEC Ultrix (on DECstation) - DEC Ultrix version 4.3 or later (with SCSI CAM installed) 5. FreeBSD (on Intel x86 PC-compatible) - FreeBSD 2.1 or later with XFree86 (X11R5 or X11R6) + Motif 1.2 6. Hewlett Packard HP-UX (on HP Series 700 PA-RISC) - HP-UX Release 9.x or later 7. IBM AIX (on IBM RS/6000 Power/PowerPC and compatibles from Bull) - AIX version 3.2.x - AIX version 4.x 8. Linux (on Intel x86 PC-compatible) - Linux 0.99 or later with XFree86 (X11R5 or X11R6) + Motif 1.2 9. SCO UNIX System V Release 3.2 (on Intel x86 PC-compatible) - SCO Open Desktop Version 2.x (X11R4 or X11R5 server) - SCO Open Desktop Version 3.x - SCO UNIX 3.2v4.x with XFree86 (X11R5 or X11R6) + Motif 1.2 10. Silicon Graphics IRIX (on SGI) - IRIX version 4.x - IRIX version 5.x 11. Stratus FTX System V Release 4 (on Stratus PA-RISC) - FTX version 3.x 12. SunOS (on Sun Sparc and compatibles) - SunOS 4.1.x / Solaris 1.x 13. SunOS System V Release 4 (on Sun Sparc and compatibles) - SunOS 5.x / Solaris 2.x 14. SunOS System V Release 4 (on Intel x86 PC-compatible) - SunOS 5.x / Solaris 2.x 15. UNIX System V Release 4.0 (on Intel x86 PC-compatible) (Note: 4.0.3 or later recommended) - AT&T - Consensys - Dell - ESIX - ISC - Microport - Micro Station Technology - UHC - USL 16. UNIX System V Release 4.0 (on Motorola 88k) - Motorola 17. UNIX System V Release 4.2 (on Intel x86 PC-compatible) - Consensys - Information Foundation - Novell/Univel UnixWare 1.x - Onsite - USL 18. UNIX System V Release 4.2MP (on Intel x86 PC-compatible) - Novell/USL UnixWare 2.x This release of xmcd features the following: - Standard functions: Stop, Play, Pause, Next/Previous Track, Next/Previous Index, Fast forward/rewind with audio sample, Eject and On/off. - Direct track access keypad and track-warp slider controls. - Volume control with selectable taper characteristics. - Balance control. - Channel routing control: Select between normal stereo, reversed stereo, mono-L, mono-R, or mono-L+R. - Track/Index/Time display: Selectable to display elapsed time, remaining track time, or remaining disc time. - Status display: for current play status, A->B mode, program mode, CD database. - Shuffle (random) play function. - Repeat function with iteration counter. - Sample function: Play a few seconds of each track. - A->B function: Repeat from selectable point A and B. - Eject inhibit function: To prevent someone from ejecting the disc by pressing the button on the drive. - Automation options on CD load, eject, play completion and program exit. - Track Program function: Play tracks in custom order. - CD database function: Allows you to store CD title/track titles in database, and associate each disc with a play program. Displays the current playing disc title/track information. In addition, you can enter and display arbitrary text associated with the disc or each track, such as band information, lyrics, etc. - CD database entry send: Contribute CD database entries to a central archive via Internet electronic mail. - Main window button face labels can be configured to display pictorial symbols, or text with hotkey mnemonics. - The complete application can be operated via the keyboard with full support for keyboard traversal and hotkeys. - All labels and messages can be customized to non-English languages via X resources in the .Xdefaults file. - All colors and many other functionality are user-customizable using X resource settings. - On-line help information. - Attractive, intuitive-to-use Motif user interface. - Device-specific configuration files to make xmcd adaptable to various brands of CD-ROM drives. Xmcd uses the Motif toolkit to achieve a pleasing appearance, such that it actually looks and feels like a real CD player for all basic functions, yet takes advantage of the GUI and window system to make programming and CD database functions easy. Currently, the cda utility offers almost the same functionality as xmcd except the FF, REW, Sample and A->B features are not available. Also, the CD database is read-only via cda (no updates). In addition, a visual mode is available that turns cda into a screen-oriented (curses-based) CD player. This release of xmcd and cda should work with the following CD-ROM drives: Apple CD SC+, CD-150, CD-300, CD-300i Chinon CDS-431, CDX-431, CDS-435, CDX-435, CDS-525, CDX-525, CDS-535, CDX-535 Compaq CDU-561, CR-503BCQ Creative Labs CD-ROM (#) DEC RRD42, RRD43, RRD44 Hitachi CDR-1650S, CDR-1750S, CDR-1950S, CDR-3650, CDR-3750, CDR-6750 IBM 7210-001 Mitsumi FX001S (#). FX001D (#), FX001DE (#), LU005S (#) NEC CDR-72, CDR-74, CDR-77, CDR-80, CDR-82, CDR-84, CDR-38, CDR-74-1, CDR-84-1, CDR-210P, CDR-260 (#), CDR-260R (#), CDR-400 (Multispin 3X), CDR-500 (Multispin 3X), CDR-510 (Multispin 3X), CDR-600 (Multispin 3X), CDR-501 (Multispin 4x), CDR-601 (Multispin 4X) CDR-900 (4XPro) Kotobuki/Matsushita/Panasonic CR-521 (#), CR-562 (#), CR-563 (#) Pioneer DRM-600, DRM-600A, DRM-610, DRM-602X, DRM-604X, DRM-1804X Plextor/Texel DM-3024, DM-5024, DM-3028, DM-5028, PX-43CH (4Plex), PX-45CH (4Plex), PX-43CS (4Plex), PX-45CS (4Plex) Procom CDT4-3X, CDT4-DS, CDT4-MX, CDT7-3X, CDT7-DS, DSP-DR0020, ICD-MX, MCD-DS, MCDN-3X, SICD-DS, SICDN-3X, SXCD-DS, SXCDN-3X Sony CDU-31A (#), CDU-33A (#), CDU-55E (#), CDU-55S, CDU-541, CDU-561, CDU-6111, CDU-6211, CDU-7211, CDU-7811, CDU-8002, CDU-8003, CDU-8003A, CDU-8012 Sun CD-ROM (Sony OEM), CD-ROM (Toshiba OEM) Toshiba XM-3101, XM-3201, XM-3301, XM-3401, XM-3501, XM-4101, XM-8100 Other SCSI-2 compliant CD-ROM drives Other non-SCSI CD-ROM drives (#) (driver support required) Units denoted with a hash symbol (#) are currently supported only on the Linux platform. These drives are typically used with a proprietary interface card or a sound card. The source code release of xmcd/cda version 1.4 is available via Internet anonymous FTP. Location: (Instructions) ftp.x.org:/contrib/applications/xmcd/xmcd-1.4.README (gzip'd tar archive) ftp.x.org:/contrib/applications/xmcd/xmcd-1.4.tar.gz An xmcd CD database is also available via anonymous FTP: (Instructions) ftp.x.org:/contrib/applications/xmcd/xmcd-cddb.README (gzip'd tar archive) ftp.x.org:/contrib/applications/xmcd/xmcd-cddb.tar.gz Both packages require the "gunzip" (GNU unzip) utility to uncompress. The source code to gzip/gunzip can be found on various FTP sites (such as prep.ai.mit.edu:/pub/gnu). This CD database is periodically updated with more entries, and you are encouraged to contribute to this database by using the "Send" feature in xmcd. Binary releases of xmcd and cda for certain OS environments are also available from the author. Please write to "ti@amb.org" for more information. Changes since v1.3: ------------------- CD-ROM drive support changes: - Added support for the Chinon CDx-525, DEC RRD44, NEC CDR-210P, Plextor PX-43CS/PX-45CS, Sony CDU-55S and Toshiba XM-3501 SCSI CD-ROM drives. - On the Linux platforms only, added support for the Mitsumi FX001, LU005S, NEC CDR-260, CDR-260R, Panasonic/Matsushita/Kotobuki CR-521, CR-562, CR-563, and Sony CDU-31A, CDU-33A and CDU-55E CD-ROM drives. These are non-SCSI drives using a proprietary interface card, sound card or an IDE/EIDE/ATAPI interface. Xmcd/cda must be configured to run using the SunOS/Linux ioctl method to use these (rather than SCSI pass-through). Also, the appropriate driver support must be configured in the kernel. - On SCSI-2 drives, the IMMED bit in the Start Stop Unit SCSI command CDB is now set. This causes the CD ejects command to complete immediately, avoiding command time-out situations on some platforms. - When ejectOnExit was set, the CD wasn't being ejected when the program quits (on certain SCSI-1 CD-ROM drives only). This is now fixed. - The version number of the LIBDIR/xmcd/config/.cfgtbl/* files have been bumped to 2. A new field is added to these files to configure the new noTURWhenPlaying parameter in device.cfg. OS Support changes: - Add support for the FreeBSD (version 2.1 or later) platform. See the README file for special notes about the kernel and SCSI driver configuration. - The configure.sh script was not properly setting the MAILCMD variable on some OS platforms. Fixed. - Added a SunOS/Linux ioctl method module to libdi. This is primarily used to support non-SCSI CD-ROM drives using a proprietary interface card under Linux. Although this method can be used with SCSI CD-ROM drives under Linux, SunOS 4.1.x, and Solaris 2.x platforms, it is recommended that the SCSI pass-through method be used instead. - Fixed a problem with the volume slider not being properly initialized on the DEC OSF/1 and Motorola SVR4/m88k platforms. - The configure.sh script no longer rejects a device node path that doesn't exist on the Solaris 2.x platform with the Solaris Volume Manager. Misc changes: - Enhanced the libdi design such that multiple CD-ROM controlling methods can be implemented and coexist. The original support for SCSI pass-through is now an instance of a method. This change involves adding another jump table for all libdi functions to branch control to the appropriate method. The device.cfg file now has a new deviceInterfaceMethod parameter that configures the actual method to use. See the PORTING file for details. - The cda utility now supports a "visual" mode that turns cda into a screen-oriented (curses-based) CD player. - Implemented work-around to avoid hitting a bug in some versions of Motif-1.2. The symptom was a xmcd crash when the CDDB/Program subwindow is closed. - The xmcd CDDB/Program window Track List now highlights the appropriate entry when a track title is being edited in the Track Title Editor box, even if a track is not explicitly selected. Also, the Track List now automatically scrolls down as tracks titles are entered. - Xmcd now displays an error message if a CDDB Save operation fails due to a full filesystem. - The dbdir parameter in common.cfg and the XMCD_DBPATH environment variables now support tilde-expansion (e.g., ~/somepath or ~someuser/somepath is now handled correctly). - Xmcd and cda now creates a directory /tmp/.cdaudio. All lock files, fifo nodes, and other temporary files are created and deleted under that directory (instead of directly in /tmp). This is because many platforms set the sticky bit in the /tmp directory permissions, making it cumbersome for xmcd/cda to maintain lock files (one user's xmcd process should be able to delete another's lock file if the other process has exited). - The misc.d/makesrc.sh and misc.d/makerel.sh scripts have been further enhanced to print informative messages, and these now work correctly on systems with a limited command line length. - Removed the BUGS file and added the FAQ file. - Added the "reggae" and "folk" categories to the standard CD database. - Other enhancements and cleanups. Xmcd v1.4 patchlevel 1: ----------------------- OS Support changes: - Corrected a minor problem with the FreeBSD platform support. Xmcd v1.4 patchlevel 2: ----------------------- CD-ROM Support changes: - Corrected a problem with the Sony CDU-55E ATAPI CD-ROM drive support on the Linux platform.