Pasterly

Pasterly is an Obsidian plugin that automatically uploads clipboard images to cloud storage and generates markdown links. Supports Firebase Storage, Google Cloud Storage, and S3-compatible storage such as AWS S3 and Cloudflare R2.

Features

• 📷 Automatically uploads clipboard images to cloud storage
• ⏳ Shows ![Uploading...]() placeholder during upload
• 🔗 Converts to markdown image link upon successful upload
• ☁️ Multiple storage providers: Firebase Storage, Google Cloud Storage, and S3-compatible storage
• 🔄 Auto-authentication via gcloud CLI (no manual token refresh!)
• 🌐 CDN URL support for faster image delivery
• 📴 Falls back to default paste behavior when offline

Setup

Option 1: Firebase Storage

1. Create a project in Firebase Console
2. Enable Storage service
3. Get your bucket URL (e.g., gs://your-bucket.appspot.com)
4. In Pasterly settings:
   • Storage Provider: Firebase Storage
   • Firebase Storage Bucket URL: Your bucket URL

Important: Ensure WRITE permission is enabled in your Firebase bucket rules.

Option 2: Google Cloud Storage (Recommended)

Prerequisites

1. Install Google Cloud SDK
2. Authenticate with your Google account:

   gcloud auth login
   

3. Verify authentication works:

   gcloud auth print-access-token
   

Configure CORS (Required)

# Create cors.json
cat > cors.json << 'EOF'
[
  {
    "origin": ["*"],
    "method": ["PUT", "POST", "GET"],
    "responseHeader": ["Content-Type"],
    "maxAgeSeconds": 3600
  }
]
EOF

# Apply CORS configuration
gcloud storage buckets update gs://YOUR-BUCKET-NAME --cors-file=cors.json

Plugin Settings

Authentication Methods

Method 1: Auto-authentication via gcloud CLI (Recommended)

• Enable "Use gcloud CLI for authentication" toggle
• Plugin will automatically run gcloud auth print-access-token on each upload
• No manual token refresh needed!

Method 2: Manual Access Token

• Disable the gcloud CLI toggle
• Paste access token from: gcloud auth print-access-token
• ⚠️ Token expires after ~1 hour, requires manual refresh

Option 3: S3-compatible Storage (AWS S3 / Cloudflare R2)

Use this option for AWS S3 and providers exposing an S3-compatible API.

Plugin Settings

Notes

• Buckets must allow uploads from your credentials.
• Markdown links should point to a public URL. For R2, set Public Base URL to your r2.dev domain or custom domain.
• If your provider requires path-style URLs, enable Use path-style URLs.

How to Use

1. Copy an image to clipboard (screenshot or image file)
2. Paste into Obsidian editor (Cmd+V / Ctrl+V)
3. Image will be automatically uploaded and converted to a markdown link
4. When offline, images will be pasted using Obsidian's default behavior

Troubleshooting

"gcloud: command not found"

The plugin automatically searches for gcloud in common paths:

• /opt/homebrew/bin/gcloud (macOS Apple Silicon)
• /usr/local/bin/gcloud (macOS Intel)
• /usr/bin/gcloud (Linux)

If gcloud is installed elsewhere, check your installation path with:

which gcloud

"Failed to upload to GCS"

• Verify bucket permissions allow writes
• Ensure CORS is configured correctly
• Check that gcloud auth login was successful

"Failed to upload to S3-compatible storage"

• Verify access key, secret key, and optional session token are correct
• Confirm the bucket exists in the configured region
• If using R2 or another S3-compatible provider, verify the endpoint is correct
• Set a valid Public Base URL if your object URLs are not publicly accessible by default

Credits

• Built using the Obsidian Plugin Template
• Uses Firebase SDK under Apache License 2.0

License

Copyright 2025 easternkite

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.