67 lines
1.5 KiB
Markdown
67 lines
1.5 KiB
Markdown
# Fake Media Generator
|
|
|
|
Creates a large fake image collection for testing without downloading real files.
|
|
|
|
## What it does
|
|
|
|
- Generates a small set of unique placeholder PNGs in several dimensions.
|
|
- Reuses those generated variants to create many files.
|
|
- Spreads the files across as many subfolders as you want.
|
|
- Uses only Python's standard library.
|
|
|
|
## TUI usage
|
|
|
|
```bash
|
|
python3 tools/fake-media/generate_fake_media.py
|
|
```
|
|
|
|
The script opens a terminal UI where you can edit:
|
|
|
|
- output directory
|
|
- image sizes
|
|
- variants per size
|
|
- folder count
|
|
- images per folder
|
|
- folder and file prefixes
|
|
- seed
|
|
- clear-output toggle
|
|
|
|
Controls:
|
|
|
|
- `Up` and `Down`: move between fields
|
|
- `Enter`: edit the selected field
|
|
- `Space`: toggle `Clear Output`
|
|
- `G`: generate files
|
|
- `Q`: quit
|
|
|
|
## Optional non-interactive mode
|
|
|
|
```bash
|
|
python3 tools/fake-media/generate_fake_media.py \
|
|
/tmp/fake-media \
|
|
--no-tui \
|
|
--sizes 320x240,640x480,1280x720,2048x1536 \
|
|
--variants-per-size 4 \
|
|
--folder-count 20 \
|
|
--images-per-folder 500 \
|
|
--folder-prefix album \
|
|
--file-prefix asset \
|
|
--clear-output
|
|
```
|
|
|
|
That example creates:
|
|
|
|
- 16 unique placeholder images.
|
|
- 20 subfolders named `album-001` through `album-020`.
|
|
- 10,000 total PNG files.
|
|
|
|
## Useful flags
|
|
|
|
- `--sizes`: comma-separated dimensions.
|
|
- `--variants-per-size`: unique image patterns per size.
|
|
- `--folder-count`: number of subfolders.
|
|
- `--images-per-folder`: files per subfolder.
|
|
- `--clear-output`: removes the target directory first.
|
|
- `--seed`: makes output repeatable.
|
|
- `--no-tui`: bypasses the terminal UI.
|