treethought.xyz / obsidian-atmosphere
Various AT Protocol integrations with obsidian
fork atom
TypeScript 81.8%
CSS 15.0%
HTML 2.1%
JavaScript 1.1%
65 21 26

Clone this repository

https://tangled.org/treethought.xyz/obsidian-atmosphere https://tangled.org/did:plc:sppiplftd2sxt3hbw7htj3b5/obsidian-atmosphere
git@tangled.org:treethought.xyz/obsidian-atmosphere git@tangled.org:did:plc:sppiplftd2sxt3hbw7htj3b5/obsidian-atmosphere

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

obsidian-atmosphere#

Obsidian plugin for AT Protocol integrations, including bookmarking platforms and standard.site publishing.

Surf the atmosphere from the coziness of your vault.

Features#

Bookmarking & Knowledge Networks#

View and manage bookmarks from AT Protocol platforms:

  • Semble (network.cosmik.*) - Collections and cards with notes
  • Margin (at.margin.*) - Bookmarks with collections and tags
  • Kipclip and community bookmarks (community.lexicon.bookmarks.*) - Community bookmarks lexicon (supports kipclip tags)

Publishing & Reading#

  • Publish documents - Publish Obsidian notes to standard.site publications like leaflet.pub and pckt.blog
  • Blog feed - Browse and clip documents from subscribed standard.site publications to your vault

Installation#

Official release in Obsidian plugin directory is under review. For now, install with BRAT:

  1. Install the BRAT plugin from Community Plugins
  2. Open BRAT settings
  3. Click "Add Beta plugin"
  4. Enter: https://github.com/treethought/obsidian-atmosphere
  5. Enable the plugin in Community Plugins

Setup#

Authentication#

  1. Open Settings > Atmosphere
  2. Enter your AT Protocol handle (e.g., user.bsky.social)
  3. Create an app password at bsky.app/settings/app-passwords
  4. Enter the app password
  5. Save settings

Commands#

Command Description
Open bookmarks Opens the bookmarks view showing items from Semble, margin.at, and bookmarks lexicon
Publish document Publishes the active note to a standard.site publication

Access commands via the command palette (Ctrl/Cmd + P) or ribbon icons.

Settings#

Setting Description Default
Handle Your AT Protocol handle or DID (e.g., user.bsky.social) -
App password App password from bluesky settings -
Clip directory Directory in your vault where clipped documents are saved AtmosphereClips

Usage#

Browsing Bookmarks#

Switch between sources (Semble, Margin, Bookmarks) and filter by collections or tags. Supports adding cards to collections and creating collections collections, tags, and notes (for Semble).

Publishing Documents#

Open a note and run "Publish document" command. After selecting one of your existing standard.site publication, your note will be converted to the applicable format (for leaflet or pckt), published, and update your note's properties with publication url, AT uris, etc.

Reading & Clipping#

Opening the feed will present your standard.site publications. Click a publication to view it's published documents to either view in browser or clip to your vault.

Supported Rich Content Formats#

  • Leaflet - Rich blog posts with markdown support
  • Pckt - Lightweight blogging format

Network Use#

This plugin connects to AT Protocol services to fetch and manage your bookmarks.