---
name: "rioutil"
section: "1"
platform: "linux"
package: "rioutil"
version: "1.4.4-3"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/rioutil"
---

# rioutil(1)

Unix Rio Utility

## Name

	rioutil - Unix Rio Utility

## SYNOPSIS

	rioutil \<option\> \[file(s)\]

## DESCRIPTION

rioutil is a program designed to interface with Sonic Blue's Rio 600/800/900/Riot/S-Series and psa\[play.

- **-v**, **--version**

  print version number of rioutil

- **-o**, **--device=int**

  specify the minor number of the rio. (doesnt work right now)

- **-m**, **--memory=int**

  specify which memory device to use. internal = 0 external = 1

- **-l**, **--list**

  list files currently on the rio.

- **-j**, **--playlist** \<name\> \<list of mem\_unit,song\>

  create a playlist with name on an S-Series or newer Rio

- example (create the playlist fubar with song 0 on mem\_unit 0 and song 1 on mem\_unit 1):

  - •

  rioutil -j fubar 0,0 1,0

- **-i**, **--info**

  return info about rio. i.e. name, memory, etc..

- **-n**, **--name=string**

  rename the rio. 15 Chars MAX

- **-?**, **-h**, **--help**

  show simple help screen

## Uploading

- **-a**, **--upload=string**

  upload a new track/file to the rio.

- **-b**, **--bulk**

  upload multiple tracks/files.

- **-p**, **--pipe \<is mp3\> \<filename\> \<bitrate\> \<samplerate\>**

  reads a file from stdin and uploads it to the rio.

- example:

  - •

  cat file.mp3 \| rioutil --artist "Foo" --pipe 1 file.mp3 128 44100

- **-u**, **--update=string**

  special upload function for installing new firmware. argument is a .lok file.

- **-p**, **--screen=string**

  special upload function to change the startup screen (FUTURE feature)

- **-s**, **--artist=string**

  specify the artist of the track to be uplaoded. 63 Chars MAX

- **-t**, **--title=string**

  specify the title of the track to be uploaded. 63 Chars MAX

- **-r**, **--album=string**

  specify the album of the track to be uploaded. 63 Chars MAX

## Downloading

- **-c**, **--download=int**

  download track(s) from the rio.

- syntax:

  - •

  \-c 12		download track 120

- •

  \-c "1-12"		download tracks 1 through 120

- •

  \-c "1 2 3"	download tracks 1, 2 and 30

## Deleting

- **-d**, **--delete=int**

  delete track(s) from the rio.

- syntax:

  - •

  \-d 12		delete track 120

- •

  \-d "1-12"		delete tracks 1 through 120

- •

  \-d "1 2 3"	delete tracks 1, 2 and 30

- **-f**, **--format**

  format memory device.

## fckrio

replaced by rioutil -z works with update and format commands

## AUTHOR

Written by Nathan Hjelm.

## REPORTING BUGS

Report bugs to \<hjelmn@unm.edu\>.

## COPYRIGHT

Copyright© 2003 Nathan Hjelm.\
 This is free software; see the source for copying conditions. There is NO warranty.