Metadata-Version: 2.4
Name: photoframebuffer
Version: 0.1.2
Summary: Display photos on a Linux framebuffer device
Project-URL: Homepage, https://github.com/dsoprea/photoframebuffer
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: Pillow>=10.0
Requires-Dist: numpy>=1.24

# Overview

This is a Python tool that displays photos directly to a Framebuffer device in
Linux. It can be used to directly drive a photoframe without needing to install
a graphical environment.

This has been used to stably drive a screen from a Raspberry Pi Zero 2 W over a
long period of time (with swap enabled).


# Example Usages

Drive from a folder of images:

```
pfb_slideshow /dev/fb0 /images >/dev/null
```

Displays randomized images from a text file with a list of relative file-paths and a display time of five minutes:

```
pfb_slideshow /dev/fb0 /frame/images.txt --root /frame --time 300 --random >/dev/null
```

We add the redirections to /dev/null because it's the most elegant way of
suppressing erroneous text verbosity that might write into the displayed image.


# Example Screenshot

![Screenshot](asset/example1.jpg)


# Features

- Prints a gutter at the bottom of the display with filename, EXIF model, and EXIF timestamp
- Can take a list of file-paths instead of a single path. The entries can be absolute or relative.
- Can randomize images
- Can control the delay between images
- Press left/right cursor to navigate through images
- Plays in a loop
