---
title: YouTube Post Image Downloader
emoji: 🖼️
colorFrom: red
colorTo: pink
sdk: gradio
sdk_version: 6.19.0
python_version: '3.11'
app_file: app.py
pinned: false
---
# YouTube Post Image Downloader

Upload a YouTube-posts-scraper CSV, pick your image columns, and download a ZIP — sorted oldest to newest.

## Run with Docker (recommended)

```bash
docker build -t yt-img-downloader .
docker run -p 7860:7860 yt-img-downloader
```

Then open **http://localhost:7860**

## Run locally (no Docker)

```bash
pip install -r requirements.txt
python app.py
```

## How to use

1. Upload your `.csv` file
2. A checkbox group appears — **image columns** (images/0, images/1 …) are pre-selected
3. You can also tick other URL columns if needed
4. Click **Download Images → ZIP**
5. The app downloads every image in date order (oldest post first) and packs them with an `overview.txt` log
6. Click the ZIP file to save it

## ZIP contents

```
images/
  0001_23_hours_ago_UgkxEzJ4_images_0.jpg
  0002_23_hours_ago_UgkxEzJ4_images_1.jpg
  ...
overview.txt   ← summary of what was downloaded / what failed
```