This is a picture frame slideshow for running on linux systems that is connected to a display/monitor. These linux systems may include Raspian, Ubuntu, Mint, or even WSL (Windows Subsystem for Linux). The image slideshow is displayed on a connected display, monitor, or projector in either horizontal (landscape) or vertical (portrait) orientation.
You can then control the picture frame slideshow's behavior using a simple browser based web interface of the local network at port 5555
. That is, you can access this web interface with http://<IP Address of Picture Frame Host>:55555
Very Basically ...
- You run this on a computer that is connected to a monitor, display, or projector.
- You will then be able to control the shown images on the monitor using a website that you can access with a computer, phone, or tablet.
- You can access this website as long as you are on your local or home network.
π Overview
π Compatibility
Minimum System Requirements
The following are the minimum system requirments where this application will work smooth and as intendent.
- CPU: 1.2 GHz
- CPUs/Cores: 4
- RAM: 1GB
- Disk Storage: 400 MB + Images
π Installing and Setup
- [If on remote computer] Enter remote linux device using
ssh
:- MAC/Linux Terminal, Windows Powershell:
ssh <username/login>@<IP address of picture frame computer>
- May need to enable SSH on remote linux host computer:
sudo apt install -y openssh-server
- MAC/Linux Terminal, Windows Powershell:
- Navigate into user documents directory:
$ cd ~/Documents
- Install git:
$ sudo apt -y install git-all
- Configure git:
$ git config --global user.name "Your Name Here"
$ git config --global user.email "[email protected]"
- Clone this public git repo form github:
$ git clone [email protected]:ismet55555/Super-Best-Frame.git
- Change directory into cloned directory:
$ cd Super-Best-Frame
- Install OpenCV system dependencies:
$ sudo apt -y install python3-opencv
- Run the start script
$ ./start
NOTE: Check out the start
script to see what exactly it executes.
π₯ Usage
TODO - Maybe some gifs
Image Formats You Can Use
.png
,.jpg
,.jpeg
,.bmp
,.dib
,.jpe
,.jp2
,.pgm
,.tiff
,.tif
,.ppm
Adding Images
All images that are displayed in the picture frame must be stored in the Images
directory of this project.
Note that subdirectories in the "Images" directory will not be considered.
Using The Web Interface
- TODO
Via Physical Flash/USB Drive
- TODO
scp
Command
Remotely Via - TODO
ftp
Command
Remotely Via - TODO
π€ Author
Ismet HandΕΎiΔ - Github: @ismet55555
Licence
This project is licensed under the MIT License - see the LICENSE.md file for details