comparison verysimpleslideshow/README.md @ 40:a2ac31358aba default tip

READEM FIX
author prymula <prymula76@outlook.com>
date Sat, 10 Feb 2024 22:37:08 +0100
parents
children
comparison
equal deleted inserted replaced
39:8acefa057ffc 40:a2ac31358aba
1 # verysimpleslideshow
2
3 # Start
4
5 Python script for creating slideshows from JPG photos.
6 The application allows you to create videos from photos, both in portrait and landscape orientation. It was created out of the author's personal needs. With the aim, to facilitate the creation of slideshows for Facebook. The author's intention was not to create an application for everyone, writing this script, he mainly focused on his own needs and capabilities.
7
8 The script works with images with a size of 1080 pixels for the longest side. If the image is larger, it will then be scaled.
9 For a video with a vertical orientation, horizontal images, will be added in a pair, one below the other. For an odd image, it is intended to place the photo in the middle of the frame. For horizontal orientation of the film, vice versa.
10
11 The program works with photographs with an aspect ratio of 3:2 and 4:3. Which is quite enough for the author, the extension for widescreen formats, is not provided. The program recognizes the photo format itself - although it can unexpectedly reject this and that. For image processing, the script uses the PILLOW library. Meanwhile, to encode the video, the 'ffmpeg' command. In the case of Fedora, which the author uses. The package used is 'ffmpeg' from RPM Fusion. The arguments from this version of the command, may not be compatible with the 'ffmpeg-free' version from the Fedora Core repository, which is something to keep in mind. The codec used is x264 (instead of openh264 from FC). So if you are using 'ffmpeg-free' and would like to use this script, I can recommend you this page, which contains information about the package version change: https://rpmfusion.org/Howto/Multimedia
12 The script was recently, adapted to work in Debian/Ubuntu distributions. It was tested in Lubuntu 22.04 with the standard version of 'ffmpeg'. In the case of Okienek, the tests were not successful.
13
14
15 ## Installation and uninstallation
16
17 ```
18 sudo make install
19 sudo make uninstall
20 ```
21
22 ## Usage
23
24 Use the script installed in the file system, in the directory with photos, with the command:
25
26 ```
27 'verysimpleslideshow.py -H' or 'verysimpleslideshow.py' - create horizontal movie
28 'verysimpleslideshow.py -V' - create a vertical movie
29 'verysimpleslideshow.py -h' - display help and version number.
30 ```
31
32 In Fedora and OpenSUSE distributions, you can use the link:
33
34 'vsss'
35
36
37 ## File extensions written with a capital letter
38
39 The script only works with files with extensions written in lowercase letters
40
41 rename JPG jpg *.JPG