Home

Awesome

SilverBullet Clipper - A web clipper for SilverBullet

GitHub Release

SilverBullet by Zef Hemel is an awesome note-taking application optimized for people with a hacker mindset.

SilverBullet Clipper is a browser extension that allows you to save either a URL or selected content from a page as markdown to SilverBullet. By default, the capture is added as a Quick Note in the default SilverBullet inbox. Please keep in mind that it is not guaranteed to work on all websites.

To use this add-on, simply click the extension icon while you are browsing the page you want to capture. If you've highlighted content on the page, the highlighted content will be saved to SilverBullet. If no content is highlighted, just the page URL will be saved to SilverBullet. A popup will allow you to change the page title from the default timestamp and add any tags that you want to the page.

Installation

The extension is available for Google Chrome and Opera via the Chrome Web Store. The Firefox extension is available for both the Firefox Desktop and Firefox for Android. It can be added from Firefox Browser Add-Ons

Mozilla Add-on Version

Usage

1. The Capture Page

Capture Page

  1. The title of the page as it will appear in SilverBullet. This mimics the title of a page created by the SilverBullet "Quick Note" button.
  2. When the Append Page Title is selected, the web page title will be added to the title entered in (1.1). This is defaulted to off but can be defaulted to on via the configure page (2.4). The page title will be enclosed in brackets. Eg 18-19-21 (The Age Newspaper).
  3. Multiple tags, separated by spaces, can be added to the page. The tags can be entered with or without a leading hash. For example, this is a valid entry: tag1 tag2 #tag3
  4. When the Save Page Metadata as Frontmatter is selected, the page metadata is saved as frontmatter. This includes the tags. eg
---
source-title: 17-31-32 (UK elections- Celebrations will be short-liv...)
source-url: https://www.theage.com.au/world/europe/celebrations-will-be-short-lived-for-starmer-staring-down-britain-s-monumental-challenges-20240705-p5jra2.html
created-date: 2024-07-05
tags:
- uk
- election
---

2. The Configure Page

Capture Page

  1. The host URL points to the instance of your SilverBullet installation. If you're running SilverBullet locally the URL will be something like http://192.168.86.54:3000. If you are running SilverBullet externally, or accessing it via a proxy, the host URL will be something like https://silverbullet.mydomain.com

  2. The token will be whatever token you specified in the SB_AUTH_TOKEN environment variable.

    Command Line Example

    SB_USER=admin:mypassword SB_AUTH_TOKEN=mysuperlongtoken SB_HOSTNAME=0.0.0.0 /root/.deno/bin/silverbullet /root/Silverbullet/space

    Docker Compose Example

    services:
    silverbullet:
        image: zefhemel/silverbullet
        restart: unless-stopped
        environment:
        - SB_AUTH_TOKEN=mysuperlongtoken
        - SB_USER=admin:mypassword
        volumes:
        - ./space:/space
        ports:
        - 3000:3000

  3. The directory is where your page will be created in SilverBullet. The default directory is Inbox as this is the directory that the SilverBullet Quick Note uses.

  4. When the Append Page Title is selected, the Append Page Title check box on the Capture page (1.2) will default to selected.

  5. When the Save Page Metadata as Frontmatter is selected, the Save Page Metadata as Frontmatter is selected check box on the Capture page (1.4) will default to selected.

  6. The Max. Title Length determines how long the note's title will be. This is defaulted to 70 characters. If the note title exceeds this length, '...' will indicate that the title has been concatenated. Eg 2024-05-31 16:28:33 (The Age Newspaper Melbourne Aus...)

  7. The tags text box on the capture page will be automatically populated with the default tags defined here. Multiple tags, separated by spaces, can be added to the default tags. The tags can be entered with or without a leading hash. For example, this is a valid entry: tag1 tag2 #tag3

Build & Testing

Instructions to Build the Extensions with Grunt

The extension is already built and can be found in the dist/chrome and dist/firefox folders. If you want to rebuild them the follow these instuctions:

  1. Install Grunt via NPM
npm install -g grunt-cli
npm install grunt --save-dev
  1. Install the Grunt dependencies
npm install

3a. Build the Chrome extension. The files are built to the dist/chrome folder

grunt build:chrome

3b. Build the Firefox extension. The files are built to the dist/firefox folder

grunt build:firefox

Instructions to Test Extensions

  1. Clone this repo.

Chrome

The Chrome extension can be found in the dist/chrome folder

  1. In Chrome, enter chrome://extensions/ in the URL bar or navigate to Setup -> Extensions -> Manage Extensions
  2. At the top right, turn on Developer mode.
  3. Click Load unpacked.
  4. Navigate to the cloned repo and select the folder that has the manifest.json

Firefox

The Firefox extension can be found in the dist/firefox folder

  1. In firefox, enter about:debugging in the URL bar
  2. Select This Firefox
  3. Select Load Temporary Add-on...

Firefox for Android

The Firefox extension can be found in the dist/firefox folder. Detailed instructions for testing the extension on Firefox for Android can be found here

External Libraries

SilverBullet Clipper uses the following libraries:

Permissions

Version History

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.2

1.1.1

1.1.0

1.0.0

0.3.1

0.3.0

0.2.0

0.1.0