Media Embed

by punkyard
5
4
3
2
1
Score: 35/100

Description

Automatically converts pasted YouTube links into your preferred embed format on an empty line. - This plugin has not been manually reviewed by Obsidian staff.

Reviews

No reviews yet.

Stats

stars
302
downloads
0
forks
2
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

README file from

Github

Media Embed

Simply paste a YouTube URL on an empty line in an Obsidian note and it's instantly converted into your preferred embed format (markdown, iframe or div).

⭐️ Roadmap unlocks with GitHub stars:

  • 100 GitHub ⭐ : more video providers (Vimeo, Dailymotion, local files…)
  • 1 000 GitHub ⭐ : auto-import video metadata (title, thumbnail) from URL

Features

  • intercepts YouTube URLs pasted on empty lines
    • youtu.be
    • shorts
    • embed URLs
  • three preview options to choose from
    • simple markdown
    • responsive in iframe and div modes
  • alternative embed server support for restricted videos
    • toggle in settings to route embeds through an Invidious instance
    • bypasses YouTube embed blocks (Error 153)
    • configurable URL — swap instances if one is down
  • works on desktop and mobile

Embed styles

Choose your preferred embed mode in Obsidian Settings... → Media Embed.

Media Embed options

Style Output Responsive
markdown ![]() no — fixed size
iframe <iframe ...> yes — fills pane width
div <div><iframe ...> yes, in a frame — bulletproof

Not sure which to pick? See pros & cons and edge-case guide.

Alternative embed server

Some YouTube videos have embedding disabled by the uploader. When pasted in iframe or div mode, they show a blank player (YouTube Error 153).

Enable Use alternative embed server in settings to route embeds through an Invidious instance instead.

Results in source mode:

Media Embed source


Usage

get YouTube URL

  1. copy YouTube video URL (right-click on it: Copy video URL)
  2. open any note
  3. place your cursor on a blank line
  4. paste the YouTube URL (Cmd+V / Ctrl+V)
  5. the URL is automatically replaced with the embed
Supported URL formats:
  • https://www.youtube.com/watch?v=...
  • https://youtu.be/...
  • https://www.youtube.com/shorts/...
  • https://www.youtube.com/embed/...


Installation

From Obsidian Community Plugins
  1. open Obsidian Settings... → Community plugins
  2. disable Safe mode if prompted
  3. click Browse and search for Media Embed
  4. install and enable the plugin
  5. open Options and choose your preferred style (markdown, iframe, div)
Manual
  1. go to the latest release and download main.js and manifest.json
  2. create a folder <your vault>/.obsidian/plugins/video-embed/
  3. place both files in that folder
  4. reload Obsidian and enable the plugin in Settings → Community plugins

Contributing

Found a bug or have a suggestion? You're welcome to open an issue. See CONTRIBUTING for development setup and pull request guidelines.


License

This project is licensed under MIT.