Provided by: alsaplayer-common_0.99.80-5.1ubuntu1_amd64 
NAME
alsaplayer - plays various sound files
SYNOPSIS
alsaplayer [options] [ filename ...]
DESCRIPTION
This manual page documents briefly the alsaplayer command. This manual page was written
for the Debian GNU/Linux distribution because the original program does not have a manual
page.
alsaplayer is a generic music player that can play back a large amount of file formats.
If files are specified on the command line, these files are played. Otherwise alsaplayer
plays its playlist from its last run, if any.
FILENAME
Play the specified file(s). Can be a file or an URL.
CD.cdda
Special filename. Play a CD. /dev/cdrom will be used by default. Otherwise,
AlsaPlayer will use the device specified in your config file (usually
~/.alsaplayer/config).
OPTIONS
These programs follow the usual GNU command line syntax, with long options starting with
two dashes (`-'). A summary of options is included below.
-c, --config <file>
Use the given config file for this session.
-h, --help
Print this help message.
-i, --interface <interface>
Use the specified interface instead of the default one.
-I, --script <file>
Specify the script to pass to the interface plugin.
-l, --startvolume <vol>
Start with this volume [default=1.0].
-p, --path <path>
Set the path alsaplayer looks for add-ons.
-q, --quiet
Quiet operation, no output.
-s, --session-name name
Name this session "name"
-v, --version
Print version of this program.
--verbose
Be verbose about the output.
--nosave
Do not save playlist content at exit.
Player control:
-n, --session #
Select session # [default=0]
-e, --enqueue file(s)
Enqueue file(s) in a running alsaplayer.
-E, --replace file(s)
Clears and queues file(s) in a running alsaplayer.
--status
Get some information about the session.
--volume #
Set software volume [0.0-1.0].
--start
Start playing.
--stop Stop playing.
--pause
Pause/unpause playing.
--prev Jump to the previous track.
--next Jump to the next track.
--seek <second>
Jump to the specified second in the current track.
--relative <second>
Jump <second> seconds from current position.
--speed #
Set the playback speed. 1.0 = normal speed, -1.0 = normal speed backwards
--jump #
Jump to the specified playlist track.
--clear
Clear the whole playlist
--quit Quit the session.
Sound driver options:
-d, --device string
Select the specific device for the output plugin. For the ALSA plugin, the default
is "default". For the JACK plugin, the default is
"alsa_pcm:playback_1,alsa_pcm:playback_2".
-f, --fragsize #
Set fragment size in bytes [default=4096].
-F, --frequency #
Set the output frequency [default=44100].
-g, --fragcount #
Fragment count [default=8].
-r, --realtime
Enable realtime scheduling. To use this as a normal user, alsaplayer must be SUID
root.
-o, --output [alsa|esound|jack|nas|null|oss|sgi|sparc]
Use the specified output driver.
Experimental options:
-S,--loopsong
Loop the file.
-P,--looplist
Loop the playlist.
-x,--crossfade
Crossfade playlist entries.
JACK OUTPUT PLUGIN
For use with JACK, -F <sample_rate> is mandatory for best results. The value of sample
rate must be the same as the one used by jackd.
If you forget the -F parameter, the sound can be very bad. The only remedy at that time is
to restart both jackd and AlsaPlayer.
DAEMON INTERFACE
With the daemon interface, it is mandatory to add the -s option. You must process in two
steps to get sound with it. First launch the daemon:
alsaplayer -i daemon -s <name>
and then add some song:
alsaplayer -e <some.song>
GTK INTERFACE
The gtk interface provide some basic keyboard controls:
v Stop
x Play
c Pause
b Next Song
z Previous Song
g Seek Forward
a Seek Backward
f Forward Play
s Reverse Play
t Speed Up one musical semitone. (handy for changing the key the song is played back
in)
q Speed Down one musical semitone.
h Speed Up one comma. (handy to tune the song instead of the guitar when playing at
the same time as listening)
i Speed Down one comma.
r Volume Up
w Volume Down
l Loop
PREFERENCES
AlsaPlayer have a preferences file located in ~/.alsaplayer/config. To modify the
preferences setting by hand, you must exit from the running program and edit this file.
The default value is put in the description below when appropriate:
General settings
main.default_interface=gtk2
Specify the default interface.
main.default_output=alsa
Specify the default sound server.
main.multiopen=true
Specify if it is possible to run multiple AlsaPlayer instances.
main.period_count=8
Number of periods in the sound buffer
main.period_size=4096
Frames per period in the sound buffer
Output settings
jack.output1=alsa_pcm:playback_1
Output device 1 when using JACK sound server
jack.output2=alsa_pcm:playback_2
Output device 2 when using JACK sound server
Input settings
cdda.cddb_servername=freedb.freedb.org
Server used by the cdda input module to retrieve the cddb information.
cdda.cddb_serverport=80
Port used by the cdda input module to retrieve the cddb information.
cdda.device=/dev/cdrom
Device used by the cdda input module to retrieve the CD.
cdda.do_cddb_lookup=true
Must AlsaPlayer retrieve or not the cddb information.
http.buffer_size=1048576
Size of the input buffer when <filename> is an URL.
mad.parse_id3=true
Parse or not the Id3 tags.
GTK interface settings
gtk_interface.default_play_path=~/
Default path used by the Add file function
gtk_interface.default_playlist_add_path=/
Default path used by the Add file function in the Playlist window
gtk_interface.default_playlist_load_path=/
Default path used by the Load playlist function
gtk_interface.default_playlist_save_path=/
Default path used by the Save playlist function
gtk_interface.playlist_active=false
Launch or not the playlist window at start up.
gtk_interface.sopeswindow_active=false
Launch or not the scopes selector window at start up.
gtk_interface.smooth_transition=false
Will functions such as pause use a smooth speed transition.
GTK2 interface settings
It use the same options as the GTK interface but with "gtk2_" as prefix instead of "gtk_".
XOSD interface settings
xosd_interface.color=#55ff55
Colour used by the XOSD interface.
xosd_interface.font=-adobe-helvetica-medium-r-normal-*-24-*-*-*-*-*-*-*
xosd_interface.h_offset=20
Display horizontal offset from the left of the screen
xosd_interface.timeout=5
Set the display time.
xosd_interface.v_offset=20
Display vertical offset from the top of the screen
Scopes settings
blurscope.active=false
Launch or not the blurscope plugin at start up.
fftscope.active=false
Launch or not the fftscope plugin at start up.
levelmeter.active=false
Launch or not the levelmeter scope plugin at start up.
logbarfft.active=false
Launch or not the logbar scope plugin at start up.
opengl_spectrum.active=false
Launch or not the spectrumgl scope plugin at start up.
opengl_spectrum.height=480
Height of the spectrumgl scope plugin
opengl_spectrum.width=640
Width of the spectrumgl scope plugin
opengl_spectrum.active=false
spacescope.active=false
Launch or not the spacescope plugin at start up.
synaescope.active=false
Launch or not the synaescope plugin at start up.
SEE ALSO
mikmod(1), mpg123(1).
AUTHOR
This manual page was written by Ivo Timmermans <ivo@debian.org>, for the Debian GNU/Linux
system (but may be used by others). FILENAME, GTK, DAEMON INTERFACE and PREFERENCES
sections added by Dominique Michel <dominique_libre@sourceforge.net> from the Alsaplayer
team.
8 September 2007 ALSAPLAYER(1)