https://github.com/agmmnn/polydown
Batch downloader for polyhaven.com. Download 'HDRIs, Textures and Models' in any sizes with preview images from Poly Haven.
https://github.com/agmmnn/polydown
3d 3d-models blender downloader hdri polyhaven textures
Last synced: 2 months ago
JSON representation
Batch downloader for polyhaven.com. Download 'HDRIs, Textures and Models' in any sizes with preview images from Poly Haven.
- Host: GitHub
- URL: https://github.com/agmmnn/polydown
- Owner: agmmnn
- License: mit
- Created: 2021-09-24T21:29:43.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-05-17T19:34:26.000Z (about 2 years ago)
- Last Synced: 2024-10-11T12:45:44.421Z (8 months ago)
- Topics: 3d, 3d-models, blender, downloader, hdri, polyhaven, textures
- Language: Python
- Homepage:
- Size: 86.9 KB
- Stars: 45
- Watchers: 3
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.MD
- Changelog: CHANGELOG.MD
- License: LICENSE
Awesome Lists containing this project
README
Batch downloader for [polyhaven.com](https://polyhaven.com/). Download hdris, textures and models in any sizes you want. This project uses Poly Haven's [Public API](https://github.com/Poly-Haven/Public-API).
# Installation
```
pip install polydown
```
# How to Use
```
$ polydown hdris
# download all available sizes of all hdris into current folder.
> 🔗(polyhaven.com/hdris['all sizes'])=>🏠
```
```
$ polydown
# download all assets of this asset type to the current folder in all available sizes.
# asset types: "hdris", "textures", "models".
```
```
$ polydown textures -c
# list of category in the given asset type.
```
```
$ polydown hdris -f hdris_down -s 2k 4k
# download all hdris with given sizes into "hdris_down" folder.
# /if there is no such folder it will create it./
> 🔗(polyhaven.com/hdris['2k', '4k'])=>🏠(hdris_down)
```
## Example Usage
```
$ polydown models -c decorative -f folder -s 1k
# download all "models" with "1k textures" in the "decorative" category into the "folder".
```
# Arguments:
```
"hdris, textures, models"
-h, --help show this help message and exit
-f, --folder target download folder.
-c, --category category to download.
-s, --sizes size(s) of downloaded asset files. eg: 1k 2k 4k
-o, --overwrite overwrite if the files already exists. otherwise the current task will be skipped.
-no, --noimgs do not download 'preview, render, thumbnail...' images.
-it, --iters amount of iterations.
-t, --tone Download 8K Tonemapped JPG (only HDRIs).
-ff, --fileformat file format for hdris (hdr, exr).
-v, --version show program's version number and exit
```
# To-Do
- [ ] Unit Tests
- [ ] Progressbar for current download task(s)
- [ ] Select the file format to download
- [ ] Download a specific asset, "polydown hdris stuttgart_suburbs"
# Requirements
- Python>3.7
## Dependencies
- [requests](https://pypi.org/project/requests/)
- [rich](https://github.com/willmcgugan/rich)
# License
[MIT](https://github.com/agmmnn/polydown/blob/master/LICENSE)