MetaWeblog-to-Bluesky Bridge

🚀 Quick Setup Guide

Step 1: Get Your Bluesky App Password

Go to Bluesky Settings > Privacy and Security > App Passwords and create a new app password for this bridge service.

⚠️ Important: Use an app password, not your main Bluesky password!

Step 2: Configure Your Blog Editor

Add a new blog account in your MetaWeblog-compatible editor with these settings:

XML-RPC Endpoint: http://weblog.social/xmlrpc
Blog ID: 1 (any value works)
Username: Your Bluesky handle (e.g., username.bsky.social)
Password: Your Bluesky app password

💡 Post Format: Use a custom field to control post format:

Custom Field: lexicon = whitewind - Creates Whitewind blog entries
Custom Field: lexicon = blog - Standard Bluesky posts (auto-threaded)
No custom field - Default Bluesky posts

In MarsEdit: Blog Settings > Custom Fields > Add "lexicon"

Step 3: Start Publishing!

Create and publish posts from your editor - they'll appear on Bluesky automatically! Long posts are split into threads, and you can retrieve previously published posts.

📖 Supported Methods

metaWeblog.newPost - Create new posts (✅ Fully supported)
metaWeblog.getPost - Retrieve individual posts (✅ Fully supported)
blogger.getUsersBlogs - Get blog information (✅ Supported)
blogger.getUserInfo - Get user information (✅ Supported)
metaWeblog.editPost - Edit existing posts (❌ Not supported by AT Protocol)
metaWeblog.getRecentPosts - Get recent posts (🔄 Coming soon)

🎯 Popular Blog Editors

MarsEdit (Mac)

Premium blog editor with excellent MetaWeblog support

Open Live Writer

Free, open-source editor for Windows

BlogDesk

Lightweight Windows blog editor

🔧 Advanced Features

Custom Field Support: Use lexicon custom field to control post format
Multiple Lexicons: Support for Bluesky posts and Whitewind blog entries
Thread Creation: Long posts automatically split into Twitter-style threads
Full Content Support: Whitewind entries support long-form content without truncation
Error Handling: Detailed error messages for troubleshooting
Authentication: Secure app password authentication

📝 Supported Post Types

Standard Bluesky Posts

Default format, 280 chars, auto-threaded for longer content

lexicon = blog (or no custom field)

Whitewind Blog Entries

Long-form blog posts with titles, subtitles, and full content

lexicon = whitewind

🔒 Privacy Note: This bridge service processes your credentials locally and communicates directly with Bluesky. Your app password is never stored or logged.

🌉 MetaWeblog ↔ Bluesky Bridge

📝 Blog Editors

🦋 Bluesky Integration

� Multiple Formats