52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
|
# y
|
|||
|
|
|
|||
|
|
> algorithmically-enhanced [youtube-dl](https://yt-dl.org) wrapper for audio-downloads
|
|||
|
|
|
|||
|
|
|
|||
|
|
## install
|
|||
|
|
1. look at [`install.sh`](./install.sh) file for instructions
|
|||
|
|
1. adjust `PREFIX` at wish
|
|||
|
|
1. make sure the final directory is on `$PATH`
|
|||
|
|
|
|||
|
|
## use
|
|||
|
|
`y https://orax.bandcamp.com/track/ectoplasmic`
|
|||
|
|
|
|||
|
|
(adjust [config.sh](./config.sh) file to set your prefered download paths)
|
|||
|
|
|
|||
|
|
|
|||
|
|
## requirments
|
|||
|
|
- [`youtube_dl`](https://github.com/ytdl-org/youtube-dl) – the main thing
|
|||
|
|
- [`ffmpeg`](https://ffmpeg.org/download.html) – to convert files of diffrent formats
|
|||
|
|
- [`sd`](https://github.com/chmln/sd) – a better `sed`
|
|||
|
|
- [`lynx`](https://github.com/lynx/lynx) – to easily scrap web-pages
|
|||
|
|
|
|||
|
|
|
|||
|
|
## site-specific improvements
|
|||
|
|
|
|||
|
|
### bandcamp
|
|||
|
|
1. prefers mp3-320 (checks every track)
|
|||
|
|
2. downloads entire discography if given root-domain or `/music` url
|
|||
|
|
|
|||
|
|
### twitter
|
|||
|
|
file-name is now twitter-username and tweet-id
|
|||
|
|
(instead of full text of a tweet, which can result in strings over 255 characters long, aborting the entire process)
|
|||
|
|
|
|||
|
|
### reddit
|
|||
|
|
file-name is now subreddit, post-id, and url-slug
|
|||
|
|
(instead of full text of a title, which can result in strings over 255 characters long, aborting the entire process)
|
|||
|
|
|
|||
|
|
### youtube
|
|||
|
|
allows to set several predetermined filesystem-paths to keep file-categories separately:
|
|||
|
|
|
|||
|
|
- `y m <youtube_URL>` – music (automatically chosen for `music.youtube.com`)
|
|||
|
|
- `y a <youtube_URL>` – audiobooks
|
|||
|
|
|
|||
|
|
### soundcloud
|
|||
|
|
1. occasional wav-files are converted to mp3 320kb/s
|
|||
|
|
1. artist is set based on url (instead of having none by default)
|
|||
|
|
|
|||
|
|
### instagram
|
|||
|
|
- file-name is now username, video id, and nubmer of the video if there are multiple
|
|||
|
|
(instead of "Video by username", which refuses to download multiple videos from different id's: "Video by username.mp4 has already been downloaded")
|
|||
|
|
- TODO: explose playlist's `%(uploader_id)s`, `nr_current`, `nr_total` to the naming api
|