[grilo] Added README contents

[Iago Toral Quiroga <itoral src gnome org>]

commit fccbfc69504a0a33102b3acea28402a5c420b417
Author: Iago Toral Quiroga <itoral igalia com>
Date:   Mon Apr 5 11:46:23 2010 +0200

    Added README contents

 README |  104 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 104 insertions(+), 0 deletions(-)
---
diff --git a/README b/README
index e69de29..2ecce23 100644
--- a/README
+++ b/README
@@ -0,0 +1,104 @@
+Thanks for using Grilo!
+
+=== What is Grilo? ===
+
+Grilo is a framework for browsing and searching media content from various
+sources using a single API.
+
+=== Where can I find more? ===
+
+We have a wiki page at
+http://live.gnome.org/Grilo
+
+You can subscribe to our mailing list:
+http://mail.gnome.org/mailman/listinfo/grilo-list
+
+You can join us on the IRC:
+#grilo on GIMPNet
+
+=== How do I start? ===
+
+If you are using Ubuntu you can install binary packages by configuring
+our PPA, check the wiki page above for details. Otherwise you  have
+to download Grilo's source code from GNOME's repository and build it
+-don't worry, it takes only a few seconds-, see the section below
+if you want to do that.
+
+Once you have Grilo installed, you may want to play around with the
+examples (See section "Examples") or check its documentation 
+and tutorials (See section "Documentation").
+
+=== Building from git ===
+
+$ git clone git://git.gnome.org/grilo
+$ cd grilo
+$ ./autogen.sh
+$ make
+
+=== Examples ===
+
+If you are looking for some example to play with you can try grilo-test-ui,
+a simple GTK+ based test application for testing purposes. You can find it
+under tools/grilo-test-ui. It allows users to:
+
+1) Browse predefined content categories from browseable sources (like
+"Youtube", "Jamendo" or "UPnP").
+2) Search content by text on searchable sources (like "Youtube", "Jamanedo"
+or "Flickr").
+3) Query sources using source-specific syntax (for sources implementing
+this feature).
+4) Organize and define the source's content hierarchy (for sources
+implementing this feature like "bookmarks" or
+"podcasts").
+5) Check available metadata for the media. 
+
+For this application to work you need some Grilo plugins that act as media
+sources, that is, plugins that provide the actual content that you will
+browse and search using the application. You can get a bunch of plugins for
+Grilo from the grilo-plugins package here:
+
+http://git.gnome.org/browse/grilo-plugins
+
+If you don't have any plugins installed in the default directory (for example
+if you downloaded and compiled the plugins but did not install them on
+your system), you will have to set the GRL_PLUGIN_PATH environment variable
+(a colon-separated list of paths where the plugin libraries live). If you
+have downloaded and compiled grilo-plugins, you can set this variable
+automatically just but running the set-plugins-env.sh script that lives in
+the root directory of the grilo-plugins repository.
+
+If you are looking for a step-by-step guide from beginning to end, here it is:
+
+# Building Grilo
+
+$ git clone git://git.gnome.org/grilo
+$ cd grilo
+$ ./autogen.sh
+$ make
+
+# Building Grilo Plugins and setting GRL_PLUGIN_PATH
+
+$ export PKG_CONFIG_PATH=$PWD:PKG_CONFIG_PATH
+$ cd ..
+$ git clone git://git.gnome.org/grilo-plugins
+$ cd grilo-plugins
+$ ./autogen.sh
+$ make
+$ source set-plugins-env.sh
+
+# Running grilo-test-ui
+
+$ cd ../grilo
+$ tools/grilo-test-ui/grilo-test-ui
+
+=== Documentation ===
+
+If you are looking for documentation you should add the --enable-gtk-doc
+option to the autogen.sh execution:
+
+$ ./autogen.sh --enable-gtk-doc
+$ make
+
+Then point your browser to open the file doc/reference/html/index.html
+
+Enjoy!