Joplin Shared Attachments Plugin

This plugin automatically moves file attachments to a shared network folder (or any local folder) and updates the links in your notes to point to that shared location. This is useful for teams sharing a notebook where everyone has access to the same network drive.

Features

• Automatic Interception: Detects when you attach a file to a note.
• Shared Storage: Copies the file to a configured Shared Path.
• Link Update: Replaces the internal (:/resource_id) link with a file:// link to the shared location.
• Subfolders: Optionally organizes files into YYYY/MM folders.
• Conflict Handling: Renames files if a file with the same name already exists.

Installation

Development / Testing

1. Open Joplin.
2. Go to Tools > Options > Plugins (Windows/Linux) or Joplin > Settings > Plugins (macOS).
3. Click Manage your plugins.
4. Check Enable development plugins.
5. Click Load unpacked plugin and select the dist folder in this project.

Production

To create a .jpl file for distribution:

1. Run npm run dist.
2. Zip the contents of the dist folder into a file named joplin-shared-attachments.jpl.
3. Install via Install from file.

Configuration

After installation:

1. Go to Tools > Options > Shared Attachments.
2. Shared Folder Path: Enter the path where attachments should be stored.
   • Windows UNC: \\Server\Share\Attachments
   • Local: C:\Users\Public\Documents
   • macOS/Linux: /mnt/server/attachments
3. Use Subfolders: Check to organize by date (default: true).

Development

Building

1. Install Dependencies:

   npm install

2. Build:

   npm run dist

   This creates a .jpl file in the publish directory (or dist depending on config).

Architecture

• src/index.ts: Entry point. Listens for onNoteChange, scans for resource links, extracts files, and updates links.
• src/utils/files.ts: Handles file system operations (copying, ensuring directories, generated file URLs).