harang-nextcloud documentation

An Obsidian plugin that turns pasted Nextcloud internal links into rich file blocks — showing file size, upload date, and a one-click shortcut to open the file in your browser — right inside your notes.

Paste a Nextcloud internal link (e.g. https://cloud.example.com/f/12345) into a note and it is replaced with a nextcloud-file code block that renders as a small card with the file’s name, path, size, date, and an Open in browser button. You can also drop non-image files straight into a note with a nc-folder frontmatter property set, and they are uploaded to that Nextcloud folder automatically.

Contents

• Prerequisites
  • 1. A reachable Nextcloud server
  • 2. Obsidian 1.13.4 or later
• Installation
  • Method 1 — Community Plugins browser (recommended)
  • Method 2 — Manual install of pre-built files
  • Method 3 — Clone the Git repository and build from source
• Usage
  • Connecting a Nextcloud server profile
  • Pasting a Nextcloud link
  • Uploading attachments straight into a note
  • Removing an attachment link
• Architecture
  • Source layout
  • Data flow
  • Reference syntax
  • Date field: “Created” vs. “Modified”
  • No runtime dependencies
• Troubleshooting & FAQ
  • Connecting a profile fails or times out
  • A block shows “No Nextcloud profile matches this link”
  • A block shows “Authentication failed”
  • Attachments don’t upload when pasting files
  • The plugin doesn’t appear after installing
  • The plugin doesn’t update after git pull

Indices and tables

• Index

• Search Page