vagalume-wiki

Gstreamer:

Before we start: PLEASE READ THIS . It's an excellent Summary that shows you how gstreamer works, what a gst-pipeline is and how to use them.

If you want to test your gst-install , you will need some extra gstreamer tools from the Repositories:

sudo apt-get install gstreamer-tools

For Vagalume you must install these needed gstreamer plugins (& external encoders) :

sudo apt-get install librsvg2-common libglib2.0-0 lame faac flac vorbis-tools vorbisgain mp3gain gstreamer0.10-plugins-base gstreamer0.10-plugins-base-apps gstreamer0.10-plugins-good gstreamer0.10-plugins-bad gstreamer0.10-plugins-bad-multiverse gstreamer0.10-plugins-ugly gstreamer0.10-plugins-ugly-multiverse gstreamer0.10-alsa gstreamer0.10-esd gstreamer0.10-ffmpeg gstreamer0.10-gnomevfs

One way to check if you have the correct plugin installed is to open a terminal window and enter

gst-inspect | grep mp3

ffmpeg: ffdemux_mp3: FFMPEG MPEG audio demuxer

ffmpeg: ffdec_mp3on4: FFMPEG MP3ON4 decoder

ffmpeg: ffdec_mp3adu: FFMPEG ADU-formatted MPEG-1 layer 3 audio decoder

ffmpeg: ffdec_mp3: FFMPEG MPEG-1 layer 3 audio decoder

ffmpeg: ffenc_libmp3lame: FFMPEG MPEG-1 layer 3 audio encoder

typefindfunctions: audio/mpeg: mpga, mp1, mp2, mp3

typefindfunctions: application/x-id3v1: tta, flac, ogg, mpga, mp1, mp2, mp3

typefindfunctions: application/x-id3v2: tta, flac, ogg, mpga, mp1, mp2, mp3

mad: mad: mad mp3 decoder

lame: lame: L.A.M.E. mp3 encoder

mpegaudioparse: mp3parse: MPEG1 Audio Parser

Your output should be similar. if not, you are missing some plugins. Go and install them.

Now you can directly pipe a file through gstreamer (without the need of a gui) with your desired gst-pipeline. Test it for mp3. As you could have imagined mp3 support is crucial for vagalume

gst-launch-0.10 playbin uri=file:///path/to/test.mp3

Setting pipeline to PAUSED ...

Pipeline is PREROLLING ...

Pipeline is PREROLLED ...

Setting pipeline to PLAYING ...

New clock: GstAudioSinkClock

And the file should start playing. If it does, Go to PulseAudio

If the mp3 file above does not play, we must dig in deeper in the gstreamer config.

Did you install the necessary gst-plugins and did you run apt-get install -f if you ran vagalume install with dpkg from a console? If you did both, we will use gst-inspect to find out which plugins are installed:

You will need: (output is cut to the relevant gst-plugins):

gst-inspect-0.10

typefindfunctions: audio/x-wav: wav

typefindfunctions: audio/x-m4a: m4a

typefindfunctions: audio/mpeg: mpga, mp1, mp2, mp3

typefindfunctions: application/x-id3v1: tta, flac, ogg, mpga, mp1, mp2, mp3

typefindfunctions: application/x-id3v2: tta, flac, ogg, mpga, mp1, mp2, mp3

ogg: oggaviparse: Ogg AVI parser

ogg: oggparse: Ogg parser

ogg: ogmtextparse: OGM text stream parser

ogg: ogmvideoparse: OGM video stream parser

ogg: ogmaudioparse: OGM audio stream parser

ogg: oggmux: Ogg muxer

ogg: oggdemux: Ogg demuxer

audioresample: audioresample: Audio scaler

gnomevfs: gnomevfssink: GnomeVFS Sink

gnomevfs: gnomevfssrc: GnomeVFS Source

audioconvert: audioconvert: Audio converter

vorbis: vorbistag: VorbisTag

vorbis: vorbisparse: VorbisParse

vorbis: vorbisdec: Vorbis audio decoder

vorbis: vorbisenc: Vorbis audio encoder

gio: giostreamsrc: GIO stream source

gio: giostreamsink: GIO stream sink

gio: giosrc: GIO source

gio: giosink: GIO sink

alsa: alsasink: Audio sink (ALSA)

alsa: alsasrc: Audio source (ALSA)

alsa: alsamixer: Alsa mixer

mad: id3mux: id3 tag muxer

mad: mad: mad mp3 decoder

alsaspdif: alsaspdifsink: S/PDIF ALSA audiosink

lame: lame: L.A.M.E. mp3 encoder

mpegaudioparse: mp3parse: MPEG1 Audio Parser

faad: faad: AAC audio decoder

...

If you are missing some of those, re-install all the gst-plugins* packages you can find via synaptic.

To go a bit deeper into a plugins config (e.g. lame mp3) run:

gst-inspect-0.10 lame

Factory Details:

Long name: L.A.M.E. mp3 encoder

Class: Codec/Encoder/Audio

Description: High-quality free MP3 encoder

Author(s): Erik Walthinsen <omega@cse.ogi.edu>, Wim Taymans <wim@fluendo.com>

Rank: none (0)

Plugin Details:

Name: lame

Description: Encode MP3s with LAME

Filename: /usr/lib/gstreamer-0.10/libgstlame.so

Version: 0.10.7

License: LGPL

Source module: gst-plugins-ugly

Binary package: GStreamer Ugly Multiverse Plugins (Ubuntu)

Origin URL: https://launchpad.net/distros/ubuntu/+source/gst-plugins-ugly-multiverse0.10

Still not enough?

If you are sure that you have all plugins installed but still can't play a file, set a higher gstreamer debug level:

GST_DEBUG=3 gst-launch-0.10 playbin uri=file:///path/to/test.mp3

this will output massive amounts of gstreamer info messages to the terminal, which should help you to identify the error.

You can also start Vagalume with extended gstreamer logging by:

GST_DEBUG=3 vagalume

PulseAudio

Install the PulseAudio control tools:

sudo apt-get install libasound2-plugins "pulseaudio-*" paman padevchooser paprefs pavucontrol pavumeter

I did not need to change any alsa configuration file on ubuntu intrepid (as described in the ubuntu PulseAudio wiki page. You might need to do this for older ubuntu versions).

Set the default gstreamer sink to use the PulseAudio Sound Server:

gstreamer-properties

Default Output should be PulseAudio Sound Server.

see http://www.pulseaudio.org/wiki/PerfectSetup if you have problems with other (older) applications that do not support pulseaudio.

Configure Vagalume via the Download Tab in the "Last.FM - Settings" menu item. Click on the Help button to open the current tab's help page.

Download directory: Base Directory to download audio files.can be extended by a custom Save Pattern

Save Pattern: set dynamic Filename save pattern like {artist}-{album}-{title} or {artist}/{album}/{artist}-{title}

Output Format: choose the used encoding gst-pipline

=>Editor Button: Open Gnome Media Profiles Editor

Create Duplicates: creates a copy if current file already exists

=>Keep Copies: Max. Number of copies to keep from a file

Automatic download: Dump all tracks.

Please Note that the ogg save-option is still buggy. Change the Output Format to mp3 if Vagalume hangs at track changes..

Gnome-Media Profiles

To set your output format choose one of the pre-installed gstreamer pipes.

See Chapter 03 for a brief introduction into gstreamer & pipelines.

You can edit the gst-pipleine from inside Vagalume with a click on the

"Editor" button (in the User Settings - Download Tab)

Note that a new / edited pipline will be used when the next track has

started.

Ubuntu Intrepid ships with a ogg pipeline, which is used as the default in Vagalume.

Please Note that the ogg save-option is still buggy. Change the Output Format to mp3 if Vagalume hangs at track changes..

The default mp3 encoding pipleine in ubuntu intrepid is set to

audio/x-raw-int,rate=44100,channels=2 ! lame name=enc mode=0 vbr-quality=6 ! id3v2mux

You might want to create a new mp3 pipeline for Vagalume because the quality Last.FM streams in is not that high (A CBR 128 Kbit encoding), and it makes no sense to encode it in a higher quality than the original file.

A Vagalume mp3 gst-pipeline could look like:

audio/x-raw-int,rate=44100,channels=2 ! lame name=enc vbr=0 bitrate=128 ! id3v2mux