Skip to content

Repository files navigation

Dropbox Link for Obsidian

An Obsidian plugin spike for referencing files stored in Dropbox from notes.

Current scope

This first spike establishes the plugin shell and the reference syntax boundary:

  • D/path/to/file.pdf is the concise authoring form.
  • dropbox:/path/to/file.pdf is the unambiguous canonical form.
  • Dropbox references are account-relative and independent of where the Obsidian vault is stored.
  • Dropbox access tokens are reserved for Obsidian's SecretStorage API and are never written to plugin data, notes, or logs.
  • The command palette includes commands to insert and inspect a reference.

Dropbox OAuth, API calls, file resolution, embeds, autocomplete, and platform-specific opening behavior are intentionally not implemented yet.

Development

npm install
npm run build
npm run lint

For watch mode:

npm run dev

To test manually, copy main.js, manifest.json, and styles.css into <Vault>/.obsidian/plugins/obsidian-dropbox-link/, then enable the plugin in Settings → Community plugins.

Design notes

The plugin will use the Dropbox API for account-relative resolution instead of assuming a local Dropbox folder. Vaultbox, Obsidian Sync, iCloud, Git, and other vault-storage choices remain independent concerns.

About

Cross-platform Obsidian references to files stored in Dropbox

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages