Utility program for downloading bookmarked youtube links using yt-dlp. It replicates the folder structure of your Chrome/Brave/Firefox/etc. bookmarks and calls yt-dlp to download all YouTube videos among the bookmarks.
- Run the executable and select your browser profile to auto-import bookmarks, or load a Google Takeout Chrome bookmarks HTML file.
- Choose an output folder for the downloaded files.
- If necessary, specify the location of the yt-dlp executable in the settings.
- Additional CLI usage options are available for more advanced users.
Make sure yt-dlp is installed: If you do not have the newest version you can get it here.
Download the executable for your system from releases. Run it.
- Currently "exports" from browsers do not work.
- Output folder cannot be a network folder on some platforms.
Put the Bookmarks.html and the yt-dlp(.exe) into the same directory as the executable. Get the Bookmarks.html from a Google takeout. The yt-dlp executable can be found here.
If you do not provide the Bookmarks.html the program will check for default data directories of several browsers. More detail below.
Run the executable:
Windows: in CMD or PowerShell: bookmark-dlp-8.0.x.exe --console
Linux: in terminal in the directory: ./bookmark-dlp-linux-x64-8.0.x --console
More flags/usage info: bookmark-dlp-.. --help
- The program checks for a Bookmarks.html file in its root directory. If not found, it searches default locations for supported browsers.
- It replicates the folder structure of the bookmarks bar on disk.
- YouTube links are extracted from the bookmarks and organized into text files.
- Helper scripts are generated for each folder to call yt-dlp for downloading.
- Optional: Provide a yt-dlp.conf file in the program root directory for advanced configurations.
The program first checks if a Bookmarks.html exists within its root directory/where it was called from. If yes, that is the input file. If no, default locations for some browsers (Chrome, Brave and Firefoxunstable currently) are checked, to find any browser profiles with bookmarks.
When a bookmark containing file is found or provided, the content is taken in, and the folder structure of the bookmarks bar is replicated on disk, in the root(running) directory.
The youtube links in the given folder are written into a ${foldername}.txt file. Complex youtube links (not links for video, but for channels and playlists etc) are placed in a separate ${foldername}.complex.txt.
A helper script (.bat or .sh) is also generated for each folder. If a folder contains no links (and no files at all) it is deleted. The helper scripts are called, these in turn call yt-dlp. The presence of yt-dlp binaries is checked in the root(running) directory (and the PATH (kind of)).
The scripts run one at a time, in sequence. I recommend also providing a yt-dlp.conf file into program root (running) directory, and enabling the archive function - that way bookmark-dlp can be run from the same directory again, and only new files get downloaded.
If the same directory is used for different profiles things can get written into same directories, but probably nothing should be lost.
Config for bookmark-dlp:
- local
- Path.Combine(Directory.GetCurrentDirectory(), "bookmark-dlp.conf");
- Assembly.GetExecutingAssembly
- OS config directory
- windows = Path.Combine(System.Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "bookmark-dlp\bookmark-dlp.conf");
- linux = Path.Combine(System.Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "bookmark-dlp/bookmark-dlp.conf");
- osx = Path.Combine(System.Environment.GetFolderPath(Environment.SpecialFolder.Personal), "bookmark-dlp/bookmark-dlp.conf"); If no config is found at startup popup asks for location for new config file.
yt-dlp:
- program is called from
- program executable is found in
- chosen output folder accepted filenames: osx: { "yt-dlp", "yt-dlp_macos", "yt-dlp_macos_legacy" } linux: {"yt-dlp", "yt-dlp_linux", "yt-dlp_linux_aarch64", "yt-dlp_linux_armv7l" } windows: "yt-dlp.exe"
yt-dlp.config is sought in the following locations:
- program is called from
- program executable is found in
- chosen output folder
- yt-dlp executable is found in (even if manually selected)
- yt-dlp default folder (somewhere in .local?)
Windows and linux compatible, written in C#, builds for x86 and ARM available.
Build your own: this project is open source
CI/CD
- OpenSuse Build Service
- Flathub
- Debian
- Arch/AUR
- Fedora
- Gitea mirror
- sourceforge mirror
- NuGet
new features
- start console and gui from same binary
- better versioning
- refactor bookmarks import to library
- tray icon
- systemd module
- dot dekstop file
- add manpages
- logging
Increase support
- safari support
- opera osx support
- bsd support
- docker
- netcore3.1
- innosetup
- flatpak support
Install dependencies: dotnet
git clone -b master https://github.com/Neurofibromin/bookmark-dlp bookmark-dlp
cd bookmark-dlp
dotnet restore
dotnet publish bookmark-dlp/bookmark-dlp.csproj --configuration Release
| Windows | Linux | OSX (semi-supported) |
|---|---|---|
| x64 | x64 | x64 |
| x32 | N/A | N/A |
| arm64 | arm64 | arm64 |