Bambloo is a super easy web extension that lets you share what you're up to in your browser with your friends on Discord. It is straightforward, configurable and pretty 🫐
- Straightforward
- Simple
- User friendly
- Non hidden complexity
- Configurable
Warning
We are just starting, so there might not be many websites supports and bugs might occur.
If any bug occur please create an issue and we'll reply as soon as possible to fix it.
While the extension is not available on the Chrome Store you can install it manually.
In the Releases tab you'll find the versions with their changelog and files.
Under the Assets drop-down are the files, you can choose whether you prefer
a zip file or a tarball. Download the one with the name "bambloo-extension".
If you prefer, you can build yourself by cloning this repo and running bin run build.
After downloading extract the file and follow the next steps accordingly to your browser:
Google Chrome
-
Inside your browser, type
chrome://extensionsin your searchbar or, click on the 3-dot button in the upper right corner, hover over the "Extensions" option and click on "Manage Extensions" -
In the upper right corner enable
Developer mode -
Click on the "Load unpacked" button in the upper left corner
-
Search for and select the folder you extracted
Firefox
-
Inside your browser, type
about:debugging#/runtime/this-firefoxin the searchbar -
Click on the "Load Temporary Add-on..." button under the "Temporary Extensions" drop-down
-
Search for and select the
manifest.jsonfile inside the folder you extracted
The extension alone is not enough, it needs a way to talk to Discord.
The way we found is having a program (a host) running on your system next to Discord.
We have a variety of hosts, you can choose the one you feel most comfortable with.
Hosts differ by connection method, but don't worry about this unless you're a developer,
and programming language, you might prefer a Python host, or maybe a binary one?
Connection methods:
-
Ideal if you work with web development or networks and need all possible ports available.
-
WebSocket
✨ Recommended for Bambloo debugging
The difference from a Native Messaging host is that you'll have to run this host
on your terminal whenever you want to use Bambloo.
Hosts system support table
| Language | Connection Method | Supported systems |
|---|---|---|
| Python | WebSocket | Linux Windows |
| Python | NativeMessaging | Linux Windows |
That being said let's install a host!
In the Releases tab you'll also find files named "<method>-hosts". Download and extract one,
and if you chose a WebSocket host you can just run the file called ws-bambloo, otherwise:
In the extracted folder there's a file called install.sh for Linux, and install.cmd for Windows.
If you prefer a TUI installer, there's the init.cmd file inside win32-tui for Windows.
To install the host run this file with the arguments:
--browser <browser name>--id <extension ID>- (optional)
--dist <host installation folder> - (optional)
--lang <host programming language>
The "Extension ID" is found in the page you loaded the extension into your browser.
If your browser is not supported by this file, join our Discord server and
our professionals will help you and add oficial support to your browser.
If you are a developer please refer to the Developer Docs for a more detailed explanation.
The extension's service worker manages all the data and events of the extension,
when you install a Presence through the Store tab you are getting a manifest file
from the repositories you have configured (default: https://github.com/pandasoli/bambloo-repo),
and this manifest file contains the path inside the repository where lies a script,
which that run on the tab it was made to run and collects information about the page,
which later is sent to the service worker, then to the host and then to Discord.