Skip to content

feat(providers): add Good Free Photos provider - #16

Merged
gitadityakumar merged 3 commits into
mainfrom
feat/goodfreephotos-provider
Sep 2, 2026
Merged

gitadityakumar merged 3 commits into
mainfrom
feat/goodfreephotos-provider

Conversation

@gitadityakumar

Copy link
Copy Markdown
Owner

Description

Adds Good Free Photos as a supported asset provider in ast. Good Free Photos is a large archive of thousands of 100% free CC0 public domain photos, state parks, landscapes, and landmarks by photographer Yinan Chen.

Features

  • Search: Queries https://www.goodfreephotos.com/page/search/?words={query} and parses ZenPhoto gallery photo results.
  • Direct Master Full-Resolution Photo Downloads: Automatically rewrites cached thumbnail endpoints (/cache/..._200_w200_..._thumb.jpg) to original full-resolution album master JPEGs (https://www.goodfreephotos.com/albums/...), delivering multi-megapixel camera master photos (7+ MB).
  • Metadata: Retains clean image IDs from photo slugs, alt prompt titles, photographer credit (Yinan Chen), and source page URLs.
  • Integration: Fully wired into registry, CLI search commands (ast s goodfreephotos ...), and interactive mode.

Verification

  • Tested search via ast s goodfreephotos "mountain" --limit 2 --json
  • Verified direct full-resolution download via ast s goodfreephotos "mountain" --first --download -o /tmp/downloads-test (downloaded 7.5 MB master JPEG @ 8362x3692)
  • Verified all unit and integration tests pass with zig build && zig build test.

@gitadityakumar
gitadityakumar merged commit 237bfc6 into main Sep 2, 2026
1 check passed
@gitadityakumar
gitadityakumar deleted the feat/goodfreephotos-provider branch September 2, 2026 17:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant