Installing

michaelgwood edited this page May 22, 2012 · 28 revisions

Installing

Media explorer master depends on a bunch of very bleeding edge packages, which may not yet be in your distribution of choice. If you can't wait for your distribution to update you can try the following:

Install via packages

Meego >= 1.2

Open up add/remove programs and search for "Media explorer". This will install media explorer v0.1.0.

Fedora > 15

media-explorer is in Fedora 16 https://admin.fedoraproject.org/pkgdb/applications/Media%20Explorer

Debian >= Sid

Not packaged yet

Ubuntu 11.04 and >

No official packages yet

Unofficial packages available from: https://launchpad.net/~guido-iodice/+archive/meego (Note that "The contents of Personal Package Archives (PPAs) are not checked or monitored. You install software from them at your own risk.")

sudo add-apt-repository ppa:guido-iodice/meego
sudo apt-get install media-explorer

Building from source

These are instructions on how to compile version =< 0.1.2

Media explorer dependencies:

Debian => sid

apt-get install gnome-common libglib2-dev gtk-doc-tool libsoup2.4-dev libdbus-glib-1-dev libgudev-1.0-dev libxtst-dev libclutter-1.0-dev

Fedora 15

Build and Install the clutter-gst 1.3.12

wget ftp://ftp.gnome.org/pub/GNOME/sources/clutter-gst/1.3/clutter-gst-1.3.12.tar.bz2
tar -xf clutter-gst-1.3.12.tar.bz2
cd ./clutter-gst-1.3.12
./configure && make
sudo make install

You may also need to build grilo, grilo-plugins and mx

Package hints:

gnome-common libglib2-devel gtk-doc-tool gdk-pixbuf2.0-devel libsoup2.4-devel libdbus-glib-1-devel librest-devel libgudev-1.0-devel libxtst-devel libclutter-gst-devel libmx-devel libgrilo-0.1-devel grilo-0.1-plugins

Ubuntu Natty 11.04:

1) Install: gnome-common libglib2-dev gtk-doc-tool gdk-pixbuf2.0-dev libsoup2.4-dev libdbus-glib-1-dev librest-dev libgudev-1.0-dev libxtst-dev

sudo apt-get install gnome-common libglib2-dev gtk-doc-tool gdk-pixbuf2.0-dev libsoup2.4-dev libdbus-glib-1-dev librest-dev libgudev-1.0-dev libxtst-de

Add an unofficial repository (PPA) which contains additional required dependencies: (Note that "The contents of Personal Package Archives (PPAs) are not checked or monitored. You install software from them at your own risk.")

sudo add-apt-repository ppa:guido-iodice/meego

Install libclutter-gst-dev libmx-dev libgrilo-0.1-dev grilo-0.1-plugins

sudo apt-get install libclutter-gst-dev libmx-dev libgrilo-0.1-dev grilo-0.1-plugins

All

IF You want the Webremote applet you also need to install some additional dependencies Webremote ELSE use --enable-webremote=no as a configure option of media-explorer to skip building it

IF You want to use tracker as the source for files and metadata (recommended) install tracker-miner-fs ELSE use --enable-library as a configure option of media-explorer to build a basic plugin using grilo filesystem

2) Now to build media explorer

Download media explorer

wget https://github.com/media-explorer/media-explorer/tarball/master -O media-explorer.tar.gz
tar -xf ./media-explorer.tar.gz
cd ./media-explorer*

Configure media explorer, Add any configure options from above that you needed.

./configure --prefix=/usr --enable-displayconf=no && make
sudo make install

Done! you should now have "mex" installed.

Installing via jhbuild (distro independent)

jhbuild will compile and install all the dependencies and media explorer into a specified directory, this is a good way to guarantee all the dependencies are met if you are not running a bleeding edge distribution where the packages aren't available.

glib (2.28) pixman (1.18.4) cairo (1.10.0) [tumbler (master)] json-glib (0.12) clutter (1.6) clutter-gst (master) mx (1.2.0) libgdata (0.8.0) grilo (0.1.x) gvfs (1.6.4) vala (0.12.0) sqlite3 (3.7.4) [tracker (0.10), tracker-upnp (master)] grilo-plugins (0.1.x) librest (master) mex (master)

Install jhbuild from your distribution's package manager or get it from git.gnome.org:

git clone git://git.gnome.org/jhbuild
cd jhbuild
./autogen.sh
make
make install

Get the jhbuild-mex module set and config

git clone git://github.com/media-explorer/jhbuild-mex.git
make install

Optionally edit the install and source target paths:

vim ~/.jhbuild-mex

Run jhbuild

jhbuild-mex build

You may come across dependencies that need to be satisfied outside of the jhbuild

package hints:

sudo apt-get install bison flex libdbus-glib-1-dev libgdu-dev libgudev-1.0-dev libicu-dev libsoup-gnome-2.4 libsoup-gnome2.4-dev libsoupcutter-dev libsoupcutter0 libnice-dev gobject-introspection uuid uuid-dev libexif libexif-dev tracker-miner-dev gupnp-vala gmime libgmime-2.6-dev libavahi-glib-dev libunwind-dev libunwind7-dev libgirepository1.0-dev python-gobject-dev python-gst0.10-dev

Run media explorer

jhbuild-mex shell
~/mex/shell/mex

FAQ

  • Q: Why can't jhbuild find the MediaExplorer modules file?
  • A: The default modules file is expected to be at:
~/src/jhbuild-mex/build/mex.modules

If you've installed jhbuild-mex to a different location, edit the jhbuildrc-mex-custom configuration file, uncommenting and editing the moduleset line. Using the absolute path to the mex.modules file should work.

  • Q: Why doesn't the D-Bus service(s) start having installed in an alternative prefix?
  • A: In order to activate a D-Bus service installed within the JHBuild root you have to modify the /etc/dbus-1/session.conf file by adding the following line after <standard_session_servicedirs />:
  <servicedir>@PREFIX@/mex/install/share/dbus-1/services</servicedir>

Where @PREFIX@ is the prefix used (in jhbuild the user's home directory by default).

You will have to restart D-Bus, which usually means logging out or a complete reboot.

  • Q: Fails to build because of a dependency on gnome-desktop-2.0 when I'm using GNOME 3
  • A: Use --enable-displayconf=no for now, or you can change the dependency to gnome-desktop-3.0

If you're using jhbuild you can put:

module_autogenargs['mex'] = '--enable-displayconf=no'

In your ~/.jhbuildrc-mex-custom

  • Q: I get jhbuild buildone: failed to parse .... mex.modules: [Errno 2] No such file or directory: '... mex.modules'
  • A: edit your ~/.jhbuild-mex setting:
moduleset = os.path.expanduser('/your/path/to/jhbuild-mex/build/mex.modules')

Next: Developing on Media explorer