blup#

Upload images to the blue sky ☁️

A fast CLI tool for uploading images to your AT Protocol PDS and getting instant CDN URLs through images.blue.

Features#

• 📤 Upload images directly to your Bluesky/AT Protocol PDS
• 🔗 Get instant CDN URLs from images.blue
• 📋 Automatic URL copying to clipboard
• 🎨 Supports JPEG, PNG, WebP, GIF formats
• 🔐 Secure OAuth authentication
• ⚡ Single command uploads

Installation#

Using Go#

go install tangled.sh/evan.jarrett.net/blup/cmd/blup@latest

Quick Start#

# 2. Authenticate
blup auth

# 3. Upload an image
blup upload cat.jpg

Commands#

blup auth#

Authenticate with your AT Protocol account via OAuth

blup upload [file]#

Upload an image and get the CDN URL

$ blup upload avatar.png
🚀 Uploading to alice.bsky.social...
✅ Upload complete!

📋 CDN URL (copied to clipboard):
https://images.blue/alice.bsky.social/1TpTNotr6YUww6cD6SLyWi2A2uFkH1lVEnqMXvwdjrwkAU4k

blup status#

Check your current authentication status

$ blup status
✅ Authenticated as alice.bsky.social
   PDS: https://bsky.social

blup logout#

Remove stored credentials

$ blup logout
✅ Logged out successfully

Usage Examples#

# Upload a profile picture
blup upload profile.jpg

# Upload a screenshot
blup upload screenshot.png

# The URL is automatically copied to your clipboard!
# Just paste directly into your blog, documentation, or chat

OAuth Setup#

blup uses OAuth for secure authentication:

1. Run blup auth to authenticate
2. Your browser will open for authorization
3. You're ready to upload!

Building from source#

git clone https://github.com/yourusername/blup.git
cd blup
go build -o blup cmd/blup/main.go

Why blup?#

• Dead simple - Authenticate once, upload with a single command
• Instant CDN URLs - Powered by the global images.blue CDN
• Clipboard ready - URL copied automatically, just paste and go
• Lightweight - Single binary, no dependencies

Built with 💙 for the AT Protocol ecosystem