| Name |
rio-admin
|
| Version |
1.1 |
| Updated |
2003/03/16 22:55:44 |
| RCS |
rio-admin,v 1.1 2003/03/16 22:55:44 forman Exp forman |
| Rating |
|
| Category |
MP3, Rio 500 |
| Description |
rio-admin provides four functions: format, erase, fill, and cycle. By default rio-admin peforms the fill function, which uploads random songs to a Rio 500. It will fill both internal and external memory using as much memory as possible with the given list of songs.
This program requires the Rio500 programs and kernel module which can be found at http://rio500.sourceforge.net/.
|
Download |
rio-admin
|
RIO-ADMIN(1) User Contributed Perl Documentation RIO-ADMIN(1)
NAME
rio-fill - Fills a Rio 500 randomly with music
SYNOPSIS
rio-fill [ -hDtv ] [ --nohistory ] [ -ix [folder] ]
[ -m [max size] ] [ -f [font] ] [ -p [dir ...] ]
[ -d [dir ...] ] [ --format | --erase | --fill | --cycle ]
DESCRIPTION
rio-admin provides four functions: format, erase, fill,
and cycle. By default rio-admin peforms the fill func
tion, which uploads random songs to a Rio 500. It will
fill both internal and external memory using as much mem
ory as possible with the given list of songs.
This program requires the Rio500 programs and kernel mod
ule which can be found at http://rio500.sourceforge.net/.
QUICK START
The most common usage is as follows:
rio-admin --erase Erase all songs in default folders.
rio-admin --fill Fill default folders with songs.
rio-admin --cycle First --fill then --erase.
rio-admin --format Format memory and create folders.
rio-admin --status Print the status of the rio500.
FUNCTIONS
This program requires the existance of two folders,
"Internal" and "External", which are placed in internal
and external memories respectively. Four functions are
provided to operate on these folders.
--format
The format function will format internal and external mem
ory on the Rio500 and create the "Internal" and "External"
folders. This is necessary before the first use of the
program.
--erase
This function will remove mp3 files from the folders
"Internal" and "External" leaving empty folders.
--fill
This is the default function. It will fill the folders
"Internal" and "External" with randomly selected mp3
files.
--cycle
This function executes the "erase" and "fill" functions
sequentially. This function is added as a convenience for
a quick music change.
--status
This function prints the status of the rio player and
lists all songs currently downloaded.
OPTIONS
-d --dir [root [root ...]]
-d --dir [root subdir [subdir ...]]
Specifies the root mp3 directory to search for files. If
unspecified, the default directory, which may be changed
by editing this file, is used.
The list of directories provided to this option can take
two forms. The first form is a list of absolute paths to
be used as root directories for the mp3 file search. The
second form is a list that begins with an absolute root
path followed by a list of subdirectories off that root
path. The difference is that the second form will pre
serve the subdirectories on the CD filesystem.
An example of the first usage is shown below. The program
will use each directory in the list as a root mp3 direc
tory and store the files on the CD relative to those
paths. Thus if there are no subdirectories under the
paths given, no subdirectories will exist on the CD. (The
CD will not contain the subdirectories "80s", "90s", and
"classical".)
-d "/mp3/80s /mp3/90s /mp3/clasical"
The alternate usage consists of an absolute path to a root
mp3 directory followed by several relative paths to subdi
rectories. Everything, which does not begin with a "/",
is treated as a subdirectory off of the root mp3 direc
tory. Note that the root mp3 directory is not searched
for mp3 files, only the subdirectories are. The following
example searches the same file space as the previous exam
ple but includes the subdirectories "80s", "90s", and
"classical" on the CD.
-d "/mp3 80s 90s clasical"
More than one root mp3 directory with subdirectories can
be specified at a time. The example below has two root
mp3 directories. On the CD there will exist two subdirec
tories, "80s" and "90s" with the contents from "/mp3/80s"
and "/mp3/new/80s" merged into the CD's "80s" directory.
The same holds true for the "90s" directory.
-d "/mp3 80s 90s /mp3/new 80s 90s"
-f --font [font]
Use the specified font instead of the default font.
-h --help
Prints this information.
-H --history (--nohistory)
Checking and excluding selected files against a list of
previously recorded mp3 files is enabled by default to
minimize repitition on CDs. To force the program to
ignore previously downloaded songs use the --nohistory
flag.
-i --ifolder [folder number]
Specifies the destination folder of the internal memory
for uploads. If unspecified, the default of "0" is used.
-m --max [max file size]
This sets the largest maximum file size that an mp3 file
can have and still be uploaded. The purpose of this is to
prevent a couple of massive files from taking all the mem
ory. To allow no limit on file size, set to zero.
-p --prune [subdirectory ...]
Remove the list of subdirectories from the search for mp3
files. These subdirectories should exist under the root
mp3 directory given by the $MP3DIR variable or as speci
fied by the -d flag. If they do not, they will be
ignored.
-t --test
List files that will be uploaded without actually upload
ing the data.
-v --version
Print version information.
-x --xfolder [folder number]
Specifies the destination folder of the external memory
for uploads. If unspecified, the default of "0" is used.
EXAMPLE
The example below calls the "format" function to create
the default directories necessary for the "fill" function.
rio-fill --format
The default usage is given below. It will function with
out a hitch provided that the folders "Internal" and
"External" exist on the "Rio500" and the directories given
for the variable "@MP3DIR" are present with mp3 files.
rio-fill
The example below is what I call before I head out for
jogging. It removes the old mp3 files and puts in a new
randomly-selected group.
rio-fill --cycle
The example below will maximally fill the internal and
external memory of the Rio 500 player with files randomly
selected from the /mp3 directory.
rio-fill -d /mp3
The example below will maximally fill the internal and
external memory of the Rio 500 player with files randomly
selected from the /mp3 directory, excluding files con
tained in the subdirectories /mp3/country and /mp3/polka.
rio-fill -p "country polka" -d /mp3
The example below will maximally fill the internal and
external memory from the directories "/mp3/80s",
"/mp3/90s", and "/mp3/classical".
mp3-cdr-fill -v -r -d "/mp3 80s 90s classical"
NOTES
This program was developed using Rio500 programs
v1.07.p01, the Rio500 USB kernel module 26.Feb 2000, and
Linux kernel 2.3.45. It is known to work with 32, 64, and
128 MB external memory cards.
I accept no responsibility for damage to your Rio500
incurred by use of this program. Use this program at your
own risk.
BUGS
Poorly written loops that may or may not exit depending on
the barometric pressure. A sad packing algorithm that has
the potential of stepping through the entire list of songs
in order to to maximally fill the rio. My free-memory or
file-size calculation is off, resulting in the last song
in a random list being rejected due to insufficient mem
ory.
SEE ALSO
find, rio-fill, rio-cycle, rio-format, rio-html,
rio-erase, rio500-linux-driver
AUTHOR AND COPYRIGHT
Michael Forman http://www.Michael-Forman.com
Copyright (C) 2000-2002 Michael Forman. All rights reserved.
This program is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.
Please see the Perl Artistic License.
VERSION
Current Revision: $Revision: 1.1 $
Last Modification: $Date: 2003/03/16 22:55:44 $
perl v5.8.1 2004-03-16 RIO-ADMIN(1)
