CDCD(1)

💿 CDCD(1) — Command Driven CD player ✨

bestie. sit down. we're talking about cdcd, the Command Driven CD player from the General Commands Manual, section 1. it's giving retro-tech main character energy and honestly? obsessed.

---

🎀 NAME

cdcd — Command Driven CD player 🫶

---

✨ SYNOPSIS

cdcd [OPTION]...  [COMMAND]

---

💖 DESCRIPTION

okay so here's the tea ☕ — cdcd lets you control a CD player either directly off of the command line or in its own interactive query mode.

if you just run cdcd with no command? boom, it drops you into query mode, like a little hangout. but if you hand it a command, it'll run that one command and then dip — terminate when it's finished, no lingering. periodt. 💅

---

🦋 OPTIONS

• --device DEVICE — the long-form spelling of the device option right below 👇
• -d DEVICE — use DEVICE as the CD device, bestie. DEVICE is the device special file name of the CD-ROM device.

⚠️ real talk: do not use a Linux SCSI Generic device. just don't. 🙈

---

🌈 USAGE

these are the supported commands, and yes we're going through all of them because every single one is iconic:

• play [start track] [end track] [min:sec] — if start track is specified, play will play that track instead of the first track. if end track is specified, the disc gets played from the start track to the end track. start track and end track may either be part of or an entire track title 👑. if a starting position is specified (in the form min:sec), then the disc begins playing the specified amount of time into the specified track. you can also specify a starting position without specifying a start track, or only specify a start track and starting position while specifying no end track. flexible queen behavior. 🎶
• stop — stops the CD if it's playing.
• open, eject — ejects the CD-ROM tray. bye babes 👋
• close — closes the CD-ROM tray. welcome back 💖
• pause — pauses the CD if it's playing.
• resume — makes a paused CD resume playing. the comeback ✨
• ff [min:sec] — fast-forwards the CD 15 seconds by default, or the specified amount of time.
• rew [min:sec] — rewinds the CD 15 seconds by default, or the specified amount of time.
• next — advances the CD one track.
• prev — returns the CD to the previous track.
• getvol — returns the current volume settings.
• setvol [left front] [right front] [left rear] [right rear] — sets the CD-ROM volume to the given settings.

🫶 heads up: most CD players only support the front two channels.

• status — gives only numerical data regarding the CD's status. no vibes, just numbers.
• info — gives disc name, artist, current track name, and disc positions.
• tracks — lists all tracks on the CD and their lengths.
• rndplay — plays a random track. chaos mode 🎲
• list — lists all CDs in a CD-ROM changer.
• slot — changes the current CD in the CD-ROM changer.
• edit [name, artist, genre, track no.] [value] — edits information about the disc. you may specify name, artist, genre, or the number of the track you wish to edit. glow-up your metadata 💅
• ext [track no., disc] — displays extended information about the disc. if no parameter is given it will display information about the current track. specifying disc will display information for the disc itself.
• refresh — connects to a server and retrieves information about the CD even if there already exists information about it. otherwise, this is done automatically by any command that uses disc/track names.
• device [device name] — sets the CD-ROM device cdcd will use in future invocations which don't specify the -d option. cdcd stores this information in your .cdcdrc file. 📁
• verbose [on, off] — toggles whether cdcd will display everything that is happening (e.g. when accessing a CDDB or CD Index server). nosy mode: activated 🔍
• quit — exits cdcd.
• sites [refresh, display, add, delete, move] — edits the server list. more specific help on each of the commands is available by typing cdcd help sites.
• submit [e-mail address] — submits a CDDB entry to a CDDB server.
• access [local, remote, proxy] — specifying local will cause CD information requests to return Unknown for track, artist, and album titles, and will not attempt to connect to any servers. remote will cause cdcd to connect to a server whenever any CD information is required. if you need to use a HTTP proxy, it may be specified in the form proxy url, where url is the URL for your HTTP proxy.

---

🌸 COMPLETION

cdcd uses traditional readline command and trackname completion. the way that works is honestly so satisfying 😭

• to complete a command, simply hit 'tab' when you have typed a partially completed command.
• to complete a trackname, first type whatever command you wish to pass a track name to (e.g. play, ext) and then begin with a double quotation mark. type the beginning of the track name and then hit tab. the track name will be completed for you.

like this, bestie:

cdcd> pl<tab>
cdcd> play "See<tab>
cdcd> play "See You On The Other Side"

ate. no crumbs. 🔥

---

🐛 REPORTING BUGS

found a bug? report bugs to <noon@users.sourceforge.net> — they're ready to hear it 🫶

---

and that's the whole page, babe — CDCD(1), living in the General Commands Manual, section 1. no version stamp, no date on this one, just pure vintage command-line charm. go forth and play some CDs 💿💖✨