About | Download and use | Faq | Changelog

Please download Raspberry Slideshow for all Raspberry Pi models from Sourceforge.

Detailed write instructions are available in the FAQ page. Some default images and videos (taken from the Web and YouTube) are included within the system for a quick functioning example: plug in the Ethernet cable (DHCP) for a full experience.

For web-based signaging, please have a look at Raspberry Digital Signage instead.

Don’t miss Binary Emotions Blog as well, where the most important Raspberry Pi, Arduino and IoT news are collected daily. Also, in order to stay tuned with Raspberry Digital Signage, WebKiosk, Slideshow or ownCloud updates, please subscribe to Binary Emotions Blog RSS feed.




Setup: how to use (functioning modes)

1. Local media

Put image and/or video files into a USB stick with one only partition.
The USB key must be formatted in FAT/vFAT or ext4.
Files must be put in the root folder of the key (not inside directories).
Connect the USB stick to the Raspberry Pi running Raspberry Slideshow and boot. That’s all.

2. Retrieve media from remote URLs: remote-urls.txt

Put a text file named remote-urls.txt into a USB stick.
With this file you will specify LAN or Internet URLs of remote images and/or videos hosted by a Web or FTP server, one per line (please see the examples below).
Connect the USB stick to the Raspberry Pi and boot.

3. Retrieve media from a local Windows (Samba) share: network-share.txt (donors’ build only)

Put a text file named network-share.txt into a USB stick.
With this file you will specify the local network folder share in the form: //192.168.0.100/myShare. All contained media will be automagically copied into the R-Pi internal card and slided.
Share user must be “guest”, with “guest” password (see FAQ if you need to change it).
Connect the USB stick to the Raspberry Pi and boot.

4. Point a remote list of images: serverlist.txt (donors’ build only)

Put a text file named serverlist.txt into a USB stick.
With this file you will specify the URL of a remote server list (a text list of images/videos). This way, media list is managed server-side. See the examples below.
Connect the USB stick to the Raspberry Pi and boot.

The refresh feature (use with 3. and 4.): serverlist-refresh.txt (donors’ build only)

R-Pi can refresh the media list (remote list links or network share content) at given intervals, in order to slide images and videos according to server changements.

You can accomplish this by saving a file named serverlist-refresh.txt (together with serverlist.txt or network-share.txt, of course) into the USB key, in which you’ll specify the refresh time value. System is smart enough to actually re-download all remote media only when it sees changements.

Put value in one single line without carriage return.
Refresh value is in seconds (so, for an hour, just save 3600 in the file).
Please see the examples once again.

Automatic photos rotation (donors’ build only)

An optional photos rotation based on their EXIF informations is available; enable in /etc/rs.conf via SSH as root (refer to the FAQ page). This will increase the boot time.

Rules

  • All USB files (media and text) are copied into the internal Raspberry’s SD-CARD:
          – if the USB key is inserted: at every reboot, SD-CARD files are updated and hence played according to the key content;
          – if the USB key is not inserted: at every reboot, media are played from the internal cache. So, after the first run, you can unplug the USB key.
  • Functioning modes can be combined: you can put files, remote-urls.txt, serverlist.txt and network-share.txt into the USB key.
  • Media will be displayed in a name-based order (donors’ build only), first remote-urls.txt-related content, then serverlist.txt-related media, network-share.txt and then USB contained media, followed by name-based order of remote-urls’/serverlist’s/network-share’s/USB key’s videos. So, images first and then videos. This behaviour is by design and unmodifiable.
  • Accepted image formats are jpeg (.jpeg or .jpg), png, gif.
  • Accepted video formats are the ones played by omxplayer, mostly mp4 files.

 

Examples

All examples below concern images, but they are valid for videos and/or images+videos, too.

How to play two local images plus two remote ones:

a) Copy the image files into the USB key and create a text file named remote-urls.txt in which you will specify the remote image locations (URLs), one per line:

rpfs-usb

b) save remote-urls.txt into the USB key, too.

c) Insert the key into the Raspberry and (re)boot.

How to use serverlist.txt – server content based slideshow:

a) Create a text file named serverlist.txt inside the USB key specifying the URL of the remote list file in one single line without carriage return (in the example it is named images.txt):

rpfs-remotelist

b) Make your LAN or Internet server host the file images.txt (here it is of course a LAN web server). File content is, again, just a simple list of URLs, for example:

rpfs-remotelist-server

c) Insert USB key into the Raspberry Pi and (re)boot.

How to use network-share.txt – network folder content based slideshow:

a) Create a text file named network-share.txt inside the USB key.
Content example: http://192.168.0.100/myOpenShare.
On the server end, myOpenShare user must be “guest” with “guest” password set (see FAQ if you need to change it).

b) Insert USB key into the Raspberry Pi and (re)boot.

 

Donation

If you like this project please donate via one of the following PayPal buttons.

Personal use (no email help):




Personal users will also receive a copy of Raspberry Digital Signage and Raspberry WebKiosk images, donors releases. So, with this donation you will be given a complete digital signage and web-kiosking bundle – without email help.


Professional use (same as Personal use, but with email help, so strongly recommended, but not mandatory, if you intend to use a solution based on this software for your clients):




Professional users will also receive a copy of Raspberry Digital Signage and Raspberry WebKiosk images, professional releases. So, with this donation you will be given a complete digital signage and web-kiosking bundle – with email help.


Donors’ builds’ features:

  • you can deploy RS how many times you need and on how many devices you wish;
  • Wi-Fi enabled for all Raspbian-supported Wi-Fi adapters and the built-in Raspberry 3 device;
  • SSH remote management enabled;
  • unlimited media slideshow (limited to five for the SourceForge build);
  • alphabetic order media playback;
  • automatic photos rotation basing on EXIF informations;
  • server-content based slideshow (serverlist.txt) enabled;
  • media retrieval from network shares (Windows shares/Samba) feature enabled;
  • refresh feature enabled.

Once donation is done I’ll give you the software download URL directly via e-mail within 12 hours. Double check that your PayPal email address is valid.




Support

For bug-related support feel free to drop me an email – please have a look at site FAQ, first.
Professional users only: for help, you can reply directly to the email you will receive after the donation. I am sorry but I cannot offer support to everyone else due to the lack of my time.
For new features development, please contact me in order to ask for a quotation.
See page footer for my email address.