Download Raspberry Slideshow // how to use

About | Download and use | Faq | Changelog | References

rs-11.0-release.zip md5: 9241a0675dac1b201be799c35a1002ff2ca54eff

Detailed write instructions are available here. 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. Detailed how-to later in this page.

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




Donation

If you like this project please donate.
As a donor, you will have full access to the unrestricted versions of: Raspberry Digital Signage (web-based digital signaging), Raspberry Slideshow (image/video slideshow-based digital signaging) and Raspberry WebKiosk (cheap web kiosking), which can be deployed on how many devices you wish!

Full Raspberry Slideshow features:

  • Wi-Fi enabled for all Raspbian-supported Wi-Fi adapters and the built-in Raspberry 3/Zero W device (see FAQ page for more how-to information);
  • SSH remote management enabled;
  • unlimited media slideshow (limited to three for the SourceForge build);
  • alphanumeric-ordered 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.

Donation page:

Once donation is done, I’ll e-mail you the full software downloading URL address within 12 hours.




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 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)

Raspberry Slideshow 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’s 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 come 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. In this example, three images (not four) will be played, because two are identical.

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

a) Save the URL of the remote list into a text file named serverlist.txt then save this file into the USB key (in the following image, the file is named images.txt). Use one single line without carriage return.

rpfs-remotelist

b) Make your LAN or Internet server hosts the file images.txt (here a LAN web server is used). 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.