Get Started

Follow the steps below to install and use the Pieces for Obsidian Plugin.


Obsidian Prerequisites

Before installation, you'll need:

PiecesOS must be installed to enable the Pieces for Obsidian Plugin. We also recommend the Pieces for Developers Desktop App for enhanced functionality.

Installing the Pieces for Obsidian Plugin

1

Settings

Open Obsidian and navigate to the Settings view

2

Community Plugins Tab

Locate and navigate to the Community Plugins option

Alternatively, find the Pieces for Obsidian Plugin on the Obsidian Plugin Marketplace and install it manually.

3

Community Plugins Option

Click Turn on community plugins

4

Browsing Plugins

Locate and click the Browse button in the Community Plugins section

5

Search for the Plugin

Click the search bar, then search for Pieces for Developers, and click the Pieces for Developers option

6

Install the Plugin

Click the Install button—After the plugin installs, click Enable.

Setting Up PiecesOS

To use the Pieces for Obsidian Plugin, you must install PiecesOS on your operating system.

Follow the specific setup steps below:

PiecesOS — Windows
PiecesOS — Windows

Windows 10 (20H0) or higher required

Download — Linux
Download — Linux

Ubuntu 22.04+ required.


Run these commands in order to install and properly set up the Pieces Desktop App and it’s core dependencies:

  1. sudo snap install pieces-os

  2. sudo snap connect pieces-os:process-control :process-control

Then, type pieces-os to launch the application directly from your terminal.

Click here for alternative PiecesOS installation methods, or install the PiecesOS and the Pieces Desktop App together for Windows, macOS, and Linux.

For enhanced security and better system integration, we recommend installing the .appinstaller package over the .exe installer. The .appinstaller package operates in a containerized environment, providing additional security benefits.

Updating

To update the Pieces for Obsidian plugin will require a few extra steps to update.

1

Settings

In the bottom left of the editor, select the settings option.

2

Community Plugins Tab

Locate the tab called Community Plugins and select it.

3

Current Plugins Section

In the new window, located the section labeled Current Plugins and click the Check for Updates button.

Uninstalling

1

Settings

In the bottom left of the editor, select the settings option.

2

Community Plugins Tab

Locate the tab called Community Plugins and select it.

3

Installed Plugins Section

On the bottom of the Community Plugins window, locate the section called Installed Plugins.

4

Pieces for Developers Plugin.

Locate the installed Pieces for Developers plugin and click the trash icon to uninstall the plugin

Restart your Obsidian editor after removing the plugin to complete the uninstallation process.

Updated on