pixglean

command module

v0.1.0 Latest Latest Go to latest Published: Apr 18, 2026 License: MIT Imports: 2 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/panakour/pixglean

Links

Open Source Insights

README ¶

pixglean

Glean open-licensed wallpapers from the commons — no API keys, no lock-in.

$ pixglean wikimedia -q "mountain landscape" -n 3

  pixglean · wikimedia · "mountain landscape"
  → /Users/you/Pictures/pixglean

  ✓ found 3 images (47.2 MB)

  downloading ████████████████████████████████  3/3
  ✓ 3 downloaded   (47.2 MB in 4.2s)

pixglean downloads freely-licensed images from Wikimedia Commons and Openverse into ~/Pictures/pixglean. Public domain or Creative Commons — yours to use.

Install

go install github.com/panakour/pixglean@latest

Or grab a binary from Releases.

Usage

pixglean wikimedia                              # 5 random Featured Pictures
pixglean wikimedia -q "aurora" -n 10            # search Commons
pixglean openverse -q forest -l cc0,by-sa       # filter by CC license
pixglean wikimedia --silent && echo done        # script-friendly

flag	default
`-p, --path`	`~/Pictures/pixglean`	output directory
`-n, --number`	`5`	how many to fetch
`-q, --query`	empty	search term (empty = curated/random)
`-j, --jobs`	`4`	concurrent downloads
`--min-width`	`1280`	min width in pixels (`0` = off)
`--min-height`	`720`	min height in pixels (`0` = off)
`--size`	empty	size bucket: `small` (≤640w), `medium` (640–1600w), `large` (>1600w)
`-v, --verbose`	off	preview table before download
`--silent`	off	suppress non-error output
`-l, --license`	empty	Openverse license filter

Why

Wikimedia Commons and Openverse are public APIs with no auth and explicit reuse mandates. No keys to leak, no rate-limit surprises, no terms-of-service whiplash. Atomic writes, idempotent reruns, retries that honor Retry-After, graceful Ctrl+C — see CLAUDE.md.

Exit codes

0 success · 1 failure or no matches · 130 Ctrl+C

License

MIT

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

Path	Synopsis
internal
cli Package cli builds the cobra command tree and drives the TUI.	Package cli builds the cobra command tree and drives the TUI.
download Package download fetches images concurrently and writes them atomically.	Package download fetches images concurrently and writes them atomically.
httpx Package httpx wraps net/http with a User-Agent and retry on 5xx/429 (honoring Retry-After).	Package httpx wraps net/http with a User-Agent and retry on 5xx/429 (honoring Retry-After).
provider Package provider defines the Image/Query types and the Provider interface.	Package provider defines the Image/Query types and the Provider interface.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL