Simple avogadr.io batch downloader python script


avogadr-py is avalaible through Python Package Index (PyPI) using pip:

[email protected]:~$ python3 -m pip install --upgrade avogadr_py

To uninstall using pip:

[email protected]:~$ python3 -m pip uninstall avogadr_py

Command reference

[email protected]:~$ avogadr-py -h
usage: avogadr-py [-h] [-i INPUT] [-o OUTPUT_FOLDER] [-b BACKGROUND] [-f FOREGROUND] [-W WIDTH] [-H HEIGHT] [-n]

  -h, --help            show this help message and exit
  -i INPUT, --input INPUT
                        JSON formatted compound list. Defaults to 'compounds.json'.
  -o OUTPUT_FOLDER, --output-folder OUTPUT_FOLDER
                        Folder to output files to. Defaults to 'output/'.
  -b BACKGROUND, --background BACKGROUND
                        Background colour in HEX format. Defaults to '24283b'.
  -f FOREGROUND, --foreground FOREGROUND
                        Foreground colour in HEX format. Defaults to '7aa2f7'.
  -W WIDTH, --width WIDTH
                        Image width in pixels. Defaults to '1920'.
  -H HEIGHT, --height HEIGHT
                        Image height in pixels. Defaults to '1080'.
  -n, --no-include-name
                        Don't include compound names. Defaults to 'False'.


You can see how the compounds JSON is structured in the compounds.json file. Feel free to use it too.

[email protected]:~$ avogadr-py -i compounds.json -W 3840 -H 2160 -o output/2160p/blue -f 7aa2f7


Source code repository is available on GitHub. Feel free to contribute. Bug reports and suggestions are welcome.


avogadr-py is licensed under the MIT License.


  • I would like to thank for the amazing avogadr.io website that is used as basis for this script.


View Github