renderg.host
A Chrome extension to quickly capture URLs into Semble Collections at https://semble.so
semble.so
at-proto
semble
chrome-extension
1# Semble Quick Capture
2
3A Chrome extension for quickly capturing and organizing URLs into Semble Collections using your Bluesky account.
4
5> [!WARNING]
6> This extension currently only supports accounts hosted by **Bluesky**
7
8## About
9
10Save 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.
11
12## Features
13
14- **One-Click Capture**: Save the current tab's URL with a single click
15- **Bluesky Integration**: Secure authentication using Bluesky App Passwords
16- **Collection Management**: Choose from your existing Semble Collections
17- **Add Notes**: Include optional notes with your captured URLs
18- **Clean Interface**: Simple, intuitive design that stays out of your way
19
20## Installation
21
22### From Source
23
241. Clone this repository:
25 ```bash
26 git clone git@tangled.sh:renderg.host/semble-chrome-extension
27 cd semble-chrome-extension
28 ```
29
302. Open Chrome and navigate to `chrome://extensions/`
31
323. Enable "Developer mode" using the toggle in the top right corner
33
344. Click "Load unpacked" and select the extension directory
35
36### From Chrome Web Store
37
38`Coming soon!`
39
40## Usage
41
42### First Time Setup
43
441. Click the Semble extension icon in your browser toolbar
452. Sign in with your Bluesky handle and App Password
46 - Don't have an App Password? Generate one at [Bluesky Settings](https://bsky.app/settings/app-passwords)
47 - Don't have a Bluesky account? [Sign up here](https://bsky.app)
48
49### Capturing URLs
50
511. Navigate to any webpage you want to save
522. Click the Semble extension icon
533. The current URL will be automatically captured
544. (Optional) Add a note about why you're saving this page
555. Select a collection from the dropdown
566. Click "Add to Collection"
57
58### Sign Out
59
60Click the "Sign Out" button in the extension popup to securely log out of your account.
61
62## Development
63
64### Project Structure
65
66```
67semble-chrome-extension/
68├── background/ # Background service worker
69├── content/ # Content scripts
70├── icons/ # Extension icons
71├── lib/ # Shared libraries
72├── popup/ # Extension popup UI
73│ ├── popup.html
74│ ├── popup.js
75│ └── styles.css
76└── manifest.json # Extension manifest
77```
78
79### Building
80
81This extension uses vanilla JavaScript and doesn't require a build step. Simply load the unpacked extension in Chrome as described in the Installation section.
82
83### Permissions
84
85The extension requires the following permissions:
86- `activeTab`: To capture the current tab's URL
87- `storage`: To securely store authentication credentials
88- `scripting`: For future content script functionality
89- `host_permissions`: To communicate with web APIs
90
91## Privacy & Security
92
93- Your Bluesky credentials are stored locally using Chrome's secure storage API
94- The extension only accesses the URL of the current tab when you explicitly click the extension icon
95- No data is collected or shared with third parties
96
97## License
98
99This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
100
101## Credits
102
103Semble is being built by [Cosmik Network](https://cosmik.network/). Get involved [here](https://cosmik.network/#connect).
104
105Learn more about Cosmik Network and Semble [here](https://blog.cosmik.network/).
106
107## Contributing
108
109Contributions are welcome! Please feel free to submit a Pull Request.