AUDIOPREVIEW man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

AUDIOPREVIEW(1)			 AudioPreview		       AUDIOPREVIEW(1)

NAME
       audiopreview  -	play  previews of your audio and video files, and also
       internet media streams.

SYNOPSIS
       audiopreview [OPTIONS] FILES/URIS...

DESCRIPTION
       AudioPreview is a command-line tool that	 can  play  previews  of  your
       audio files as well as video files, and even internet media streams. It
       will play your whole media library without any problem and can also  be
       used as a regular media player.

       AudioPreview is developped in C and needs Glib and Gstreamer libraries.

       Note  about  notation: To be generic, each file or URI will be called a
       "stream".

FILE TYPES
       Note that you may need different plugins to read	 specific  files.  For
       example,	 to  play  mp3	files, you need to install gstreamer0.10-plug‐
       ins-ugly.

	 We *suggest* you to install these plugins:
	     gstreamer0.10-plugins-base
	     gstreamer0.10-plugins-good
	     gstreamer0.10-plugins-bad
	     gstreamer0.10-plugins-ugly

OPTIONS
       --colors=TYPE
	      Set when to show colors, TYPE can be 'no' for no	color,	'auto'
	      for  colors  only when there is a non-dumb TTY attached to Stan‐
	      dard Output, 'yes' for colors all the time even if the  Standard
	      Output is not attached to a TTY. Default: auto.

       --debug | -D
	      Show  debug  information	in output (should ONLY be used for bug
	      reporting, for developers or for testing purposes).

       --duration=SECONDS | -d SECONDS
	      Change the preview duration for every stream to SECONDS seconds.
	      If DURATION is negative ( < 0 ) it will play each stream till it
	      reaches the END OF FILE  (Infinite  streams  will	 play  indefi‐
	      nitely!  ex:  live  streams or internet radio station, ...). The
	      default is 10.

       --entirely | -e
	      Play each given stream entirely  starting	 from  the  beginning.
	      *Infinite	 streams will play indefinitely!*  This option totally
	      overrides any given -p or -d options.

       --fast-seek
	      Change seeking mode to be faster (but less accurate). This  will
	      seek  to	the  nearest  keyframe instead of the exact time (This
	      might pose problems if --position is 2).

       --file=FILE | -f FILE
	      Add every line of FILE to the playlist. FILE should contain new-
	      line-separated  URIs  or	paths. This is done after command-line
	      arguments (if any) are parsed and added to the playlist.

       --help | -?
	      Print the usage help.

       --loop | -l
	      Activate Loop mode so that when the last stream has been played,
	      we start playing again from the first stream of the list.

       --max-duration=SECONDS | -m SECONDS
	      Sets the maximum preview duration to SECONDS (integer). This can
	      be used with the --entirely option and you have streams that can
	      be infinite (like radio stations).  (To use with --entirely)

       --no-audio
	      Deactivate/disable the audio output.

       --no-video
	      Deactivate/disable  the video output. You should use this option
	      if you don't have any  DISPLAY  running  otherwise  audiopreview
	      might raise an error if you try to preview video streams.

       --position=POSITION | -p POSITION
	      Define  the starting position from where to start previewing the
	      stream. POSITION can have these values: 0 (Start), 1 (Middle), 2
	      (End),  3	 (Anywhere).   Note that this option is ignored if the
	      stream is	 not  seekable	(e.g.  internet	 radio	streams,  live
	      streams, ...).  Default is 3 (Anywhere).

       --quiet | -q
	      Quiet or silent output (almost no output execept error and warn‐
	      ing messages).

       --shuffle | -S
	      Shuffle the playlist before playing the first stream.

       --verbose | -v
	      Verbose output.

       --version
	      Display the version number.

       --volume=PERCENTAGE | -V PERCENTAGE
	      Change the output volume. PERCENTAGE is an  integer  from	 0  to
	      200. Default is 100 (e.g. audiopreview --volume=100).

SHORTCUT KEYS
       When  audiopreview  is  running	you can do some specific actions using
       keyboard keys:

       SPACEBAR
	      Pause (or resume) playing.

       N      Play next stream.

       P      Play previous stream.

       Q      Stop playing and exit.

       R      Restart current stream (it respects the --position argument, for
	      example:	if  --position	is random, which is the default value,
	      then a new random position will be  calculated  and  the	stream
	      will  be	played	from this new position).  Ignored if stream is
	      continuous (like radio stations).

EXAMPLES
       Here are a few examples of common usage:

       - Preview 5 seconds of every Ogg file (shuffled) in the current	direc‐
       tory:

       audiopreview -S -d 5 *.ogg

       - Preview 1 minute of a few internet streams:

       audiopreview   -d  60  http://radio1:port/  http://streamZ/playlist.asp
       http://streaming:port/

       - Play continuously and quietly (volume: 40%) an	 internet  radio  sta‐
       tion:

       audiopreview -V 40 -e http://coolradio:9999/

       - Preview 20 seconds in the middle of each mp3 file of a directory:

       audiopreview -d 20 -p 1 /dir/to/my/music/*.mp3

       -  Preview  5 seconds from the start of each AVI video file in a direc‐
       tory, with audio output disabled:

       audiopreview --no-audio -d 5 -p 0 /dir/to/my/videos/*.avi

       - Play entirely each mp3 file found in  ~/Music/	 (and  in  subdirecto‐
       ries):

       audiopreview -e -f <(find ~/Music/ -name '*.mp3')

       -  Play (entirely) and loop through all of the ogg files in the current
       directory:

       audiopreview -e -l *.ogg

BUGS
       If you find any bug using AudioPreview, please report it to:

       https://bugs.launchpad.net/audiopreview

       or send an email with detailed description to:

       bugs@audiopreview.codealpha.net

AUTHOR
       Arnaud Soyez (Weboide) <weboide@codealpha.net>

			       February 13, 2009	       AUDIOPREVIEW(1)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net