Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/splitbrain/soupframe

Make a soup.io digital picture frame
https://github.com/splitbrain/soupframe

digital-picture-frame javascript php soup-io

Last synced: about 1 month ago
JSON representation

Make a soup.io digital picture frame

Awesome Lists containing this project

README

        

SoupFrame
=========

This is a quickly hacked together thingy to make a digital picture frame out of a soup.io account's images. Actually
it does two things that are very much generic and would work with all kinds of sources:

1. A downloader script for images referenced as enclosure in a given RSS feed
2. A JavaScript/HTML site that displays these images in random order full screen

## Installation

1. Clone the or download the repository somewhere in your webserver root
2. Install composer ```curl -sS https://getcomposer.org/installer | php```
3. Download the libraries ```php composer.phar update```

### Why PHP?

Because it was the easiest and fastest way for me to hack this together. The downloader would be better fitted for
Python I guess and maybe I'll redo it some time. For now: deal with it!

Also I did not add any cool HTTP client library, so you need to make sure your PHP can access URLs via
file_get_contents.

## Downloading your soup.io

You first want to start with everything you ever had in your soup. You need an Export RSS feed for that:

1. Go to **your** soup at http://.soup.io
2. Open the options
3. Go to the privacy tab
4. Download the Export RSS URL (this takes ages to generate, so maybe do it on command line)
5. Run it through the downloader script ```php download.php .rss```

## Create a cronjob to update

You want to have this update regularly from your "normal" feed. To do so set up a cronjob to run
```php downloader.php http://.soup.io/rss``` as often as needed. The downloader should skip images
it already knows. **Be sure not to pull the export feed everytime!**

## Set up your display

Open the index.html on your device's browser. It should start to cycle through the images. Click the image once
to switch to full screen mode.