Table of Contents

To use the webcontext plugin, you need to install the either the gtkmozembed or the webkit perl bindings.

Important

This shouldn't be necessary, but it is for now on most install, if it is not done gmusicbrowser will crash (segmentation fault) as soon as it tries to display a mozembed widget. Add “/usr/lib/firefox” to the library path, either everytime by doing “export LD_LIBRARY_PATH=/usr/lib/firefox”, or only once by adding the path to /etc/ld.so.conf and running ldconfig (needs root/sudo)

Under Debian, you usually use Iceweasel instead of Firefox ; you have to add /usr/lib/iceweasel in the /etc/ld.so.conf :

include /etc/ld.so.conf.d/*.conf
/usr/lib/iceweasel

Running ldconfig produces an error on my installation :

debian:/home/bbrice# ldconfig 
ldconfig: Erreur de la procédure mmap du fichier /usr/lib/iceweasel/libsoftokn3.so

But it doesn't seem to be important in the use of the MozEmbed plugin.

Pre-packaged

Mandriva 2010

the perl-Gtk2-MozEmbed-0.80.0-3mdv2010.0 package works simply with the Important instructions above.

Ubuntu / Debian

There is now a libgtk2-mozembed-perl package for debian and for ubuntu

Old informations on the packages you need if you want to compile it from source

Fedora

Remi made a package on this page

Install from source

These instructions will install the gtkmozembed perl bindings in a sandbox, that way, you don't need root permissions and can't break your system.

  1. mkdir ~/sandbox
  2. Download and untar Gtk2-MozEmbed-0.06.tar.gz from sourceforge
  3. cd Gtk2-MozEmbed-0.06
  4. perl Makefile.PL PREFIX=~/sandbox && make && make install

And PERL5LIB must be set when gmusicbrowser is launched, so that it can find the installed Gtk2::MozEmbed. It can be done either :

- by adding “export PERL5LIB=~/sandbox/lib/perl/:$PERL5LIB” in your ~/.bashrc
- or by running gmusicbrowser through a small shell script :
  #!/bin/sh
  export PERL5LIB=~/sandbox/lib/perl/:$PERL5LIB
  exec gmusicbrowser


save this script, for example in ~/gmusicbrowser.sh, make it executable :

chmod +x gmusicbrowser.sh

and change the command in the launcher's properties with : ~/gmusicbrowser.sh

On Ubuntu Feisty Fawn, I had to specify more the path for perl libraries, by using

export PERL5LIB=~/sandbox/lib/perl/5.8.8/:$PERL5LIB

instead of

export PERL5LIB=~/sandbox/lib/perl/:$PERL5LIB

Then follow the Important instructions above

You can test everything works by running “perl examples/pumpzilla”