Bluesky

Bluesky Plugin

• Post to Bluesky via a Tab view or by highlighting text

Usage Guide

Initial Setup

• Open the Bluesky plugin in the Obsidian settings.
• Enter your Bluesky handle (e.g. evanharris.bsky.social).
• Enter a Bluesky App Password - Note: Please do not enter your Bluesky password here.
  • If you do not have an App Password, you can create one by going to the App Passwords page and creating a new App Password.

How to Post

A new megaphone icon will appear in the left sidebar after you install the plugin.

• To compose a post or a thread:
  • Click the megaphone icon to open a Bluesky tab.
  • Write your post or thread.
  • Click "Post" to post to Bluesky.
• If you prefer to use the command palette, you can run the Open Bluesky tab command.

Testing

npm run test:e2e

Runs provider-free UI smoke tests against a real, sandboxed Obsidian instance via wdio-obsidian-service — no Bluesky credentials, no network calls, no contact with your real vault. See test/README.md for details.

[!WARNING] When touching the test config, never point plugins: in wdio.conf.mts at the repo root ("."). wdio-obsidian-service copies data.json — which holds your real Bluesky app password — from the plugin directory into every test vault. Always go through the staged copy in test/plugin-dist/ (scripts/stage-plugin.mjs).

Say Hi

• Bluesky

Roadmap

• Media
• Embeds
• Posting threads from within a file
• Language specification

Attribution

This project builds upon the Bluesky AT Protocol, which is licensed under the MIT License.

The source code of this project includes parts of the Bluesky AT Protocol, following the MIT License requirements.