# 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.

---

Paste or drop any media file into Obsidian and it gets uploaded to your
self-hosted [Copyparty](https://github.com/9001/copyparty) server automatically.
The file never touches your vault — only the embed is inserted.

## Demo
<img width="781" height="277" alt="record-2026-05-26_02-28-51" src="https://github.com/user-attachments/assets/144ca944-98f8-4b39-8036-c4c90de6717b" />




## What it does

| Action | Result |
|---|---|
| Paste image from clipboard | Uploads → `![filename](url?raw)` |
| Paste/drop video | Uploads → `<video src="url?raw" controls>` |
| Paste/drop audio | Uploads → `<audio src="url?raw" controls>` |
| Paste/drop PDF | Uploads → `![filename](url?raw)` |
| Drop any other file | Uploads → `[filename](url?raw)` |
| Run "Migrate local attachments" command | Uploads existing local files **in currently viewed note** and rewrites links |

## 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](https://github.com/r3quisitevariety/copyparty-obsidian/releases), ensuring you have downloaded `main.js` & `manifest.json`.

### 2. Install

Copy the files into your vault's plugin folder:

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

# this is what the directory should look like
.obsidian/plugins/copyparty-uploader/
  main.js
  manifest.json
```

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

```bash
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:

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

# this is what the directory should look like
.obsidian/plugins/copyparty-uploader/
  main.js
  manifest.json
```

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://your-ip-here: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:

```ini
[/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 option in your global config to allow copyparty to properly communicate with obsidian:

```ini
[global]
allow-csrf
```

Note that this plugin has been tested on a LAN + tailscale setup. The ``allow-csrf`` option is **unsafe** on the public internet, and the author advises against using it in general. A more secure setup would involve a reverse proxy configuration, but I have not tested that yet. 

## Migrate existing local attachments

Run the command palette → **Copyparty: Upload all local attachments in this note**
to retroactively move any `![[local-file.png]]` or `![](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.