CDTOOL(1)

✨ CDTOOL — bestie's guide to playing and cataloging audio CDROMs 💿✨

okay so hi 🫶 this is the cdtool family of commands, and they do exactly what it says on the tin: play and catalog audio CDROMs on your CDROM drive(s). no cap. let's get into it.

---

🌸 SYNOPSIS 🌸

cdeject   [-[0..9]|-d device]  [-V|-?|-h]
cdclose   [-[0..9]|-d device]  [-V|-?|-h]
cdir -n   [-[0..9]|-d device]  [-r|-s|-t|-V|-?|-h]
cdinfo    [-[0..9]|-d device]  [-a|-r|-s|-t|-v|-V|-?|-h]
cdpause   [-[0..9]|-d device]  [-V|-?|-h]
cdplay    [-[0..9]|-d device]  [start [stop]
cdplay    [-[0..9]|-d device]  [+|- number]
cdplay    [-[0..9]|-d device]  [start|stop|resume|eject|close|info|dir]
cdplay    [-[0..9]|-d device]  [-V|-?|-h]
cdstop    [-[0..9]|-d device]  [-V|-?|-h]
cdvolume  [-[0..9]|-d device]  [-V|-?|-h|level]
cdshuffle [-[0..9]|-d device]  [-V|-?|-h]

(yes bestie, that one cdplay line is missing a closing bracket. it's giving "shipped it anyway" and honestly? iconic. we keep it exactly as it is. 💅)

---

💖 DESCRIPTION 💖

🎀 cdeject

The cdeject command ejects the current compact disc. bye bestie, the disc is leaving the building 👋

🎀 cdclose

The cdclose command closes the CDROM tray. come back inside bb, it's cold out there 🥺

🎀 cdir

The cdir command lists information about the currently loaded audio compact disc. In particular, it lists the lengths of all tracks. It also references the database files specified in the CDTOOLPATHDB environment variable and the ~/.cdtooldb file, which use a simplified version of the format used by workman(1). If one of these files contains an entry for the current compact disc, cdir will print title, artist, and track name information. so like, it's doing the detective work for you 🔍

• -n — Do not lookup any information in the database files. no snooping, we're going in blind 🙈
• -s — Print information in a short format: only author, title, and current track, all on one line. the TL;DR version ✨
• -t — Print a template for the current cd, including title, artist, and track name information if available. If blank lines are filled in, this can be appended to the ~/.cdtooldb file. it's giving "fill in the blanks and make it official" 📝

🎀 cdinfo

The cdinfo command, with no option used, will print out the audiostatus (playing, etc.). so basically it's the vibe check for your disc 🔮

• -a — Print out the absolute disc time.
• -r — Print out the relative track time.
• -s — Print out the audiostatus.
• -t — Print out the current track.
• -v — All info: status track absolute relative. the whole gossip, nothing held back 💅

🎀 cdpause

The cdpause command pauses the currently playing compact disc. Resume by using cdplay with no arguments. it's a lil intermission, not a breakup 🫶

🎀 cdplay

The cdplay command plays the compact disc. Let's break down the drama:

• If called with one argument, this is the starting track number.
• If called with two arguments, these are the starting and stopping track numbers.
• If the first argument is a + or - then skip the number of tracks given by the second argument forward or backward. If no second argument is given, skip one. hop hop hop 🐰
• A 0 as first argument or no argument replays current track. it's a rewind moment, we're obsessed with this song actually 🔁

🎀 cdstop

The cdstop command stops the compact disc, if it is playing. rude but necessary ✋

🎀 cdvolume

The cdvolume command sets the output volume level of the CD player. The level is an integer from 0 to 255. turn it UP, main character energy only 🔊🔥

🎀 cdshuffle

The cdshuffle command plays the audio tracks on the disc in random order. chaos mode activated, and honestly? it ate 🎲

---

🦋 devices & universal options 🦋

The default device opened is /dev/cdrom. This default and others may be changed in config.h. Options supported by all programs are:

• -[0..7] — Multiple cdrom support to open /dev/scd0../dev/scd7 [by default]. pick your drive, bestie 🔢
• -d device — Multiple cdrom support to open device by name. name-drop your hardware 💅
• [-h|-?] — Print out help for the command. when you're lost and need a hand 🤝
• -V — Print out version information and build information. the receipts 🧾
• -D — Enable runtime debugging. for when you're deep in the lore 🕵️

---

🌈 FILES 🌈

• ~/.cdtooldb – default database file.

---

🧚 ENVIRONMENT 🧚

• CDTOOLDBPATH – colon delimited path of database files to search. It is not necessary to specify ~/.cdtooldb, as this is automatically added to the end of the search path. she always shows up to the party, no invite needed 🎉
• CDTOOLDEV – device file for cd-rom, overrides compile-time defaults. this one overrules the original plan, periodt 👑

---

⭐ SEE ALSO ⭐

cdctrl(1), cdadd(1), cdown(1) — go read these too, iykyk 📚

---

👑 AUTHORS 👑

Main code:

• Thomas Insel <tinsel@tinsel.org>

Enhancements:

• Byron Ellacott <rodent@homer.humbug.org.au>
• Wade Hampton <whampton@staffnet.com>
• Lin Zhe Min <ljm@ljm.wownet.net>
• Sven Oliver Moll <smol0075@rz.uni-hildesheim.de>
• Daniel R. Risacher <risacher@worldnet.att.net>
• Max Vozeler <max@hinterhof.net>

---

and that's the whole page bestie!! every option, every file, every env var, untouched and accounted for 💖 slay safe out there.

CDTOOL · 29-July-2004 · CDTOOL(1) — that's the source/version and date, mwah, sign-off complete 🎀✨💜