quick links
Enable with MediaRss
Website Examples
PicLens Lite
Additional Features

Full Featured

Enable your site with Media RSS

Media RSS is an open standard for syndicating multimedia content. It extends RSS 2.0 to provide additional information, such as richer thumbnail and image metadata. Media RSS allows Cooliris to understand the location of the media files that are displayed in the wall, as well as which thumbnails link to which high-resolution images. Click here for a complete description of Media RSS.

Create a Media RSS Feed and save it as photos.rss (or any name you want).

You can create a media RSS feed using PicLens Publisher if you have images on your local drive you would like to upload to a website. PicLens Publisher takes a series of images and outputs a photos.rss Media RSS feed in addition to the image thumbnails, enabling Cooliris usage on your website.

In the Media RSS feed, include an <item> tag for each photo/video that you want to appear in your slideshow, with the <media:thumbnail> and <media:content> tags specifying the locations of the thumbnail and full-size image content, respectively. For videos, ensure that the <media:content> tag has type="video/x-flv" (Item B in the code example below).

If you are an advanced user, you can use scripting to dynamically generate Media RSS feeds from a database of images.

Make sure to declare the Media RSS namespace with
<xmlns:media="http://search.yahoo.com/mrss/">.
Click here for a generic example feed.
```
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
    <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" 
        xmlns:atom="http://www.w3.org/2005/Atom">
        <channel>
            <item>
                <title>Picture A</title>
                <media:description> This one's my favorite.</media:description>
                <link>pl_images/A.jpg</link>
                <media:thumbnail url="pl_thumbs/A.jpg"/>
                <media:content url="pl_images/A.jpg"/>
            </item> 
            <item>
                <title>Video B</title>
                <link>pl_images/B.jpg</link>
                <media:thumbnail url="pl_thumbs/B.jpg"/>
                <media:content type="video/x-flv" url="pl_images/B.flv"/>
            </item> 
        </channel>
        </rss>
        
```
Note: The URLS can be relative (i.e. images/photo.jpg) or absolute (i.e. http://anysite/images/photo.jpg). <Title>, <media:description>, and <link> attributes are optional but recommended.
Upload your Media RSS feed to a directory on your web server.
Try the following applications to upload to your webspace (via FTP):
- Filezilla (Mac and PC)
- Fetch (Mac)
Place the code highlighted below in the <head> of the page you'd like to view in Cooliris to enable RSS Autodiscovery. Note that the href should specify the address (relative or absolute) of your RSS feed:
```
  <head>
    <link rel="alternate" href="photos.rss" 
       type="application/rss+xml" title="" id="gallery" />
  </head>
              
```

quick linksWebsite Examples

Click a gallery to view the HTML code or RSS to see the associated Media RSS feed:

quick linksPicLens Lite

PicLens Lite gives users who do not have Cooliris installed a great media browsing experience in a slick, fullscreen slideshow interface. Activation requires two easy steps.

1. Include the highlighted javascript code in the <head> of your HTML document:


  <head>
    <title></title>
    <link rel="alternate" href="photos.rss" type="application/rss+xml"
    title="" id="gallery" />
    <script type="text/javascript" 
    src="http://lite.piclens.com/current/piclens.js"></script>
  </head>

2. Put the following javascript where you want the Cooliris link:


  <a href="javascript:PicLensLite.start();">Start Slideshow 
  <img src="http://lite.piclens.com/images/PicLensButton.png"
  alt="PicLens" width="16" height="12" border="0" align="absmiddle"></a>

Note: If you are using an external Media RSS feed (from a different domain), include a crossdomain.xml specifying your preferences.

You can also play background music. Here is a sample PicLens Lite Gallery - RSS.

First, upload an MP3 file to your webspace. Next, insert an audio tag under the <channel> tag:


  <channel>
    <atom:link rel="enclosure" type="audio/mpeg" length="1337" 
    href="http://mywebsite.com/music/backgroundmusic.mp3" />

quick linksAdditional Features

In order to implement these features, declare your Media RSS namespace as:


                <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss"   xmlns:atom="http://www.w3.org/2005/Atom">

You can do a lot of cool things with Media RSS and Cooliris:

Multipage Galleries - Have all of the linked content on your site appear on one continuous wall.

Instead of having one huge RSS feed of content, you can page it into as many individual feeds as you'd like. It's quite simple to do.

In your Media RSS feed, just link each feed with tags inside the element, e.g.


  <channel>
    <atom:link rel="previous" href="http://mysite.com/feed1.rss" />
    <atom:link rel="next" href="http://mysite.com/feed2.rss" />

You can even link feeds from different domain names, if you'd like:


  <channel>
    <atom:link rel="previous" href="http://mysite.com/photos.rss" />
    <atom:link rel="next" href="http://myothersite.com/photos.rss" />

Custom Icon - Your icon will appear in the upper left of Cooliris!

To add a custom logo to your slideshow, insert the following tag beneath the <channel> tag:


  <channel>
    <atom:icon>http://www.mywebsite.com/images/logo.gif</atom:icon>

You may use any image (PNG, JPG, or GIF). A 26-pixel high logo will fit nicely into the top bar.

Launch Cooliris - Launch Cooliris, (optional) with a specific feed or item.

Cooliris can be launched from an HTML page with the following tag:


    <a href="javascript:PicLensLite.start();">Insert Content Here</a>

To launch to a specific feed:


    <a href="javascript:PicLensLite.start(
    {feedUrl:'http://www.mywebsite.com/feed.rss'});">Insert Content Here</a>

To launch to a specific item (make sure you have GUIDs specified for each item):


    <a href="javascript:PicLensLite.start(
    {guid:'img0.jpg'});">Insert Content Here</a>

Find out more cool stuff exposed in the PicLens Lite API

Dynamic Feeds - Create Media RSS Feeds from any database (requires scripting knowledge).

Cooliris Developers

Full Featured

Enable your site with Media RSS

quick linksWebsite Examples

quick linksPicLens Lite

quick linksAdditional Features

Cooliris for the Desktop

Cooliris for Mobile

Cooliris for Developers

CoolPreviews

Cooliris, Inc.