Attachment Imagebed Manager

Upload your Obsidian note attachments to the cloud and replace local links with remote URLs.

中文说明

Quick Start

1. Install the plugin and open Settings → Attachment Imagebed Manager
2. Under Step 1: Connect your cloud storage, choose a provider (Cloudflare R2 recommended)
3. Fill in your credentials and click Test connection
4. Open a note and click the cloud icon in the left sidebar — done!

What It Does

• Scans your notes for local attachments (images, PDFs, audio, video, etc.)
• Uploads them to S3-compatible cloud storage (Cloudflare R2, AWS S3, MinIO, etc.)
• Replaces the local links in your notes with remote URLs
• Optionally deletes the local files after replacement

Features

• S3-compatible storage: Cloudflare R2, AWS S3, MinIO, or any S3-compatible provider
• Mobile compatible: Works on both desktop and mobile Obsidian (manual upload only on mobile)
• Category-based UI: Browse attachments by type — Images, Videos, Audio, Documents — with list and gallery views
• Custom extensions: Add your own file types (e.g. .sketch, .fig, .psd)
• Safe replacement: Atomic note writes with concurrent-edit detection; failed uploads are auto-rolled-back
• Upload retry: 3 retries with exponential backoff on transient failures
• Delete policies: Ask before delete, immediate trash, or delayed delete (desktop only)
• Auto scan: Periodic vault-wide scanning with quiet-period and file-size filtering (desktop only)
• Dry-run mode: Preview what would be replaced without making changes
• Bilingual UI: English and Chinese (简体中文)
• Code-block aware: Links inside fenced code blocks and inline code are ignored

Installation

From Obsidian Community Plugins

1. Open Obsidian → Settings → Community Plugins → Browse
2. Search for "Attachment Imagebed Manager"
3. Click Install, then Enable

Manual Installation

1. Download main.js, manifest.json, and styles.css from the latest release
2. Copy them to <vault>/.obsidian/plugins/attachment-imagebed-manager/
3. Enable the plugin in Obsidian → Settings → Community Plugins

Configuration

Step 1: Connect Your Cloud Storage

Choose your storage provider and fill in the credentials:

Click Test connection to verify your settings.

Step 2: General Settings

• Attachment folder: Only files under this folder are processed (default: 99 Attachments)
• Delete policy: What to do with local files after replacement
  • Ask me each time (recommended) — shows a confirmation dialog
  • Delete immediately — trashes local files right away
  • Delete after a delay — schedules deletion after configurable hours (desktop only)
• Auto-scan vault periodically: On desktop, find and replace eligible attachments while Obsidian is open (desktop only)
  • Scan interval: How often to scan (default: 30 minutes)
  • Skip recently modified files: Files modified within this time are skipped (default: 600 seconds)
  • Minimum file size: Ignore files smaller than this threshold in auto-scan

Step 3: Choose File Types (Desktop Only)

This section appears only when auto-scan is enabled. It lets you configure which file types are included in scheduled scans:

• Toggle entire categories (Images, Videos, Audio, Documents)
• Click individual extensions to toggle them
• Mark extensions as "Scheduled" to include them in auto-scan
• Add custom file types (e.g. sketch, fig, psd)

Usage

Scan Current Note (All Platforms)

Click the cloud upload icon in the sidebar, or use the command palette:

• Scan current note attachments — shows eligible attachments in a modal with category filters, list/gallery views, and a select-all checkbox

Vault-wide Preview (Desktop and Mobile)

Command palette → Preview all local vault attachments — preview mode, no changes made.

Foreground Vault Batch (Desktop and Mobile)

Command palette → Directly upload & replace all vault attachments (no filtering). The plugin scans Markdown notes, shows a summary, then processes every discovered local attachment one by one. Mobile batch processing must stay in the foreground; switching apps or locking the screen may pause the task.

For a safer selective run, use Filter & batch replace vault attachments. It scans first, then lets you filter by file type and select individual attachments before starting the same foreground batch processor.

Auto Scan (Desktop Only)

Enable in settings → Auto-scan vault periodically. While the desktop Obsidian app is open, the plugin checks the vault at the configured interval (default: 30 minutes). It does not run immediately at startup, skips recently modified notes/files and files below the configured thresholds, and continues with other notes when one note fails. Auto-scan uses delayed local-file deletion so it does not stop to ask questions.

Process Delayed Deletes (Desktop)

Command palette → Process delayed attachment deletes — manually trigger pending delayed deletions.

Mobile Notes

On mobile devices:

• Manual upload and replacement works normally
• Foreground vault batch replacement is available, but Obsidian must remain open while it runs
• Background auto-scan is not supported; switching apps or locking the screen may pause a batch
• Scheduled auto-scan is disabled (to preserve battery and avoid background restrictions)
• Delayed delete policy is not available (use "Ask me each time" or "Delete immediately")
• File type configuration (Step 3) is hidden since it only applies to auto-scan

Building from Source

git clone https://github.com/perinchiang/attachment-imagebed-manager.git
cd attachment-imagebed-manager
npm install
npm run dev    # watch mode
npm run build  # production build

Security

• Credentials are stored locally in data.json. Do not sync data.json to public repositories.
• data.json is included in .gitignore by default.
• If you accidentally commit data.json, rotate your S3 credentials immediately.

License

MIT

中文说明

将 Obsidian 笔记中的本地附件上传到云存储，并将本地链接替换为远程 URL。

快速上手

1. 安装插件，打开 设置 → 附件图床管理器
2. 在 第一步：连接云存储 中选择服务商（推荐 Cloudflare R2）
3. 填写凭据，点击 测试连接 验证
4. 打开一篇笔记，点击左侧栏的云图标 — 完成！

功能

• S3 兼容存储: 支持 Cloudflare R2、AWS S3、MinIO 及任意 S3 兼容服务
• 移动端兼容: 桌面端和移动端均可使用（移动端仅支持手动上传）
• 分类浏览: 按图片、视频、音频、文档分类浏览附件，支持列表和画廊视图
• 自定义后缀: 可添加自定义文件类型（如 .sketch、.fig、.psd）
• 安全替换: 原子写入，检测并发编辑；上传失败时自动回滚
• 上传重试: 网络错误时自动重试 3 次（指数退避）
• 删除策略: 每次询问 / 立即删除 / 延迟删除（仅桌面端）
• 自动扫描: 定时全库扫描，支持静默期和文件大小过滤（仅桌面端）
• 预览模式: 全库扫描预览，不实际替换
• 双语界面: 中文和英文
• 代码块感知: 忽略代码块和行内代码中的链接

配置

第一步：连接云存储

选择存储服务商并填写凭据：

点击 测试连接 验证设置。

第二步：基本设置

• 附件文件夹: 只处理此文件夹下的文件（默认：99 Attachments）
• 删除策略: 替换链接后本地文件的处理方式
  • 每次询问我（推荐）— 弹出确认对话框
  • 替换后立即删除 — 直接移入回收站
  • 延迟删除 — 在指定小时后移入回收站（仅桌面端）
• 定期自动扫描全库: 仅桌面端在 Obsidian 运行期间查找并替换符合条件的附件
  • 扫描间隔: 多久扫描一次（默认：30 分钟）
  • 跳过最近修改的文件: 在此时间内修改过的文件会被跳过（默认：600 秒）
  • 最小文件大小: 自动扫描忽略小于此大小的文件

第三步：选择文件类型（仅桌面端）

此部分仅在开启自动扫描时显示，用于配置定时扫描包含的文件类型：

• 按分类切换（图片、视频、音频、文档）
• 点击单个后缀切换
• 标记为"定时"以加入自动扫描
• 添加自定义文件类型（如 sketch、fig、psd）

使用

扫描当前文档（全平台）

点击侧边栏云上传图标，或使用命令面板：

• 扫描当前文档附件 — 在弹窗中按分类浏览、列表/画廊切换、全选附件

全库预览（全平台）

命令面板 → 预览全库本地附件 — 预览模式，不做任何修改。

前台批量替换（桌面端和移动端）

命令面板 → 直接批量替换全库附件（不筛选）。插件会扫描所有 Markdown 笔记，先显示统计摘要，再逐篇处理发现的全部本地附件。移动端批处理必须保持 Obsidian 在前台；切换应用或锁屏可能暂停任务。

如果只想处理一部分附件，使用 筛选后批量替换全库附件。插件会先扫描，再按图片、视频、音频、文档或其他分类筛选，并允许逐项勾选后开始批处理。

自动扫描（仅桌面端）

在设置中开启 定期自动扫描全库。只要桌面版 Obsidian 保持运行，插件就会按设置的间隔（默认 30 分钟）检查全库；启动后不会立即扫描，会跳过最近修改的笔记/附件以及低于阈值的文件。某篇笔记失败时会继续处理其他笔记。自动扫描使用延迟删除，不会弹出询问框。

处理延迟删除（桌面端）

命令面板 → 处理延迟删除附件 — 手动触发待执行的延迟删除。

移动端说明

在移动设备上：

• 手动上传和替换功能正常使用
• 支持前台批量替换，但处理期间必须保持 Obsidian 打开
• 不支持后台自动扫描；切换应用或锁屏可能暂停批处理
• 定时自动扫描已禁用（节省电量，避免后台限制）
• 延迟删除策略不可用（请使用"每次询问"或"立即删除"）
• 文件类型配置（第三步）已隐藏，因为仅对自动扫描生效

安全

• 凭据存储在本地 data.json 中。不要将 data.json 同步到公开仓库。
• data.json 默认已包含在 .gitignore 中。
• 如果你不小心提交了 data.json，请立即轮换你的 S3 凭据。

许可证

MIT