renderg.host / semble-chrome-extension
A Chrome extension to quickly capture URLs into Semble Collections at https://semble.so semble.so
at-proto semble chrome-extension
fork atom
JavaScript 61.7%
CSS 27.9%
HTML 10.4%
2 2 0

Clone this repository

https://tangled.org/renderg.host/semble-chrome-extension
git@tangled.org:renderg.host/semble-chrome-extension

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

Download tar.gz
README.md

Semble Quick Capture#

A Chrome extension for quickly capturing and organizing URLs into Semble Collections using your Bluesky account.

WARNING

This extension currently only supports accounts hosted by Bluesky

About#

Save interesting web pages directly into your Semble Collections. Simply click the extension icon, add an optional note, select a collection, and save—all without leaving your current page.

Features#

  • One-Click Capture: Save the current tab's URL with a single click
  • Bluesky Integration: Secure authentication using Bluesky App Passwords
  • Collection Management: Choose from your existing Semble Collections
  • Add Notes: Include optional notes with your captured URLs
  • Clean Interface: Simple, intuitive design that stays out of your way

Installation#

From Source#

  1. Clone this repository:

    git clone git@tangled.sh:renderg.host/semble-chrome-extension
cd semble-chrome-extension

  2. Open Chrome and navigate to chrome://extensions/

  3. Enable "Developer mode" using the toggle in the top right corner

  4. Click "Load unpacked" and select the extension directory

From Chrome Web Store#

Coming soon!

Usage#

First Time Setup#

  1. Click the Semble extension icon in your browser toolbar
  2. Sign in with your Bluesky handle and App Password

Capturing URLs#

  1. Navigate to any webpage you want to save
  2. Click the Semble extension icon
  3. The current URL will be automatically captured
  4. (Optional) Add a note about why you're saving this page
  5. Select a collection from the dropdown
  6. Click "Add to Collection"

Sign Out#

Click the "Sign Out" button in the extension popup to securely log out of your account.

Development#

Project Structure#

semble-chrome-extension/
├── background/          # Background service worker
├── content/            # Content scripts
├── icons/              # Extension icons
├── lib/                # Shared libraries
├── popup/              # Extension popup UI
│   ├── popup.html
│   ├── popup.js
│   └── styles.css
└── manifest.json       # Extension manifest

Building#

This extension uses vanilla JavaScript and doesn't require a build step. Simply load the unpacked extension in Chrome as described in the Installation section.

Permissions#

The extension requires the following permissions:

  • activeTab: To capture the current tab's URL
  • storage: To securely store authentication credentials
  • scripting: For future content script functionality
  • host_permissions: To communicate with web APIs

Privacy & Security#

  • Your Bluesky credentials are stored locally using Chrome's secure storage API
  • The extension only accesses the URL of the current tab when you explicitly click the extension icon
  • No data is collected or shared with third parties

License#

This project is licensed under the MIT License - see the LICENSE file for details.

Credits#

Semble is being built by Cosmik Network. Get involved here.

Learn more about Cosmik Network and Semble here.

Contributing#

Contributions are welcome! Please feel free to submit a Pull Request.