···11-# ATmark
11+# Atmosphere
2233-Obsidian plugin for AT Protocol bookmarking platforms.
33+Obsidian plugin for AT Protocol integrations, including bookmarking platforms and standard.site publishing.
4455+Surf the atmosphere from the coziness of your vault.
5666-## Supported platforms
77+
88+
7988-- **Semble** (`network.cosmik.*`) - Collections and cards
99-- **Bookmarks** (`community.lexicon.bookmarks.*`) - Community bookmarks lexicon with tag filtering (supports kipclip tags)
1010-- **margin.at** (`at.margin.*`) - Bookmarks with collections and tags support
1010+## Features
11111212-
1313-
1212+### Bookmarking & Knowledge Networks
1313+1414+View and manage bookmarks from AT Protocol platforms:
1515+1616+- **Semble** (`network.cosmik.*`) - Collections and cards with notes
1717+- **margin.at** (`at.margin.*`) - Bookmarks with collections and tags
1818+- **Bookmarks** (`community.lexicon.bookmarks.*`) - Community bookmarks lexicon (supports kipclip tags)
1919+2020+### Publishing & Reading
2121+2222+- **Publish documents** - Publish Obsidian notes to standard.site publications like [leaflet.pub](https://leaflet.pub) and [pckt.blog](https://pckt.blog)
2323+- **Blog feed** - Browse and clip documents from subscribed standard.site publications to your vault
2424+14251526## Installation
16271717-Install via [BRAT](https://github.com/TfTHacker/obsidian42-brat):
2828+Official release in Obsidian plugin directory is under review. For now, install with BRAT:
18291919-1. Install the BRAT plugin from Community Plugins
3030+1. Install the [BRAT plugin](https://github.com/TfTHacker/obsidian42-brat) from Community Plugins
20312. Open BRAT settings
21323. Click "Add Beta plugin"
2222-4. Enter the GitHub URL: `https://github.com/treethought/obsidian-atmark`
3333+4. Enter: `https://github.com/treethought/obsidian-atmosphere`
23345. Enable the plugin in Community Plugins
24352525-## Getting Started
3636+## Setup
26372738### Authentication
28392929-1. Open Settings > ATmark
3030-2. Enter your AT Protocol handle or DID
3131-3. Create an app password in your AT Protocol client (Bluesky: Settings > Privacy and security > App passwords)
3232-4. Enter the app password in the plugin settings
4040+1. Open Settings > Atmosphere
4141+2. Enter your AT Protocol handle (e.g., `user.bsky.social`)
4242+3. Create an app password at [bsky.app/settings/app-passwords](https://bsky.app/settings/app-passwords)
4343+4. Enter the app password
33445. Save settings
34453535-The plugin will automatically connect using your credentials.
4646+## Commands
36473737-### Opening the View
4848+| Command | Description |
4949+|---------|-------------|
5050+| **Open bookmarks** | Opens the bookmarks view showing items from Semble, margin.at, and bookmarks lexicon |
5151+| **Publish document** | Publishes the active note to a standard.site publication |
38523939-Open the command palette (Ctrl/Cmd + P) and search for "ATmark: Open view". The view will show your bookmarks from all supported platforms.
5353+Access commands via the command palette (Ctrl/Cmd + P) or ribbon icons.
5454+5555+## Settings
5656+5757+| Setting | Description | Default |
5858+|---------|-------------|---------|
5959+| **Handle** | Your AT Protocol handle or DID (e.g., `user.bsky.social`) | - |
6060+| **App password** | App password created in your AT Protocol client | - |
6161+| **Clip directory** | Directory in your vault where clipped documents are saved | `AtmosphereClips` |
6262+6363+## Usage
6464+6565+### Browsing Bookmarks
6666+6767+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).
6868+6969+### Publishing Documents
7070+7171+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) and update your note's properties with publication url, AT uris, etc.
7272+7373+### Reading & Clipping
7474+7575+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.
7676+7777+## Supported Rich Content Formats
7878+7979+- **Leaflet** - Rich blog posts with markdown support
8080+- **Pckt** - Lightweight blogging format
8181+40824183## Network Use
4284