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 :
<code>include /etc/ld.so.conf.d/*.conf
/usr/lib/iceweasel</code>

Running ldconfig produces an error on my installation :
<code>debian:/home/bbrice# ldconfig 
ldconfig: Erreur de la procédure mmap du fichier /usr/lib/iceweasel/libsoftokn3.so</code>

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|Important instructions above]].

===== Ubuntu / Debian =====
There is now a libgtk2-mozembed-perl package for [[http://packages.debian.org/sid/libgtk2-mozembed-perl|debian]] and for [[http://packages.ubuntu.com/karmic/libgtk2-mozembed-perl|ubuntu]]

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

On a ubuntu **hardy**, you will need to install these packages :
  * libextutils-pkgconfig-perl
  * libextutils-depends-perl
  * libgtk2.0-dev
  * libxul-dev

And compile the version Gtk2-MozEmbed-0.06, not the later versions, as they require more recent Glib/Gtk2 bindings.

On **intredpid ibis**, you have to install xulrunner-1.9-dev instead of libxul-dev, and compile Gtk2-MozEmbed-0.08.
++++
===== Fedora =====
Remi made a package on [[http://blog.famillecollet.com/post/2009/02/15/perl-Gtk2-MozEmbed-0.08-1|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.
  - mkdir ~/sandbox
  - Download and untar Gtk2-MozEmbed-0.06.tar.gz from [[http://sourceforge.net/project/showfiles.php?group_id=64773&package_id=127248|sourceforge]]
  - cd Gtk2-MozEmbed-0.06
  - 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 :
> <code>
  #!/bin/sh
  export PERL5LIB=~/sandbox/lib/perl/:$PERL5LIB
  exec gmusicbrowser
</code>
> save this script, for example in ~/gmusicbrowser.sh, make it executable : <code>chmod +x gmusicbrowser.sh</code>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 <code>export PERL5LIB=~/sandbox/lib/perl/5.8.8/:$PERL5LIB</code> instead of <code>export PERL5LIB=~/sandbox/lib/perl/:$PERL5LIB</code>

** Then follow the [[#important|Important instructions above]] **

You can test everything works by running "perl examples/pumpzilla"