https://github.com/bbkane/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.
https://github.com/bbkane/grabbit

cli go golang homebrew reddit wallpaper

Last synced: 2 months ago
JSON representation

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.

• Host: GitHub
• URL: https://github.com/bbkane/grabbit
• Owner: bbkane
• License: mit
• Created: 2020-09-06T19:36:01.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-06-29T15:19:30.000Z (6 months ago)
• Last Synced: 2024-10-25T04:22:59.492Z (3 months ago)
• Topics: cli, go, golang, homebrew, reddit, wallpaper
• Language: Go
• Homepage:
• Size: 941 KB
• Stars: 21
• Watchers: 4
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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](./LICENSE).

## @bbkane's Setup

See my [personal config](https://github.com/bbkane/dotfiles/blob/master/grabbit/dot-config/grabbit.yaml).

![My Setup](./reddit_wallpapers.jpg)

## Install

- [Homebrew](https://brew.sh/): `brew install bbkane/tap/grabbit`

- [Scoop](https://scoop.sh/):

```

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

scoop install bbkane/grabbit

```

- Download Mac/Linux/Windows executable: [GitHub releases](https://github.com/bbkane/grabbit/releases)

- Go: `go install go.bbkane.com/grabbit/v4@latest`

- Build with [goreleaser](https://goreleaser.com/) after cloning: `goreleaser --snapshot --skip-publish --rm-dist`

## Use

```bash

# Grab from passed flags

grabbit grab \

    --subreddit-destination . \

    --subreddit-limit 5 \

    --subreddit-name wallpapers \

    --subreddit-timeframe day

# Create/Edit config file

grabbit config edit --editor /path/to/editor

# Grab from config file

grabbit grab

```

## Docs

- Run grabbit on a schedule: [./schedule_it.md](./schedule_it.md)

- Hack on grabbit: [./dev_notes.md](./dev_notes.md)

- [MIT Licensed](./LICENSE)

## 3rd Party Credits

- library authors: see [./go.mod](./go.mod)

- inspiration: [reddit_get_top_images](https://github.com/nagracks/reddit_get_top_images)