# 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:
   ```bash
   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
   - Don't have an App Password? Generate one at [Bluesky Settings](https://bsky.app/settings/app-passwords)
   - Don't have a Bluesky account? [Sign up here](https://bsky.app)

### 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](LICENSE) file for details.

## Credits

Semble is being built by [Cosmik Network](https://cosmik.network/). Get involved [here](https://cosmik.network/#connect).

Learn more about Cosmik Network and Semble [here](https://blog.cosmik.network/).

## Contributing

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