Pictether

by dhengsun
5
4
3
2
1
Score: 50/100

Description

Reviews

No reviews yet.

Stats

0
stars
29
downloads
0
forks
23
days
23
days
23
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
5
commits

Latest Version

23 days ago

Changelog

Pictether: Keep Your Vault Organized

Pictether is a simple, local-first external attachment manager for Obsidian Desktop.

This release includes bug fixes and stability improvements for a smoother experience.

Features

  • Simple to use: Paste, drag, and insert images, videos, and PDFs.
  • Organized storage: Attachments follow a vault/day/HHmmss-UUID structure for easier browsing and retrieval.
  • Cloud backup: Supports S3-compatible object storage, including Cloudflare R2.
  • Attachment recovery: Restore missing local attachments from cloud backups without automatically overwriting conflicting files.

What's Changed in v0.2.0

  • Fixed bugs and improved overall stability.
  • Improved reliability and user experience.

Installation

  1. Download pictether-0.2.0.zip.
  2. Extract it into your vault's .obsidian/plugins/ directory.
  3. Enable Pictether under Settings → Community plugins.

Requires Obsidian Desktop 1.11.4 or later.

Important Notes

This is a developer preview. Back up important data before use.

Attachments use mdasset:// references and require Pictether to display correctly in the original notes.

Reset deletes all managed local attachments across every namespace under the current attachment root, including attachments belonging to other vaults sharing the same directory. Files without backups cannot be recovered. Notes and cloud objects are preserved.

Feedback and bug reports are welcome through GitHub Issues.

README file from

Github

Pictether

Language support

English · 简体中文

Keep your vault clean. Keep your attachments organized.

Pictether is a simple, local-first external attachment manager for Obsidian Desktop. Paste, drag, and manage images, videos, and PDFs naturally, while keeping them neatly organized outside your vault.

Why Pictether?

  • Simple by design. Set an attachment directory and start using it. No complicated setup or workflows.
  • Organized by time. Attachments follow a predictable namespace/YYYY-MM-DD/HHmmss-xxxxxx.ext (six random hexadecimal digits) structure, making files easier to browse, locate, and manage.
  • A cleaner vault. Keep bulky media files outside your notes without sacrificing the familiar Obsidian editing experience.
  • Backup when you need it. Optionally back up attachments to S3-compatible storage and recover missing local files.
  • Easy to take elsewhere. Export notes as standard Markdown with relative attachment links.

Your notes stay in Obsidian. Your attachments stay organized.

Usage

  1. Choose an attachment directory. Set the attachment root in the plugin settings. The default is Pictures/markdown-assets under your home directory. The vault name is read from Obsidian automatically.
  2. Insert attachments. Paste or drag images, videos, and PDFs into a note, or run Insert Attachment. View them in Reading View or Live Preview.
  3. Connect object storage. Enter your S3 endpoint and bucket. Click the plus icon beside Access credentials, enter your Access Key ID and Secret Access Key, test the connection, and save. For Cloudflare R2, use auto as the signing region. A Token value is not required.
  4. Enable automatic backup. Existing and new attachments are backed up automatically. Use an entry's three-dot menu to edit or delete credentials. Gray means not tested, red means the connection test failed, and green means it passed. A small footer shows backup attempts, successes, conflicts, and failures.
  5. Restore missing attachments. Missing local files can be recovered from cloud storage. You can also use Restore missing attachments in settings or run Restore Missing Attachments. Conflicting content is never overwritten automatically.
  6. Export a note. Run Export Note with Attachments to create ordinary Markdown with relative attachment links for other tools.

Compatibility

Pictether currently supports Obsidian Desktop only.

The interface follows Obsidian's language setting: Chinese locales use Simplified Chinese; English and other locales use English. No separate plugin language setting is needed. After changing Obsidian's language, follow its reload prompt.

Supported formats:

  • Images: PNG, JPEG, WebP, GIF, BMP, AVIF, and SVG.
  • Videos: MKV, MOV, MP4, OGV, and WebM. Playback depends on the codec.
  • Documents: PDF.

New JSON and Markdown imports remain with Obsidian. Audio, HEIC, and TIFF are not supported.

Important Notes

Attachments use mdasset:// references and require Pictether for display in the original notes. Use the export feature when sharing with other Markdown tools.

Cloud storage is optional for local use. A successful connection test does not verify upload permissions.

Reset Warning

Reset deletes managed local attachments in every namespace under the current attachment root, including attachments used by other vaults sharing that directory. Unbacked files cannot be recovered.

Review the directory and file counts before confirming. Notes and cloud objects are preserved. Reconfigure object storage afterward to restore backed-up attachments.


Author: dhengsun · MIT License · Third-party notices