Obsidian Stats logoObsidian Stats

LanTai

by windily
5
4
3
2
1
Score: 50/100
Install Code

Description

A obsidian plugin for uploading, localizing, and managing images with built-in object-storage profiles

Reviews

No reviews yet.

Stats

2
stars
38
downloads
1
forks
9
days
4
days
4
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
21
commits

Latest Version

0.0.6
5 days ago

Changelog

  • fix: 收紧仅文件内使用的 export，通过 find-overexposed
  • docs: 更新 README 覆盖桌面/移动端，并规范 JSON 缩进
  • feat: 上传冲突按内容分流确认覆盖，换链保留 layout/size
  • feat: 自研 S3 协议栈，并修复桌面特殊文件名签名与移动端上传

Full Changelog: https://github.com/windily-cloud/obsidian-LanTai/compare/0.0.5...0.0.6

See all version on GitHub

README file from

Github

LanTai（兰台）

English | 中文

兰台 (Lántái; product spelling LanTai; approximate English lahn-tye) takes its name from a classical Chinese term for keeping documents and archives. In the Han dynasty, 兰台 was the imperial court’s central repository for books and official records (a stone archive chamber under the Imperial Secretariat / Censorate lineage). Officials such as Lantai lingshi (兰台令史) curated texts and, at times, compiled history there. Later usage extended the word to court libraries, historiographers, and related offices; in modern Chinese it remains an elegant name for archival work and archive institutions.

This plugin uploads, localizes, and manages note images between your local vault and object storage—an end-to-end image attachment and image-host workflow for Obsidian on desktop and mobile.

What problem it solves

  • Common Image Auto Upload setups depend on PicGo, PicList, or similar external services, and often lag behind Obsidian updates.
  • Most “S3 / image host” plugins only upload. They rarely bring remote images back into the vault or help you manage files after upload—so you often get only part of the workflow.
  • Many of those tools skip mobile, so the same flow does not work on a phone.

LanTai combines upload, localize, naming templates, and gallery management in one plugin, including mobile (see Limitations).

Requirements

  • Obsidian ≥ 1.13.6 (credentials use Secret Storage / SecretComponent)

Quick start

  1. Open Settings → LanTai → S3.
  2. Create a storage profile: bucket, public base URL, region/endpoint as needed, and bind access keys via Secret Storage.
  3. Set that profile as the active profile.
  4. In a Markdown edit view, right-click an image (mobile: long-press) → Upload, or use the command palette to upload the current image.
  5. Open the gallery from Obsidian’s sidebar to browse recent, S3, and local images in a waterfall or grid layout.

Gallery preview

Features

  • Image context menu — Upload, localize, or download (save outside the vault) a single image. Right-click on desktop; long-press on mobile.
  • Batch commands — Upload every local image in the current note; localize every remote image in the current note.
  • Naming templates — Templates for local paths and per-profile object keys. Tokens: noteFileName, noteFolderName, noteFilePath, noteFolderPath, date, uuid, random, originalName, ext.
  • Gallery — Open from the ribbon to browse, search, and manage images in the bucket for a profile.

Also supports AWS S3, Cloudflare R2, Alibaba Cloud OSS, Tencent Cloud COS, and S3-compatible endpoints such as MinIO; optional delete of the local source after a successful upload; Wiki or Markdown for local links (remote http(s) URLs always use Markdown).

Limitations

  • In edit mode, LanTai replaces Obsidian’s built-in image context menu.
  • No custom sort order for S3 images (an object-storage limitation, not a missing feature in this plugin).
  • Mobile has been tested on Android only; iOS is not fully verified.
  • Reading / preview mode does not take over the image menu; Obsidian’s native menu remains.

Contributing & releasing

License

MIT

Sponsors