Skip to content
Projects

agmmnn/polydown has 109 GitHub stars and 9 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 19:39 UTC. Last push 2026-04-21.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Batch downloader for polyhaven.com. Download 'HDRIs, Textures and Models' in any sizes with preview images from Poly Haven.

Creative & Media

README.md

Original

screenshot

GitHub release (latest by date) PyPI PyPI Downloads

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

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).
-mf, --model-format Model file format(s) (blend, fbx, gltf, usd, usdc, usdz). Accepts multiple. Default: blend.
--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.

file structure

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