Build a slidershow media presentation from a sheet.
Just put file names into the sheet and we generate the HTML file.
graph LR;
sheet --> slidershow-builder --> presentation.html
Features
- Find files on disk, evade hassling with the relative paths.
Ex. You just use the file name from Google Photos, slidershow-builder will find an original file within the given directories scope.
- auto-conversion
Some formats cannot be played in the browser; slidershow-builder will automatically creates a cache folder with the mp4 files, playable everywhere.
Installation
pip install slidershow-builder
Sheet
Format of the sheet
Columns:
comment filename start commands
Comment is an inserted HTML comment, displayed at the presenter's notes.
Text frame
- filename:
- start: header
- commands: subtitle
Image frame
start: point
[left = 0, top = 0, scale = 1, transition_duration = 0, duration = 0, data-rotate = 0]
Ex: [[], [100,100,5]] will begin unzoomed, on the next frame we zoom to 5.
See: https://github.com/CZ-NIC/slidershow/?tab=readme-ov-file#data-step-points
How to get the point? Go to the slidershow in the browser, open properties Alt+p and click on the new point.
Video frame
start
- video start time, empty = 0:00
commands
- number is a timestamp, jehož akce určují následující buňky
- posouvací šipka, ex:
→60.5skočí z momentu na 60.5 - rate a číslo změní rate momentu
rate 2 - mute, unmute
- R+number(M|U): rate. Ex:
R2= rate 2,R4M= rate 4 + mute - P = rate 1, unmute
- F+number: faster rate. Ex
F2= rate 1.2 - comma character behaves like a cell-separator, these are independent commands
rate 2, unmute→rate 2aunmute - poslední osamělé číslo je end
- point command zooms, ex:
point:[0,0,2,null,null,270]zoom and rotate. (Point musí být v buňce zvlášť.)
Ex: 15, → 4, 1:10: At 0:15, jump to 0:04, then end at 1:10.
Section break
comment: SECTION
If the row starts with the word "SECTION", a new <section> is inserted. (And the row is skipped.)
Rows:
Parsing ends on the first empty row.
Usage
$ slidershow-builder --help
usage: slidershow-builder [-h] [OPTIONS]
╭─ options ──────────────────────────────────────────────────────────────────╮
│ -h, --help │
│ show this help message and exit │
│ --verbose, -v │
│ verbosity level, can be used multiple times to increase │
│ --file PATH │
│ (required) │
│ --sheet STR │
│ Sheet name to process. If None, all will be processed and multiple │
│ files will be generated (if `--output` set). │
│ (...) │
│ --output PATH │
│ By default, the output is printed to the screen. (default: None) │
│ --replace-in-filename {[STR STR [STR STR ...]]} │
│ If set, filename from the sheet will be replaced according to this. │
│ Ex: --replace-filename /mnt/user /mnt/foo jpg JPG -> filename │
│ /mnt/user/dir/img.jpg → /mnt/foo/dir/img.JPG (default: None) │
│ --filename-autosearch {[PATH [PATH ...]]} │
│ If the filename is without path and the file does not exist, try │
│ finding the file within these dirs. (default: None) │
│ --no-filename-autosearch-cache │
│ Use a cache file for filename_autosearch, persistent accress program │
│ launches. (default: True) │
╰────────────────────────────────────────────────────────────────────────────╯
╭─ convert options ──────────────────────────────────────────────────────────╮
│ Auto-convert for browser-compatible formats. │
│ Creates a cached copies with compatible JPG and MP4. │
│ ────────────────────────────────────────────────────────────────────────── │
│ --convert.enable │
│ The cache will be used for needy media. (default: False) │
│ --convert.no-autogenerate │
│ If .enable, generate all the needy media to the cache. (default: True) │
│ --convert.cache-dir PATH │
│ (default: /tmp) │
│ --convert.no-heic │
│ Generate JPG from HEIC. (default: True) │
│ --convert.no-hevc │
│ Generate MP4 from HEVC. (default: True) │
│ --convert.no-hevc-in-mp4 │
│ Check for HEVC codec in MP4 video files. (default: True) │
╰────────────────────────────────────────────────────────────────────────────╯
╭─ slidershow options ───────────────────────────────────────────────────────╮
│ --slidershow.template PATH │
│ HTML template the presentation is made of. (default: ...) │
│ --slidershow.url STR │
│ The URL to be used for generating. Ex. you might want to use an │
│ offline local copy of the project. (default: │
│ https://cdn.jsdelivr.net/gh/CZ-NIC/slidershow@main/slidershow/slidersh │
│ ow.js) │
╰────────────────────────────────────────────────────────────────────────────╯
Metadata
Release files for slidershow-builder 0.6.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| slidershow_builder-0.6.2.tar.gz | 21.2 kB | Without provenance | Details for slidershow_builder-0.6.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| slidershow_builder-0.6.2-py3-none-any.whl | Python 3 | none | any | Details for slidershow_builder-0.6.2-py3-none-any.whl |
Total release size: 45.5 kB
Release files / slidershow_builder-0.6.2.tar.gz
| Download URL | slidershow_builder-0.6.2.tar.gz |
|---|---|
| Size | 21.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
10958b66f6652396967da2f0a98f150166f6676004b36ba229c77b854c254add
|
|
BLAKE2b-256 checksum How to use checksums |
35ad68b2957902ef8bb3398dbb68f84d5a40e4cedf71c0673be39fdd65808b92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Release files / slidershow_builder-0.6.2-py3-none-any.whl
| Download URL | slidershow_builder-0.6.2-py3-none-any.whl |
|---|---|
| Size | 24.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e12d624ea0bc9837ff4ef2bd830d133a0e7c10b947359b35bceaddc5dcfc7a7a
|
|
BLAKE2b-256 checksum How to use checksums |
b6253312ea6d7c3edb56d45688d4ad72c907505bed39ba3893e5f73f2cab40d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Security for slidershow-builder 0.6.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.