grain.social / grain
grain.social is a photo sharing platform built on atproto.
fork atom
grain / cli / README.md
at main 1.3 kB view raw view code

Grain CLI#

⚠️ Work in Progress: This CLI is currently under development and is not ready for use yet.

A command-line interface for grain.social - a platform for sharing photo galleries.

Features#

  • Authentication: OAuth login flow with grain.social
  • Gallery Management: List and create photo galleries
  • Image Upload: Bulk upload images from local folders with automatic resizing

Requirements#

Installation#

Build from source:

cargo build --release

The binary will be available at target/release/grain.

Usage#

Authentication#

First, authenticate with your grain.social account:

grain login

This will open your browser for OAuth authentication.

List your existing galleries:

grain gallery list

Create a new gallery from a folder of images:

grain gallery create

You'll be prompted for:

  • Gallery title
  • Gallery description (optional)
  • Path to folder containing images

The CLI will automatically resize images and upload them to your new gallery.

Verbose Output#

Add --verbose to any command for detailed output:

grain login --verbose
grain gallery create --verbose