https://github.com/dideler/dl.fish
🐟 CLI tool for fish users to easily download media from the web
https://github.com/dideler/dl.fish
download-audio fish fish-packages fish-plugin fish-shell fisherman productivity youtube-dl
Last synced: 21 days ago
JSON representation
🐟 CLI tool for fish users to easily download media from the web
- Host: GitHub
- URL: https://github.com/dideler/dl.fish
- Owner: dideler
- License: mit
- Created: 2018-07-03T22:22:16.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2023-10-31T02:43:32.000Z (over 1 year ago)
- Last Synced: 2025-03-24T19:36:33.306Z (about 1 month ago)
- Topics: download-audio, fish, fish-packages, fish-plugin, fish-shell, fisherman, productivity, youtube-dl
- Language: Shell
- Homepage:
- Size: 21.5 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dl.fish [](https://circleci.com/gh/dideler/dl.fish)
Opinionated wrapper around ~~youtube-dl~~ yt-dlp to easily download audio when using the [fish shell].
All downloads get saved as MP3 in the `$HOME/Music` directory, with a filename from the content's title.
## Demo
Works with any yt-dlp supported source.
## Install
Install with your favourite fish package manager, such as [fisherman] or [oh-my-fish]
```shell
# Install with fisher v4 or v2
fisher install dideler/dl.fish
# Install with fisher v3
fisher add dideler/dl.fish
# Install with oh-my-fish
omf install https://github.com/dideler/dl.fish
```
## Usage
```fish
dl "https://www.youtube.com/watch?v=hC8CH0Z3L54"
```
## Goals
At the time of writing (2018-07-22), youtube-dl can extract media from 750+ different sources, its man page is ~3000 lines long, its help output is ~300 lines long, and it has ~120K lines of code.
But 99% of the time, I use it for dowloading music, and got tired of its complicated API and configuration.
This is an opinionated wrapper to download audio as MP3 with a good enough filename to a specific directory.
[fisherman]: https://github.com/fisherman/fisherman
[oh-my-fish]: https://github.com/oh-my-fish/oh-my-fish
[fish shell]: https://fishshell.com/