This is the older software
These instructions are for Pi3D PictureFrame, which is still the right choice on a Raspberry Pi 2, 3 or Zero 2 W. On a Pi 4 or 5, start with the 2026 guide instead.
Tested with
Pi3D 2.43 and PictureFrame 2021.03.10 on the Raspberry Pi OS March 2021 version, Raspberry Pi 2, 3 and 4, 1080p and 4K displays. That is the pi3d route, and it has not been re-tested on a newer OS since.
The Ken Burns effect is a type of panning and zooming effect which makes still imagery come to life.
In this short article, I will show you, how you can get this effect for your digital picture frame.
As always, I will be using the image viewer Pi3D.
What is the Ken Burns effect?
The name derives from American documentarian Ken Burns who was known to use this technique extensively.
Legend has it, that Steve Jobs approached Burns to let him use this effect on Apple computers and since then the effect effect is ubiquitous screensavers and slideshows.
Burns embedded still photos in motion pictures, shown with slow zooming and panning effects, and fading transitions between frames. The technique is mainly used when no moving images are available like with e.g. historical photographies predating the age of the film.
As you can’t really explain the effect with a photo, here is a video:
It looks very smooth and combined with the deep voice of the narrator pulls you into the photo, sometimes with surprises when you start from just one small area of the image and only gradually reveal the full story by zooming out or moving to another area on the photo.
So why not use it on a digital picture frame?
Configuring PictureFrame to use the Ken Burns effect
As luck would have it, Paddy has included the Ken Burns effect in to the Pi3D PictureFrame image viewer.
If this is the first time that you hear of Pi3D, have a look at this article first.
This article is about Pi3D PictureFrame, and it assumes you have it installed. If you are running picframe3 on a Pi 4 or 5, skip to the picframe3 version further down — there is no configuration file to edit there.
Open “configuration.yaml” in the “picframe_data/config” folder and find this line in the “viewer” section:
kenburns: True # default=False, will set fit->False and blur_edges->False
The part after the # is only a comment telling you what the default is. What you change is the value in front of it: make it read kenburns: True.
Also, make sure that you have matting turned off:
mat_images: False # default=0.01, True, automatically mat all images. False, don't automatically mat any images. Real value, auto-mat all images with aspect ratio difference > than value
Save the config file and close it. You’re done.
Start PictureFrame.
The movement of the photos is very smooth. The speed depends on a few factors, most notably the aspect ratio of the image. The more the images correspond to the dimensions of the screen, the smoother the effect will be.
The same thing on picframe3
picframe3, the software I now use on a Raspberry Pi 4 or 5, has Ken Burns too, but there is no configuration.yaml to open. It is a switch on the settings page of the frame's own web interface, under how the frame should look, and it is one of the questions the installer asks you.
The two settings behind that switch are slideshow.kenburns (on or off) and slideshow.kenburns_zoom, which says how far in the pan starts — 1.12 means the picture begins 12% larger than the screen. If you prefer the command line, picframe3 config --set slideshow.kenburns=true does the same thing.
Unlike pi3d, picframe3 does not force matting off when Ken Burns is on; the two are separate settings.
Conclusion
Ken Burns is a very nice feature of Pi3D that can bring some life to your images. Given the very smooth and gradual movement of the image, it doesn’t create a disturbance but blends in nicely.
Are you using the Ken Burns effect? Let me know!
Was this article helpful?
Thank you for your support and motivation.