Name: Attachment Uploader – Obsidian Plugin · Obsidian Stats
Rating: 50 (15 reviews)
Author: zhuxining

by zhuxining

Score: 50/100

Install Code

Description

Category: File Management

#attachment-management #auto-upload #cloud-storage #shell-command #attachment

The attachment uploader plugin uploads local attachments to cloud storage by running a user defined shell command and replacing the local file with the returned network URL. It can be configured to handle only selected attachment formats, delete the original local file after a successful upload and trigger automatically when content is pasted or dragged in from outside the app. The plugin includes ready made command patterns for tools like uPic and Picsee, but it also works with a custom script as long as the command prints the uploaded file URL in its output. That keeps the workflow flexible while leaving storage choice and upload logic under your control instead of locking it to one service.

Reviews

No reviews yet.

Stats

stars

2,782

downloads

forks

days

total PRs

open PRs

closed PRs

merged PRs

total issues

open issues

closed issues

commits

RequirementsExperimental

An external image hosting or cloud upload tool with a shell command that returns the uploaded file URL

Latest Version

1.2.1

13 days ago

Changelog

See all version on GitHub

README file from

Github

obsidian-attachment-uploader

This Obsidian plugin helps you upload local attachments to cloud storage. You can customize the upload shell command and specify which attachment formats to upload.

中文文档

Features

Custom shell command for uploading
- Built-in uPic upload command: /Applications/uPic.app/Contents/MacOS/uPic -o url -u %s
- Built-in Picsee upload command: "/Applications/Picsee.app/Contents/MacOS/Picsee -u %s"
Customizable attachment formats to upload
Option to delete original attachments after upload
Automatic upload when pasting or dragging from outside Obsidian

Installation

In Obsidian, open the plugin manager
Search for "obsidian-attachment-uploader"
Click "Install", then enable and configure after installation

Configuration

Install an image hosting tool (with shell upload command) or create a custom shell upload command
Configure the Obsidian attachment uploader plugin:
- Upload Command: Configure the shell command for uploading attachments
- Attachment Formats to Upload: Configure which attachment formats to upload (separated by line breaks)
- Delete Original After Upload: Configure whether to delete original attachments after upload
Custom command examples:
- uPic shell execution command: /Applications/uPic.app/Contents/MacOS/uPic -o url -u /local.png
- Shell output format:
```
Uploading ...
Uploading 1/1
Output URL:
https://r-w.oss-cn-shanghai.aliyuncs.com/uPic/Snipaste_2024-08-18_22-14-14.png?x-oss-process=image/auto-orient,1/quality,q_80/format,webp
```
- This plugin uses %s to replace the local image path and extracts the image URL from shell output using urlMatch = stdout.match(/\s+(https?:\/\/\S+)/)
- Therefore, the uPic command should be: /Applications/uPic.app/Contents/MacOS/uPic -o url -u %s
- If writing your own upload script, make sure to print the uploaded image's network URL in the shell output

Usage

Open a note containing attachments in Obsidian
Press command+p to open the command palette and type Upload editor attachments, or use the Ribbon button