Bluniversal Comments is a Chrome Extension enabling "universal comments" via Bluesky, directly on web pages. With this extension, you can view, comment, and engage with Bluesky discussions linked to any web page.
Download the Extension via the Chrome Web Store.
First, visit the Releases page on the GitHub repository.
Then, depending on your browser:
Download the latest chrome-extension.zip
file for the extension.
Download the latest firefox-extension.zip
file for the extension.
Download the latest edge-extension.zip
file for the extension.
- Unpackage the
.zip
file to a directory on your computer. - Open Chrome and navigate to
chrome://extensions/
. - Enable Developer mode using the toggle switch in the top right corner of the page.
- Click the Load unpacked button.
- Select the directory where you unpackaged the
.zip
file.
- Download the
.zip
file to a directory on your computer, but don't unpackage it. - Open Firefox and navigate to
about:debugging#/runtime/this-firefox
. - Click the Load Temporary Add-On button.
- Select the directory containing the
.zip
file.
- Click the Extensions icon
- Find the Extension in the list
- Click the pin (📌) icon next to it
- Click the Extensions icon
- Find the Extension in the list
- Click the cog (⚙️) icon next to it
- Click "Pin to toolbar"
- Open any supported webpage.
- Click the Bluniversal Comments extension icon in the browser toolbar.
- Log in to your Bluesky account using your username and app password – A new tab should open automatically, but if not:
Navigate to the Options page (accessible by right-clicking on the extension icon and then Options).
In the Temporary Extension page, click the three dots (...) icon next to the Bluniversal Comments Extension, and then click Preferences.
- Once logged in, go to any web page and interact with existing Bluesky discussions or start a new thread for the page you're viewing.
Bluniversal Comments is distributed under the Server Side Public License (SSPL). This Source-Available license ensures that:
- You are free to view, modify, and use the source code for your purposes.
- If you use this code to provide a public-facing service, you are required to release your service's source code under the same license terms.
- The license protects the project against proprietary usage while encouraging collaborative improvement.
For more details, read the full SSPL License.
- Bluesky Thread Integration: Connect Bluesky discussions with any webpage.
- Comment Interaction: Post, reply to, and like Bluesky threads directly from the extension.
- Developer Mode Support: Easily test features using developer credentials during local development.
- Intelligent Post Creation: Automatically detects if a thread exists for a page, or creates one if necessary.
- Secure Authentication: Safeguards your Bluesky credentials with robust session handling.
- Node.js (version >=16)
- SST for Lambda function deployment
- A valid Bluesky account with app password credentials
-
Clone the repository:
git clone https://github.com/joneslloyd/bluniversal-comments.git cd bluniversal-comments
-
Install dependencies:
npm install
-
Start the development server:
npm run dev
-
Load the unpacked extension from the
packages/wxt/dist
directory in Chrome (chrome://extensions/
).
We welcome contributions to Bluniversal Comments! To contribute:
- Fork the repository and create a new branch.
- Make your changes and write tests.
- Submit a pull request with a clear description of the changes and their purpose.
- Ensure you’ve entered valid Bluesky credentials in the Options page.
- If using Developer Mode, ensure your
WXT_BS_DEV_USERNAME
andWXT_BS_DEV_PASSWORD
environment variables are correctly set.
- Check your Bluesky login status and ensure the webpage supports Bluniversal Comments.
- If the issue persists, consult the logs in Chrome's developer console for detailed error messages.
For further assistance, please open an issue in the GitHub Issues page.
This is inspired by the work of the following Bluesky users: