Copyparty Uploader

Copyparty Uploader — Obsidian Plugin

[!WARNING] Back up your vault before using this plugin. By default, it uploads attachments to Copyparty based on your current Obsidian attachment settings, and it may remove the local files from your vault without rewriting the links in your notes.

If you want to migrate gradually, use the migration command to upload and rewrite attachments note by note.

To test the plugin safely before fully committing, temporarily change Settings → Files & Links → Default location for new attachments to a separate folder and try it there first.

This plugin currently does not support obsidian canvas.

---

Paste or drop any media file into Obsidian and it gets uploaded to your self-hosted Copyparty server automatically. The file never touches your vault — only the embed is inserted.

Demo

What it does

Installation

If you have downloaded the plugin through the community plugins tab, skip the installation section and head over towards Configuration.

1. Download Release on Github

Download the latest release, and extract the .zip archive containing main.js & manifest.json (additionally styles.css if it exists).

2. Install

Copy the files into your vault's plugin folder:

# make the directory "copyparty-uploader" under .obsidian/plugins if it doesnt exist
cp main.js manifest.json styles.css ~/path/to/vault/.obsidian/plugins/copyparty-uploader

# this is what the directory should look like
.obsidian/plugins/copyparty-uploader/
  main.js
  manifest.json
  styles.css   #(not needed, skip if absent)

If you are on windows, drag the files to the plugins directory under your vault, ensuring you have made a folder called "copyparty-uploader".

Then enable the plugin in Obsidian → Settings → Community Plugins. (Should be called "Copyparty Uploader")

Development

Installation steps for development. Follow steps above instead if you just want to use the plugin without developing it.

1. Build

git clone https://github.com/r3quisitevariety/copyparty-obsidian.git
cd copyparty-obsidian
npm install
npm run build

2. Install

Copy the output files into your vault's plugin folder:

# make the directory "copyparty-uploader" under .obsidian/plugins if it doesnt exist
cp main.js manifest.json styles.css ~/path/to/vault/.obsidian/plugins/copyparty-uploader

# this is what the directory should look like
.obsidian/plugins/copyparty-uploader/
  main.js
  manifest.json
  styles.css   #(not needed, skip if absent)

Then enable the plugin in Obsidian → Settings → Community Plugins. (Should be called "Copyparty Uploader")

Configuration

1. Configure

Go to Settings → Copyparty Uploader:

• Server URL: http://inspiron:3923 (no trailing slash)
• Upload path: /obsidian-uploads or wherever you want files to land
• Username / Password: leave blank if your upload path has w: * (world-writable)

Hit Test to confirm connectivity.

2. Copyparty config

Make your upload directory world-writable so no credentials are needed:

[/obsidian-uploads]
/path/to/obsidian-uploads
accs:
  rwda: you
  rw: *        ← world read+write, no password

Or keep it write-only from outside and enter your credentials in plugin settings.

Also ensure you have the following options in your global config to allow copyparty to properly communicate with obsidian:

[global]
acao: *
acam: GET, HEAD, PUT, POST, DELETE, OPTIONS
allow-csrf

Note that this plugin has been tested on a LAN + tailscale setup, meaning it can be potentially unsafe to add these options if your copyparty setup exists on the public internet.

Migrate existing local attachments

Run the command palette → Copyparty: Upload all local attachments in this note to retroactively move any ![[local-file.png]] or ![](https://raw.githubusercontent.com/r3quisitevariety/copyparty-obsidian/HEAD/relative/path.mp4) references out of your vault and onto the server.

Notes

• Filenames are sanitized with timestamps + original filename before upload.
• If upload fails, Obsidian's default paste behaviour is blocked for that file and an error notice is shown. The file is not saved locally as fallback — this is intentional for a thin-client setup.
• Auth credentials are stored in .obsidian/plugins/copyparty-uploader/data.json (plain text). Fine for a local homelab, not for anything public-facing.

Roadmap

• Wrap the project in nix for funsies :3
• add canvas support