annotate 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
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
40
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
1 # verysimpleslideshow
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
2
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
3 # Start
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
4
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
5 Python script for creating slideshows from JPG photos.
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
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.
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
7
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
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.
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
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.
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
10
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
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
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
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.
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
13
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
14
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
15 ## Installation and uninstallation
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
16
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
17 ```
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
18 sudo make install
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
19 sudo make uninstall
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
20 ```
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
21
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
22 ## Usage
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
23
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
24 Use the script installed in the file system, in the directory with photos, with the command:
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
25
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
26 ```
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
27 'verysimpleslideshow.py -H' or 'verysimpleslideshow.py' - create horizontal movie
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
28 'verysimpleslideshow.py -V' - create a vertical movie
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
29 'verysimpleslideshow.py -h' - display help and version number.
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
30 ```
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
31
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
32 In Fedora and OpenSUSE distributions, you can use the link:
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
33
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
34 'vsss'
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
35
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
36
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
37 ## File extensions written with a capital letter
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
38
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
39 The script only works with files with extensions written in lowercase letters
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
40
a2ac31358aba READEM FIX
prymula <prymula76@outlook.com>
parents:
diff changeset
41 rename JPG jpg *.JPG