Polydown

<div align="center"> <a href="https://github.com/agmmnn/polydown"> <img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/agmmnn/polydown"></a> <a href="https://pypi.org/project/polydown/"> <img alt="PyPI" src="https://img.shields.io/pypi/v/polydown"></a>

Batch downloader for polyhaven.com. Download HDRIs, textures, and models in any sizes you want.
This project uses Poly Haven's Public API.

</div>

Installation

pip install polydown

Usage

Basic Commands

Download all HDRIs:

polydown hdris

Download all Textures:

polydown textures

Download all Models:

polydown models

Note: These commands will download all available sizes for every asset in the category.

---

Advanced Usage

Download specific sizes to a specific folder:

polydown hdris -f my_hdris_folder -s 2k 4k

Downloads all HDRIs in 2k and 4k resolution to the my_hdris_folder.

Download from a specific category:

polydown models -c decorative -f models_folder -s 1k

Downloads all "decorative" models with 1k textures into models_folder.

List available categories for an asset type:

polydown textures -c

Granular Texture & Model Selection:

You can specify the specific file format (e.g. png, jpg, exr) and specific maps (e.g. diffuse, roughness) for both textures and models.

# Download only PNG textures
polydown textures -tf png

# Download only Diffuse and Roughness maps
polydown textures --maps Diffuse Rough

# Combine them: Download only EXR Normal maps
polydown textures -tf exr --maps nor_gl

# Works for models too (downloads specific texture maps for the model)
polydown models -tf jpg --maps Diffuse -s 1k

Arguments

| Argument | Description | | :------------------------ | :----------------------------------------------------------------------------------------------------------------------- | | asset_type | Type of asset to download: hdris, textures, models. | | -h, --help | Show help message and exit. | | -f, --folder | Target download folder. | | -c, --category | Category to download (e.g., decorative, nature). If used without values, lists available categories. | | -s, --sizes | Size(s) of downloaded assets. Example: 1k 2k 4k. | | -o, --overwrite | Overwrite existing files. Otherwise, skips existing files. | | -no, --noimgs | Do not download preview, render, or thumbnail images. | | -it, --iters | Amount of iterations (limit number of assets). | | -t, --tone | Download 8K Tonemapped JPG (HDRIs only). | | -ff, --fileformat | File format for HDRIs (hdr, exr). | | -tf, --texture-format | File format for Textures/Models (jpg, png, exr). | | --maps | Texture maps to download (e.g., Diffuse, Rough, nor_gl). If used without values, lists available common map types. | | -w, --workers | Amount of workers (threads) for concurrent downloads. | | -v, --version | Show program's version number and exit. |

Development

This project uses uv for dependency management.

Setup

1. Install uv:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Sync dependencies:

   uv sync
   

3. Run the CLI:

   uv run polydown --help
   

4. Run tests:

   uv run pytest
   

To-Do

• [x] Unit Tests
• [x] Progressbar for current download task(s)
• [x] Workers for concurrent downloads
• [x] Select the file format to download

License

MIT