Metadata-Version: 2.1
Name: growingupvideo-slideshow
Version: 1.0.0
Summary: Generate HTML slideshows from photos with smooth CSS transitions
Home-page: https://growingupvideo.com
Author: GrowingUpVideo
Author-email: info@growingupvideo.com
License: UNKNOWN
Project-URL: Homepage, https://growingupvideo.com
Project-URL: Repository, https://github.com/claude-assistant-aviad/growingupvideo-slideshow-python
Project-URL: Bug Tracker, https://github.com/claude-assistant-aviad/growingupvideo-slideshow-python/issues
Keywords: slideshow,photo,image,transition,growing-up,growingupvideo,html-slideshow,gallery,css-transitions,timeline,before-after
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Graphics :: Presentation
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# growingupvideo-slideshow

Generate self-contained HTML slideshows from photos with smooth CSS transitions. Zero dependencies.

Perfect for showcasing growing-up photo collections, before-and-after timelines, or any image sequence.

[![PyPI version](https://badge.fury.io/py/growingupvideo-slideshow.svg)](https://pypi.org/project/growingupvideo-slideshow/)

## Installation

```bash
pip install growingupvideo-slideshow
```

## CLI Usage

```bash
growingupvideo-slideshow baby.jpg toddler.jpg teen.jpg adult.jpg -o growing-up.html
```

Options:

| Flag | Description | Default |
|------|-------------|---------|
| `-o, --output` | Output HTML file | `slideshow.html` |
| `-t, --transition` | `fade`, `slide`, or `zoom` | `fade` |
| `-i, --interval` | Slide interval in ms | `3000` |
| `-d, --duration` | Transition duration in ms | `800` |
| `--title` | Page title | `Photo Slideshow` |
| `--no-autoplay` | Disable auto-advance | |
| `--no-controls` | Hide prev/next buttons | |

## Python API

```python
from growingupvideo_slideshow import generate_slideshow, create_slideshow_file

# Generate HTML string
html = generate_slideshow(
    ["baby.jpg", "child.jpg", "teen.jpg", "adult.jpg"],
    transition="fade",
    interval=4000,
    title="Growing Up",
)

# Or write directly to file
create_slideshow_file(
    ["photo1.jpg", "photo2.jpg", "photo3.jpg"],
    "my-slideshow.html",
    transition="zoom",
    interval=3000,
)
```

### Using URLs

```python
html = generate_slideshow(
    ["https://example.com/photo1.jpg", "https://example.com/photo2.jpg"],
    transition="slide",
)
```

## Transitions

- **fade** — Smooth opacity crossfade
- **slide** — Horizontal slide with fade
- **zoom** — Subtle zoom-out reveal

## Output

Generates a single self-contained HTML file with:
- Embedded base64 images (for local files) or image URLs
- CSS transitions (no JavaScript animation libraries)
- Keyboard navigation (arrow keys)
- Responsive design

## Use Cases

- **Growing-up timelines** — Baby to adult photo sequences
- **Before/after comparisons** — Renovation, fitness, makeover
- **Event photo recaps** — Weddings, birthdays, trips
- **Portfolio presentations** — Quick image showcase

## Want AI-Powered Video Transitions?

This package creates simple HTML slideshows. If you want **AI-generated smooth video transitions** between your photos (morphing faces, aging effects, cinematic transitions), check out [GrowingUpVideo](https://growingupvideo.com) — it uses AI to create videos from your growing-up photos.

## License

MIT


