Obsidian Stats logoObsidian Stats

Harang Nextcloud

by Ji-ho Lee
5
4
3
2
1
Score: 50/100
Install Code

Description

Paste Nextcloud internal links into Obsidian and render them as rich file blocks.

Reviews

No reviews yet.

Stats

1
stars
48
downloads
0
forks
11
days
6
days
7
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
13
commits

Latest Version

0.0.6
8 days ago

Changelog

See all version on GitHub

README file from

Github

harang-nextcloud

🌐 English | 한국어

📖 Documentation (English / 한국어)

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's replaced with a nextcloud-file code block rendered 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 an nc-folder frontmatter property set, and they're uploaded to that Nextcloud folder automatically.

Features

  • Paste-to-block — paste a Nextcloud internal link and it's automatically replaced with a nextcloud-file code block, rendered as a card with the file's name, path, size, date, and an Open in browser button.
  • Login Flow v2 authentication — connect a Nextcloud account by logging in through your browser; the plugin obtains an app password the same way the official Nextcloud clients do, and never asks for or stores your actual account password.
  • Multiple Nextcloud profiles — connect any number of Nextcloud accounts, each identified by a profile name; a pasted link is matched to the right profile automatically.
  • Attachment upload via nc-folder — set an nc-folder: <ProfileName>/<path> frontmatter property on a note, then paste non-image files directly into it to upload them to that Nextcloud folder and insert a file block for each.
  • Deletion tracking — removing a nextcloud-file block from a note (by editing it out or deleting the note) prompts whether the underlying file should also be moved to the Nextcloud trash.
  • One-click open — every rendered block has an Open in browser button that jumps straight to the file on your Nextcloud server.

Prerequisites

  • A Nextcloud instance reachable over HTTP(S) that supports the standard Login Flow v2 handshake (built into any reasonably current Nextcloud server).
  • Obsidian 1.13.4 or later.

See the Prerequisites page for details.

Installation

Open Settings → Community plugins → Browse in Obsidian, search for "Harang Nextcloud", then click Install and Enable.

A manual install from pre-built files, or building from source, is also possible if you'd rather not use the Community Plugins browser — see the Installation page for details.

Usage

  1. In Settings → Harang Nextcloud, add a profile (name, server URL) and click Log in to connect to complete the Login Flow v2 handshake in your browser.
  2. Paste a Nextcloud internal link into a note — it's rendered as a file info block automatically.
  3. Optionally, add nc-folder: ProfileName/path to a note's frontmatter to enable pasting attachments directly into that note.

See the Usage guide for the full walkthrough, including deletion tracking and the manual convert-selection command.

Known limitations

  • Only the parts of the Nextcloud/WebDAV API needed for this workflow are implemented — the plugin is not a general-purpose Nextcloud file browser or sync client.
  • Deletion tracking only applies to notes Obsidian has actually seen open or modified during the current session; edits made while Obsidian wasn't watching a note aren't detected.

License

MIT — see LICENSE.

Sponsors