CDCTRL(1)

💿 CDCTRL(1) — bestie's guide to command line CDROM control ✨

okay so. <rainbow>cdctrl</rainbow> is a User Commands girlie (that's the section, iykyk) and she's here to run your CD-ROM drive from the terminal. no GUI, no fuss, just vibes and spinning plastic. 🎀

✨ NAME ✨

cdctrl — command line CDROM control 💅

🌸 SYNOPSIS 🌸

cdctrl  [device]
cdctrl  -c [device]
cdctrl  -c
cdctrl  [-V|-?|-h]

🦋 DESCRIPTION 🦋

so like. the cdctrl command is a program that opens a CDROM device and can be used for interactive control of the CDROM. we're talking: starting play at a track, next track, previous track, stop, pause, display info, display CDROM status, and display CDROM directory. the whole lil menu of main character moves. 💖

and lowkey the best part? this program may be used as a daemon to control an audio CDROM device. she can just vibe in the background and run the show. periodt.

🎀 the commands to the cdctrl command are:

• device — open CDROM device.
• -V — print out version and build information.
• -h — display help.
• -v — display help.
• -D — enable runtime debugging.
• -c — output CR-LF at end of each line, not LF.

by default, cdctrl opens /dev/cdrom, but does not start playing. (she's respectful like that. no autoplay jumpscares here 🙈) output goes to standard output, with each line terminated by a linefeed (LF).

💿 commands to cdctrl are:

• 1 — play first track, start playing.
• s — stop playing.
• p — pause playing.
• r — resume playing.
• e — eject CDROM.
• c — close CDROM tray.
• i — display info string.
• d — display directory.
• - — play previous track.
• + — play next track. when on last track, play first track.
• [1..99] — play track 1..99.
• ? — display help screen.
• q — quit.

each command results in one or multiple lines of output to stdout, followed by an info string, followed by END. like a little goodbye kiss on every response. 😭

the format of the info string is:

CMD cmd-name cd-status track abs-time rel-time

  cmd-name  := {play, stop, ... quit} from above list
  cd-status := {invalid, play, paused}
  cd-status += {completed, error, no_status}
  track     := {1..99} CD track
  abs-time  := HH:MM:SS elapsed since CD start
  rel-time  := HH:MM:SS elapsed since track start

🍓 FILES 🍓

• /dev/cdrom — default cdrom device

🌈 ENVIRONMENT 🌈

• CDTOOLDEV — cdrom device, overrides compile time defaults

ngl, this one is the override queen. compile-time defaults said what they said, but CDTOOLDEV gets the final word. 👑

🧚 SEE ALSO 🧚

• cdplay(1)

👑 AUTHORS 👑

• Main code: Thomas Insel <tinsel@tinsel.org>
• Enhancements: Sven Oliver Moll <smol0075@rz.uni-hildesheim.de>
• cdctrl extensions: Wade Hampton <whampton@staffnet.com>

and that's the whole page bestie!! 💜 this was CDTOOL version, dated 29-July-2004 — yes she's an elder icon and she still ate. slay, stay spinny, and remember: q to quit, always. 🫶🔥