ambientCG Downloader

Download all the CC0 textures from the official ambientcg.com website easily.

Download the entire ambientCG texture library

This repository was created to simplify a repetitive process: downloading textures from ambientCG, extracting them, and manually removing unused images.

With this automation, all textures are pre-downloaded to your computer. Once you find the texture you need on the ambientCG website, you can quickly locate it locally without additional steps.

Installation

You can set up the project in two ways: using Poetry or a traditional setup with requirements.txt. Choose the poetry if you want to avoid dependencies issues.

Option 1: Using Poetry

1. Ensure you have Poetry installed.

   pip install poetry

2. Clone the repository:

   git clone https://github.com/alvarognnzz/ambientcg-downloader
   cd ambientcg-downloader

3. Install dependencies:

   poetry install

4. Run the script:

   poetry run python main.py

Option 2: Without Poetry

1. Clone the repository:

   git clone https://github.com/alvarognnzz/ambientcg-downloader
   cd ambientcg-downloader

2. Install dependencies:

   pip install -r requirements.txt

3. Run the script:

   python script.py

Both methods will set up the environment for running the project. If you're new to dependency management, the second option (requirements.txt) is more straightforward.

Setting up the script

To configure the script, use the config.yaml file. Here's an example configuration:

resolution: "1K"                  # (1K, 2K, 4K, 8K)
file_type: "JPG"                  # (JPG/PNG)
downloads_folder: "downloads"
unzip: 
  enabled: true                   # (true/false)
  folder: "unzipped"
keep_files:                       # Files marked as false will be deleted
  color: true
  roughness: true
  normal_gl: true
  normal_dx: true
  metalness: true
  opacity: true
  ambient_occlusion: true
  displacement: false
  cover: false

How to use it

1. Adjust the settings

   • Open the config.yaml file in a text editor.
   • Set the resolution to the desired quality (e.g., "1K", "2K").
   • Choose the file_type (either "JPG" or "PNG").
   • Specify the folder for downloaded textures under downloads_folder.

2. Configure unzipping

   • If you want the textures to be automatically extracted, set enabled to true.
   • Define the folder for unzipped files under folder.

3. Manage file types

   • In the keep_files section, mark the file types you want to keep as true.
   • Any file type set to false will be deleted after extraction.

4. Run the script

   • Save your changes to the config.yaml file.
   • Execute the script, and it will follow the configuration to download, unzip, and manage the textures automatically.

Warning

The ambientCG texture library is quite large, with a size of up to 10GB at 1K resolution.
If you select a higher resolution (e.g., 2K or 4K), the download process may take several hours depending on your internet speed and system performance.