Pastepic

One plugin. Every screen.
Pastepic brings the same automatic image-upload workflow to Obsidian on desktop, tablet, and mobile.

Install in Obsidian · 3-minute setup · CDN path · 简体中文 · English

36-second real demo

Paste an image once; Pastepic uploads it, replaces the placeholder with a standard remote Markdown image link, and keeps the note usable if an upload fails. The desktop segment above is a real capture from Obsidian 1.12.7 using the published plugin workflow. Watch the sharper 1080p MP4.

The tablet and phone cards describe verified compatibility paths—not simulated device footage. Mobile support is backed by the same browser-safe uploader code, clipboardData.items fallback tests, isDesktopOnly: false, and an Obsidian 1.12.4 minimum version. Real device clips can be added separately without presenting a mockup as proof.

Why Pastepic?

Screenshots, web images, and design exports can make an Obsidian vault grow quickly. Manually opening an image host, uploading, copying a URL, and returning to the note also breaks the writing flow.

Pastepic does one thing well: it catches an image that is pasted, dropped, or newly inserted as a local Obsidian link, uploads it, and puts the remote Markdown image link back in the same place. Every upload gets a unique placeholder. A failed upload restores the local image link instead of leaving a broken error link.

Desktop, tablet, or phone—the workflow stays the same. Configure Pastepic once in your synced vault and keep the same GitHub or image-host destination, CDN path, and paste-to-upload experience on every screen.

Features

Installation

Install from the Obsidian community directory — recommended

1. In Obsidian, open Settings → Community plugins.
2. Choose Browse, search for Pastepic, and open it.
3. Choose Install, then Enable.

You can also open the listing directly: Install Pastepic in Obsidian.

Pastepic is listed in the official Obsidian plugin directory. Version 0.4.15 supports Obsidian Mobile 1.12.4 and Desktop 1.12.7 or later.

Manual installation from a Release

1. Open the latest Release.

2. Download main.js, manifest.json, and styles.css.

3. Create the plugin directory in your vault:

   <your-vault>/.obsidian/plugins/obsipastepic/
   

4. Put the three downloaded files in that directory. The color icon is bundled into main.js, so no additional asset file is required.

5. Restart Obsidian and enable Pastepic under Settings → Community plugins.

The user-facing name is Pastepic. The plugin ID and installation directory remain obsipastepic to preserve existing installations and settings.

Build from source

git clone https://github.com/zengyincen/Obsidian-PastePic.git
cd Obsidian-PastePic
npm install
npm test
npm run build

Three-minute GitHub setup

Pastepic's settings page now treats only three values as required. The branch defaults to main; repository path and CDN can stay empty.

1. Use Create image repository in Pastepic settings, or select an existing public repository.
2. Use Create least-privilege token and create a fine-grained personal access token:
   • Limit repository access to the image repository;
   • Set Repository permissions → Contents to Read and write;
   • Grant no unrelated permissions.
3. Enter only Repository owner, Repository, and GitHub Token.
4. Run Test GitHub configuration, then paste an image.

Open Advanced options (skip for now) only when you need another branch, a fixed repository folder, custom filenames, or CDN acceleration. Use jsDelivr fills the CDN base directory automatically from the current owner, repository, branch, and path.

Paths and filenames

The repository path is empty by default, so images are uploaded to the repository root. You can instead enter a fixed directory such as images; when using a custom CDN, point its base URL to the same directory.

The settings page defaults to Simplified Chinese and can be switched to English, Japanese, Korean, Italian, Spanish, German, or French at any time.

Cross-platform support and evidence

Pastepic supports Obsidian across desktop computers, tablets, and phones, including iOS and Android. Pasting an image from the system clipboard uploads it through the configured GitHub repository or image host, including mobile WebViews that expose the image through clipboard items instead of a file list. Mobile operating systems do not provide the same drag-and-drop interaction as desktop, so use paste or insert the image into the note; the optional drop setting remains available for platforms that provide drop events.

Pastepic uses no Electron or Node runtime APIs and declares isDesktopOnly: false. The test suite covers mobile WebViews that expose pasted images through DataTransfer.items. Device-specific clipboard behavior can still vary by OS/app source; please include the device, OS, Obsidian version, and source app in a mobile compatibility report.

Filename strategies:

• Timestamp + original filename — default and least likely to collide;
• Timestamp only;
• Original filename.

The default commit message is Upload from Pastepic. Custom messages can also use {filename} and {path}.

CDN / proxy base directory

There are no template variables. Enter the URL of the final image directory and Pastepic appends the uploaded filename and extension automatically.

For a repository directory named images and an uploaded filename 1730000000-note.png:

The settings screen displays the complete URL preview. A custom base must point to the same directory as “Repository path.”

Raw and public CDN links generally cannot read private GitHub repositories anonymously. Uploads may succeed while images remain unavailable. Use an authenticated proxy or a public image repository.

Custom image-host API

Custom mode sends images as POST multipart/form-data:

POST /upload
Content-Type: multipart/form-data

file=<image bytes>
album=obsidian

Services that require custom signatures, chunked uploads, or an interactive browser login need a dedicated uploader implementation.

Paste behavior and failures

• The plugin does nothing when the clipboard contains no image.
• It does not intercept a mixed list of image and non-image files.
• Missing configuration preserves Obsidian's native paste behavior.
• Uploads start with a unique placeholder and finish as standard ![filename](remote-url) Markdown, without < > around the URL.
• Failed uploads restore the local image link instead of creating [Github upload error]() or an HTML error comment.
• Existing legacy [Github upload error]() markers are removed automatically on editor changes.
• A setting controls whether images are uploaded when clipboard text is present too.

Security

• The GitHub token is stored as plain text in the plugin's data.json. Use a single-repository, least-privilege, revocable token.
• Never expose tokens or custom authorization headers in screenshots, Issues, logs, or public notes.
• GitHub and public CDNs have terms and traffic limits. Normal personal-note images are usually fine; they are not unlimited object storage.

Development and verification

npm run typecheck   # TypeScript type checking
npm test            # Vitest unit tests
npm run build       # Build main.js

Tests cover base-directory joining, angle-bracket-free Markdown, path encoding, file naming, local image insertion detection, legacy error-marker cleanup, JSON response paths, and settings migration.

Brand assets

The visual system uses restrained gradients, layered glass, and generous spacing. It contains no Apple trademark or official Apple artwork.

Acknowledgements

Pastepic is an independently implemented MIT-licensed project. The following projects provided valuable references for events, uploader abstractions, GitHub image hosting, and UX:

Direct references

• gavvvr/obsidian-imgur-plugin — image-paste events, uploader abstraction, and failure fallback.
• yaleiyale/obsidian-emo-uploader — GitHub Contents API, multi-host settings, and CDN URL organization.
• renmu123/obsidian-image-auto-upload-plugin — paste placeholders, drag-and-drop uploads, and image-host workflows.

obsidian-image-auto-upload-plugin is a fork of obsidian-imgur-plugin; thanks to both maintainers for advancing this plugin family.

Upstream projects and ecosystem credited by those references

• jordanhandy/obsidian-cloudinary-uploader — explicitly credited by Emo Uploader as a Cloudinary reference.
• PicGo and PicGo-Core — the image-host ecosystem and documentation used by Image Auto Upload Plugin.
• GitHub REST API and jsDelivr — upload and CDN infrastructure credited by Emo Uploader.
• AList, EasyImages2.0, and Chevereto — self-hosted image ecosystems supported and credited by Emo Uploader.
• Cloudinary, SM.MS, ImgURL, Imgur, imgbb, and Catbox — hosting services documented by the reference projects.
• Thanks also to anxinJ and Linnnkkk, contributors explicitly named by Emo Uploader.

Thank you to Obsidian for the plugin API, and to every maintainer who publishes code and documentation openly.

License

MIT © 2026 zengyincen