Slide Shows

Your HalloWing is pre-loaded with a CircuitPython program that uses the Image SlideShow library.

If you need to re-download the files that were pre-loaded on your HalloWing, here's the repo.

Running a slideshow in CircuitPython on the HalloWing is dead easy! Here's the example code which automatically plays through all .bmp images in the /images directory on the board.

import board
from adafruit_slideshow import PlayBackOrder, SlideShow
import pulseio

# Create the slideshow object that plays through once alphabetically.
slideshow = SlideShow(board.DISPLAY, pulseio.PWMOut(board.TFT_BACKLIGHT),
					  folder="/images", loop=True,
					  order=PlayBackOrder.ALPHABETICAL, dwell=2.5)

while slideshow.update():
Your images should be 128x128 pixels, 24 bit color, uncompressed BMP format only

BMPs in Windows

Microsoft Paint works really well!

Make your 128x128 image,

Save as... BMP picture

Save it to the badge filesystem /images folder as 24-bit Bitmap (*.bmp) and make sure the file name ends with .bmp as well

BMPs in Mac, Linux, etc.

There are several online image conversion websites which convert a file from one format to another. We'll show you one below but you can experiment with either other websites or Mac/Linux 3rd party image programs which may output BMP files.

We've used to convert images to BMP format on the web. Take your 128x128 pixel color image file on your computer and drag/choose the file where indicated on the website.


Press the Start Conversion button below the file box.


If you need to tweak the settings, the site allows you options but it's best that you already have a color 128x128 pixel image to convert via the web.

When the conversion is done, a dialog should pop up in the browser to say where would you like to save the file (now converted with a .bmp file name extension).

Now you have a BMP file! To load onto your HalloWing, use your finder or linux file manager. Plug in your HalloWing to your computer via a good data USB cable. The board should show up as a flash drive named CIRCUITPY. Now copy the BMP into the directory on CIRCUITPY named /images. There you go, done!. You can go into the images directory and add / change / delete BMPs as you wish.

This guide was first published on Nov 01, 2018. It was last updated on Nov 01, 2018. This page (Slide Shows) was last updated on Jun 16, 2019.