README file from
GithubStream Embed
Automatically convert pasted links into playable embedded players and interactive previews inside Obsidian.
Compatibility
Requires Obsidian 1.13.0 or newer.
Features
- Seamless Paste — Paste a link from Spotify, YouTube, Google Drive, Vimeo, Loom, Figma, SoundCloud, Twitch, or CodePen on an empty line to instantly create an embed block.
- Hover Action Bar — Hover over any embed to quickly copy the URL (📋), open it in your browser (↗), or maximize it into a full-window modal (⤢).
- Click-to-Load Mode — Optional performance and privacy mode that renders a lightweight preview card and loads the iframe only when clicked.
- Inline Options Override — Customize height, aspect ratio, or click mode per block directly inside markdown.
- Command Palette Integration — Quickly convert links under cursor or selections into embed blocks via commands.
- Multi-Platform Portfolio:
- Spotify: Tracks, albums, playlists, artists, episodes, shows.
- YouTube: Videos, shorts, live streams, embeds, timestamps.
- Google Drive & Workspace: PDFs, videos, audio, images, Docs, Sheets, Slides, Forms, Drawings, Folders.
- Vimeo & Loom: High-definition video walkthroughs and screen recordings.
- Figma & FigJam: Live UI designs, prototypes, and whiteboards.
- SoundCloud: Audio tracks and podcasts.
- Twitch: Live streams, video vods, and clips.
- CodePen: Live code snippets and web playgrounds.
Usage
Auto Paste
- Copy a link from any supported platform.
- Paste it on a blank line in your Obsidian editor.
- The plugin automatically converts it into an
embedblock and renders it in Live Preview and Reading View.
Manual & Custom Block Options
You can customize height, aspect ratio, or load mode per block:
```embed
https://drive.google.com/file/d/1ABC123xyz_456-789/view
height: 700px
```
```embed
https://vimeo.com/123456789
aspect: 16/9
mode: click
```
Shorthand single-line format:
```embed
https://drive.google.com/file/d/1ABC123xyz_456-789/view height=700
```
Commands
Access via Ctrl/Cmd + P (Command Palette):
| Command | Description |
|---|---|
Stream Embed: Convert link under Cursor to embed block |
Wraps link under editor cursor into an embed block |
Stream Embed: Convert selection to embed block |
Converts selected link text to an embed block |
Stream Embed: Toggle click-to-load mode |
Toggles globally between direct iframe loading and click-to-load cards |
Settings
Configurable in Settings → Stream Embed:
| Setting | Description | Default |
|---|---|---|
| Spotify embed height | Default height of Spotify embeds in pixels. | 352 |
| Google Drive embed height | Default height of Google Drive/Docs embeds in pixels. | 480 |
| Enable click-to-load mode | Displays preview cards and loads iframes only on click. | Disabled |
| Show hover action bar | Shows action toolbar (Copy, Open, Fullscreen) on hover. | Enabled |
Installation
From community plugins
- Open Settings → Community plugins.
- Select Browse and search for Stream Embed.
- Select Install, then Enable.
Manual
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Create a folder named
stream-embedinside your vault's.obsidian/plugins/directory. - Place the downloaded files inside the new folder.
- Open Settings → Community plugins and enable Stream Embed.
Development
npm install
npm run dev # watch mode
npm run build # production build
npm run lint # lint