polydown 0.4.1

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

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

Select model file formats:

By default, models downloads .blend files. Use -mf/--model-format to pick one or more formats. Available: blend, fbx, gltf, usd, usdc, usdz.

# Download both Blend and FBX
polydown models -s 2k -mf blend fbx

# Only FBX
polydown models -s 2k -mf fbx

# All common formats
polydown models -s 2k -mf blend fbx gltf usd

Arguments

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

• Unit Tests
• Progressbar for current download task(s)
• Workers for concurrent downloads
• Select the file format to download
• Select model file format (blend, fbx, gltf, usd)

License

MIT