RIO(1)

💖 RIO 💖

okay bestie, so this is the manual page for rio — it lives in section 1 of the General Commands Manual, the whole "user commands" shelf, yk? and no cap, this page is kind of a legend because the original program straight-up does not have a manual page of its own. so somebody had to step up. and they did. 🫶

---

✨ NAME ✨

rio — a program to control a Diamond RIO MP3 player 🎵

---

🌈 SYNOPSIS 🌈

rio [options] files ...

---

🦋 DESCRIPTION 🦋

so this manual page documents the rio command briefly. and the way that this page even exists is a whole story: it was written for the Debian GNU/Linux distribution specifically because the original program doesn't ship a manual page at all. iconic of them, honestly. 💅

rio is a CLI controller for a Diamond Rio MP3 file player. like, a command-line controller. for your MP3 player. in a terminal. it's giving retro tech main character energy and we're obsessed.

the default ioport is 0x378. periodt. but if that is not the ioport your printer port is chillin' on, then bestie you are gonna have to use the -p option. no way around it.

---

🎀 INITIALIZATION 🎀

okay this part is important, listen up.

initialization should only be performed on new or corrupt cards. that's the rule. do not be out here initializing a perfectly fine card just for fun, i'm begging. 🙈

you can initialize with bad block checking enabled using -iy — this will test all blocks on the internal or external flash ram (whichever one is selected, so watch your -x vibe check) and note all bad blocks. this process will take some time. like, up to 20 minutes on slow machines. yes, twenty. minutes. go make a snack. 🍓

you can also initialize with bad block checking disabled using -in — which is much quicker, but heads up: all blocks (even bad blocks) will be used. all of them. the bad ones too. it's giving risky.

🚨 and if what you actually want is to delete all files on the device, the -za option should be used instead of the initialization options mentioned above. do not use init as a delete button, bestie. it is not that. 💀

---

💅 OPTIONS 💅

a summary of options are included below. here we go, one by one, no skips:

• -d — Display Directory 👀
• -iy — initialize with check for bad blocks
• -in — initialize without check for bad blocks
• -x — perform operations on external flash ram
• -u — specify file(s) to upload
• -g — specify file to download
• -f — specify text based playlist file which contains files to be upload
• -z — specify file to delete
• -za — delete all files
• -o — specify new playlist order in quotes
• -p — specify parallel port base IO address, default=0x378
• -v — enable verbose mode
• -di — specify initialization delay
• -dt — specify tx delay
• -dr — specify rx delay

---

⭐ EXAMPLES ⭐

these are the moments. the real ones. every single one of these is verbatim, so copy with confidence. 🫶

display directory using parallel port at 0x278

rio -p 0x278 -d

initialize (with bad block check) and upload files

rio -iy -u *.mp3

delete existing files and upload playlist onto external flash ram

rio -za -f playlist.txt -x

initialize, upload files in playlist and then display directory

rio -d -in -f playlist.txt

download file then delete it and finally display directory

rio -d -g mp3Files/song.mp3 -z song.mp3

reverse playlist order and display directory, also change rx iodelay

rio -o "5 4 3 2 1" -d -dr 4

---

👑 SEE ALSO 👑

go read more, bestie, iykyk:

• file:/usr/doc/rio/README.gz
• http://www.world.co.uk.sba/index.htm

---

🌸 AUTHOR 🌸

this manual page was written by Vince Mulhollon <vlm@debian.org>, for the Debian GNU/Linux system (but may be used by others). shoutout Vince, fr fr, absolute legend for writing docs for a program that didn't have any. 🫡

---

and that's the whole page, start to finish!! 💜 the footer down there just says RIO(1), cute little signature, no version, no date, nothing else — just vibes and a section number. slay. 🦋