<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](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).
</div>
# 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 <asset_type>
# 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:
```
<asset_type> "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)
Raw data
{
"_id": null,
"home_page": "https://github.com/agmmnn/polydown",
"name": "polydown",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7,<4.0",
"maintainer_email": "",
"keywords": "polyhaven,download,downloader,scrape,hdri,batch",
"author": "G\u00f6k\u00e7e Merdun",
"author_email": "agmmnn@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/46/22/fa03405c8085c392690e2ebe52d269bfc40bea080ab63698b3754943ac92/polydown-0.3.2.tar.gz",
"platform": null,
"description": "\n\n<div align=\"center\">\n<a href=\"https://github.com/agmmnn/polydown\">\n<img alt=\"GitHub release (latest by date)\" src=\"https://img.shields.io/github/v/release/agmmnn/polydown\"></a>\n<a href=\"https://pypi.org/project/polydown/\">\n<img alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/polydown\"></a>\n\nBatch 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).\n\n</div>\n\n# Installation\n\n```\npip install polydown\n```\n\n# How to Use\n\n```\n$ polydown hdris\n\n# download all available sizes of all hdris into current folder.\n> \ud83d\udd17(polyhaven.com/hdris['all sizes'])=>\ud83c\udfe0\n```\n\n```\n$ polydown <asset_type>\n\n# download all assets of this asset type to the current folder in all available sizes.\n# asset types: \"hdris\", \"textures\", \"models\".\n```\n\n```\n$ polydown textures -c\n\n# list of category in the given asset type.\n```\n\n```\n$ polydown hdris -f hdris_down -s 2k 4k\n\n# download all hdris with given sizes into \"hdris_down\" folder.\n# /if there is no such folder it will create it./\n> \ud83d\udd17(polyhaven.com/hdris['2k', '4k'])=>\ud83c\udfe0(hdris_down)\n```\n\n## Example Usage\n\n```\n$ polydown models -c decorative -f folder -s 1k\n\n# download all \"models\" with \"1k textures\" in the \"decorative\" category into the \"folder\".\n```\n\n\n\n\n\n# Arguments:\n\n```\n<asset_type> \"hdris, textures, models\"\n-h, --help show this help message and exit\n-f, --folder target download folder.\n-c, --category category to download.\n-s, --sizes size(s) of downloaded asset files. eg: 1k 2k 4k\n-o, --overwrite overwrite if the files already exists. otherwise the current task will be skipped.\n-no, --noimgs do not download 'preview, render, thumbnail...' images.\n-it, --iters amount of iterations.\n-t, --tone Download 8K Tonemapped JPG (only HDRIs).\n-ff, --fileformat file format for hdris (hdr, exr).\n-v, --version show program's version number and exit\n```\n\n# To-Do\n\n- [ ] Unit Tests\n- [ ] Progressbar for current download task(s)\n- [ ] Select the file format to download\n- [ ] Download a specific asset, \"polydown hdris stuttgart_suburbs\"\n\n# Requirements\n\n- Python>3.7\n\n## Dependencies\n\n- [requests](https://pypi.org/project/requests/)\n- [rich](https://github.com/willmcgugan/rich)\n\n# License\n\n[MIT](https://github.com/agmmnn/polydown/blob/master/LICENSE)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Batch downloader for polyhaven (polyhaven.com)",
"version": "0.3.2",
"project_urls": {
"Bug Tracker": "https://github.com/agmmnn/polydown/issues",
"Changelog": "https://github.com/agmmnn/polydown/releases",
"Homepage": "https://github.com/agmmnn/polydown",
"Repository": "https://github.com/agmmnn/polydown",
"Source": "https://github.com/agmmnn/polydown"
},
"split_keywords": [
"polyhaven",
"download",
"downloader",
"scrape",
"hdri",
"batch"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "92b694e2d58295aaff49d1d59ba824eb1f74e53bf428864872c5523c50829f32",
"md5": "adcdf36c0ba822691cc3143d2d6d04db",
"sha256": "691129c97f9321c3dbcb400c28b80bcd2fc2fb21296b5709e3ced378008b8524"
},
"downloads": -1,
"filename": "polydown-0.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "adcdf36c0ba822691cc3143d2d6d04db",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<4.0",
"size": 9679,
"upload_time": "2023-05-17T19:41:55",
"upload_time_iso_8601": "2023-05-17T19:41:55.906996Z",
"url": "https://files.pythonhosted.org/packages/92/b6/94e2d58295aaff49d1d59ba824eb1f74e53bf428864872c5523c50829f32/polydown-0.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4622fa03405c8085c392690e2ebe52d269bfc40bea080ab63698b3754943ac92",
"md5": "db4cba62d7dcc894a31d9593f3e1b0c9",
"sha256": "130e457b9205c65aac403446a497daf067adb652c3f27ff8b4ecf562231944dc"
},
"downloads": -1,
"filename": "polydown-0.3.2.tar.gz",
"has_sig": false,
"md5_digest": "db4cba62d7dcc894a31d9593f3e1b0c9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<4.0",
"size": 8417,
"upload_time": "2023-05-17T19:41:57",
"upload_time_iso_8601": "2023-05-17T19:41:57.165307Z",
"url": "https://files.pythonhosted.org/packages/46/22/fa03405c8085c392690e2ebe52d269bfc40bea080ab63698b3754943ac92/polydown-0.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-17 19:41:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "agmmnn",
"github_project": "polydown",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "polydown"
}
JSON
