granted to the user.
[/introduction]
+[subcommand add]
+ purpose = add or update audio files
+ non-opts-name = path...
+ aux_info = AFS_READ | AFS_WRITE
+ [description]
+ Each path must be absolute and refer to either an audio file or a
+ directory. In case of a directory, all audio files in that directory
+ are added recursively. Note that the given paths refer to files or
+ directories on the host on which para_server is running.
+ [/description]
+ [option all]
+ short_opt = a
+ summary = add all files
+ [help]
+ The default is to add only files ending in a known suffix for a
+ supported audio format.
+ [/help]
+ [option lazy]
+ short_opt = l
+ summary = add files lazily
+ [help]
+ If the path already exists in the database, skip this file. This
+ operation is really cheap. Useful to update large directories after
+ some files have been added.
+ [/help]
+ [option force]
+ short_opt = f
+ summary = force adding/updating
+ [help]
+ Recompute the audio format handler data even if a file with the same
+ path and the same hash value exists.
+ [/help]
+ [option verbose]
+ short_opt = v
+ summary = enable verbose mode
+ [help]
+ Print what is being done.
+ [/help]
+
[subcommand ff]
purpose = jump N seconds forward or backward
synopsis = n[-]
to the server process has the same effect as running this command.
[/description]
+[subcommand init]
+ purpose = initialize the database tables for the audio file selector
+ synopsis = [table_name...]
+ aux_info = AFS_READ | AFS_WRITE
+ [description]
+ When invoked without arguments, this command creates all
+ tables: audio_files, attributes, scores, moods, lyrics, images,
+ playlists. Otherwise only the given tables are created.
+ [/description]
+
[subcommand jmp]
purpose = reposition the current stream
non-opts-name = n
n <= 100.
[/description]
+[subcommand lsatt]
+ purpose = list attributes
+ aux_info = AFS_READ
+ [description]
+ Print the list of all defined attributes which match the given
+ pattern. If no pattern is given, the full list is printed.
+ [/description]
+
+ [option id-sort]
+ short_opt = i
+ summary = sort attributes by id
+ [help]
+ The default is to sort alphabetically by name.
+
+ Attributes are internally represented as an 64 bit array. The attribute
+ id is the bit number in this array.
+ [/help]
+ [option long]
+ short_opt = l
+ summary = print long listing
+ [help]
+ The long listing prints the attribute id in addition to the name of
+ the attribute. The id is printed as a decimal number and is separated
+ from the name by a tab character.
+ [/help]
+ [option reverse]
+ short_opt = r
+ summary = reverse sort order
+
[subcommand next]
purpose = close the stream and start to stream the next audio file
aux_info = VSS_READ | VSS_WRITE
[/description]
+[subcommand setatt]
+ purpose = set or unset attributes
+ synopsis = attribute{+|-}... pattern...
+ aux_info = AFS_READ | AFS_WRITE
+ [description]
+ Set ('+') or unset ('-') the given attributes for all audio files
+ matching the given pattern. Example:
+
+ setatt rock+ punk+ pop- '*foo.mp3'
+
+ sets the 'rock' and the 'punk' attribute and unsets the 'pop' attribute
+ of all files ending with 'foo.mp3'.
+ [/description]
+
[subcommand si]
purpose = print server info
aux_info = NO_PERMISSION_REQUIRED