dl621

A simple python module and CLI utility to download e621 images with embedded XMP tags and description

Installation

pip install dl621

Usage

The program can be used as a simple command line program:

$ dl621 -h
usage: dl621 [-h] -i ID [-f FOLDER] [-n NAME] [-t] [-u USERAGENT]

Downloads e621 images with embedded XMP tags and description

optional arguments:
  -h, --help            show this help message and exit
  -i ID, --post_id ID   the ID of the e621 post
  -f FOLDER, --dl_folder FOLDER
                        the folder to download to
  -n NAME, --name_pattern NAME
                        the file name, Replacements: {m}=md5, {i}=post_id
  -t, --no_tags         don't save tags or metadata
  -u USERAGENT, --user_agent USERAGENT
                        manual override of the user agent string

It can also be imported and used in your own scripts (default options shown):

import dl621

r = dl621.download_image(post_id, output_folder=".", name_pattern="dl621_{m}", add_tags=True, messages=True, custom_json=None, user_agent="dl621/1.0 (by nimaid on e621)")
if r != None:
    print("Image downloaded! Location:", r)
else:
    print("Download failed!")