gallery-dl

Gallery-DL Skill

Download images and galleries from 100+ image hosting sites using gallery-dl.

Supported Sites

• Social: Twitter/X, Instagram, Reddit, Tumblr, Bluesky
• Art Platforms: DeviantArt, ArtStation, Pixiv, Newgrounds
• Image Boards: Danbooru, Gelbooru, e621, Rule34
• Manga: MangaDex, Webtoon, Tapas
• Photo: Flickr, 500px, Imgur
• And many more...

Capabilities

Requirements

pip install gallery-dl

Authentication

For sites requiring login, set credentials in config or env:

export GALLERY_DL_USER="username"
export GALLERY_DL_PASS="password"

Or use browser cookies:

skill.download_gallery(url, cookies_from="firefox")

Usage Examples

Download Gallery

from rhea_noir.skills.gallerydl.actions import skill as gallery

result = gallery.download_gallery(
    url="https://www.deviantart.com/artist/gallery",
    output_dir="./images"
)

Download User's Images

result = gallery.download_user(
    url="https://twitter.com/username",
    output_dir="./images",
    limit=100
)

Get Image URLs Only

result = gallery.get_urls("https://imgur.com/a/albumid")
# Returns list of direct image URLs

Download with Filter

result = gallery.download_with_filter(
    url="https://danbooru.donmai.us/posts?tags=landscape",
    min_width=1920,
    file_types=["jpg", "png"]
)

Output Templates

Default: {category}/{subcategory}/{filename}.{extension}

Custom templates available via output_template parameter.