Clipsidian


A Chrome extension that makes information gathering easier for Obsidian users. With a simple highlight and click, capture vital web content and send it directly to your Obsidian vault with one of many customizable clipping actions.

Transform your web-browsing into a streamlined research tool.

Key Features

Installation

For manual installation please follow these steps:

  1. Clone or download the Clipsidian GitHub repository to your local machine.
  2. In your browser, open your extensions manager.
  3. Enable Developer mode by clicking the toggle switch in the upper-right corner.
  4. Click on Load unpacked and navigate to the directory where you have downloaded or cloned the Clipsidian repository.
  5. Select the folder and click Open to install the extension.
  6. Please note, extensions installed in Developer mode will not receive updates automatically. You'll need to manually pull new updates from the GitHub repository and reload the extension in your Chrome browser.

How to Use

Clipsidian Usage Example
  1. Configure your actions: Open the Clipsidian extension options in your Chrome browser and set up your clipping actions.
  2. Highlight the content: In your web browser, select the content you want to add to your Obsidian vault.
  3. Access the context menu: Right-click on the highlighted content.
  4. Select the relevant action: From the context menu, select a clipping action. The "Clipping to Obsidian..." tab should open.
    Clipsidian Usage Example
  5. Allow Clipsidian to open Obsidian: If it's the first time you're using Clipsidian, read below on how to authorize it to open your Obsidian. After that your note should be saved in Obsidian!
  6. The clipping is saved!: Obsidian should open as a sign it received your clipping, and after that your clipping should be saved!

First Time Authorization (Obsidian URI)

Clipsidian Usage Example

For first-time users, you will need to authorize Clipsidian to open Obsidian URI links.
This authorization is necessary due to how the browser handles Obsidian URI requests. Without this step, the browser would require you to authorize each individual page from which you want to clip content, which can be inconvenient and time-consuming.

By authorizing the page at Clipsidian's Github Pages (readable version), you enable it to handle all subsequent clips, thus avoiding repeated authorization requests. This authorization only happens once, streamlining your clipping process. When handling subsequent clips, any data (like the content to be clipped) that's passed as URL parameters to that page is not sent to a server but is instead handled entirely within your browser.

Configuring Clipping Actions

Configuration options for clipping actions

Effortlessly save and organize your digital snippets with our easy-to-use Clipping Actions feature! Tailor your clipping process to suit your needs using customizable options and dynamic template strings.

Take full control of date and time strings with formatting options and language settings. Learn more about Configuring Clipping Actions here.

Data Safety

Your data is secure and is only processed within your browser. Clipsidian doesn't send, track, or store any of your details. If you still have any doubts, you or someone you trust could always take a look at the code (it's open source!), just to make sure everything's clear. As an open-source project, Clipsidian is built on full transparency.

Contributing

We welcome contributions to Clipsidian!

If you like the project and want to contribute, you can support me on Patreon or Ko-fi.

For any issues, feature requests, or questions, please open an issue on GitHub.

Clipsidian Icon