Grabbit

A small single-binary CLI to grab images from Reddit - I've been surprised how much I enjoy seeing beautiful wallpapers when I lock/unlock my computer. grabbit automatically skips images tagged NSFW, designed to be easy to install/uninstall and is MIT licensed.

@bbkane's Setup

See my personal config.

Project Status (2025-06-14)

Basically complete! I use grabbit for wallpapers. At some point I'd like to use OTEL tracing instead of the current logging framework, but that's not a huge deal. I'm watching issues; please open one for any questions and especially BEFORE submitting a Pull request.

Install

• Homebrew: brew install bbkane/tap/grabbit
• Scoop:

scoop bucket add bbkane https://github.com/bbkane/scoop-bucket
scoop install bbkane/grabbit

• Download Mac/Linux/Windows executable: GitHub releases
• Go: go install go.bbkane.com/grabbit/v5@latest
• Build with goreleaser after cloning: goreleaser release --snapshot --clean

Use

# Grab from passed flags
grabbit grab \
    --destination . \
    --subreddit-info wallpapers,day,5 \
    --subreddit-info earthporn,week,10

# Create/Edit config file
grabbit config edit --editor /path/to/editor

# Grab from config file
grabbit grab

See current wallpapers

On macOS, I use the followng command to see what wallpapers (and any other open files) my desktop is using:

lsof -c WallpaperImageExtension

I can run a similar command in XFCE:

xfconf-query -c xfce4-desktop -l \
| grep last-image \
| while read -r property; do xfconf-query -c xfce4-desktop -p "$property"; done \
| sort -u

Docs

• Run grabbit on a schedule: ./schedule_it.md
• Hack on grabbit: ./dev_notes.md
• See Go Project Notes for notes on development tooling.
• MIT Licensed

3rd Party Credits

• library authors: see ./go.mod
• inspiration: reddit_get_top_images