README file from
GithubBest Downloader
An Obsidian plugin to download videos and audio directly into your vault, powered by yt-dlp.
Note: This plugin works only on the Obsidian desktop app (Windows, macOS, Linux).
Features
- Download videos from hundreds of sites supported by
yt-dlp. - Download audio-only (MP3/M4A) or video+audio (MP4/WebM).
- Automatically saves downloaded files directly into your Obsidian vault.
- Customizable download paths.
Requirements
- Obsidian Desktop App: The plugin requires the desktop version of Obsidian. It does not work on mobile.
- yt-dlp: Make sure you have
yt-dlpinstalled and available in your system's PATH, or specify the executable path in the plugin settings. - FFmpeg: Required if you want
yt-dlpto mux video and audio streams together or convert audio formats.
Installation
From Obsidian Community Plugins
- Open Obsidian Settings.
- Go to Community plugins and disable Safe mode.
- Click Browse and search for "Best Downloader".
- Install and enable the plugin.
Manual Installation
- Go to the Releases page of this repository.
- Download
main.js,manifest.json, andstyles.css(if present) from the latest release. - Create a folder named
best-downloaderinside your Obsidian vault's.obsidian/plugins/directory. - Place the downloaded files into the
best-downloaderfolder. - Restart Obsidian or reload plugins.
- Enable the plugin in Settings > Community plugins.
Usage
- Open the Command Palette (
Ctrl+PorCmd+P). - Search for Best Downloader and select the download command.
- Enter the URL of the video you want to download.
- Choose the format (Audio/Video).
- The file will be downloaded and saved to your vault.
Settings
In the plugin settings, you can configure:
- Download Path: The folder in your vault where downloads will be saved.
- yt-dlp Path: The absolute path to your
yt-dlpexecutable (optional, if it's already in your system PATH). - Default Format: Choose whether to download Audio or Video by default.
License
This project is licensed under the MIT License.