Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gumob/music-dl
Command line tool to download music from YouTube and SoundCloud
https://github.com/gumob/music-dl
Last synced: about 2 months ago
JSON representation
Command line tool to download music from YouTube and SoundCloud
- Host: GitHub
- URL: https://github.com/gumob/music-dl
- Owner: gumob
- License: mit
- Created: 2018-10-22T10:19:35.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2021-12-01T08:30:35.000Z (about 3 years ago)
- Last Synced: 2024-10-01T14:26:33.601Z (2 months ago)
- Language: Python
- Homepage:
- Size: 62.5 KB
- Stars: 36
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- jimsghstars - gumob/music-dl - Command line tool to download music from YouTube and SoundCloud (Python)
README
[](https://badge.fury.io/py/music-dl)
# Overview
**Music Downloader** is the command line tool to download music from YouTube and SoundCloud.
This package requires the Python interpreter 3.4+ and tested only on Mac OS X Mojave.
It is released to the public domain, which means you can modify it, redistribute it or use it however you like.
# Installation
You need to install following dependencies before using Music Downloader.
```
$ brew install ffmpeg atomicparsley libmagic
```
Music Downloader can be installed using pip.
```
$ pip install --upgrade music-dl
```
# Usage
## Options
Music Downloader offers following options.
```
$ music-dl --help
Music Downloader 0.2.1
Usage: music-dl --url http://youtube.com/watch?v=&list=
--dir ~/Music/Download
--codec m4a
--bitrate 128
--no-track-number
--no-compilation
Optional Arguments:
-u, --url URL to download. [Default: Clipboard Value]
-d, --dir Path to working directory. [Default: /Users/kojirof/Music/Downloads]
-c, --codec [m4a,mp3,flac] Preferred audio codec. [Default: m4a]
-b, --bitrate Preferred audio bitrate. [Default: 198]
-s, --start Index specifying playlist item to start at.
Default value is index of first song on playlist. [Default: 1]
-e, --end Index specifying playlist item to end at.
Default value is index of last song on playlist. [Default: 0]
--no-artwork Forbid adding artwork to audio metadata.
--no-track-number Forbid adding track number to audio metadata.
--no-album-title Forbid adding album title to audio metadata.
--no-album-artist Forbid adding album artist to audio metadata.
--no-composer Forbid adding composer to audio metadata.
--no-compilation Forbid adding part of compilation flag to audio metadata.
--open-dir Open download directory after all songs are downloaded.
--verbose Print verbose message.
--help Show this help message and exit.
```
## Example
Music Downloader can download music by combining various options. Here are some examples.
### Download music of the URL copied to the clipboard. (No option requried)
```
$ music-dl
```
### Download single song
```
$ music-dl --url https://www.youtube.com/watch?v=video_id
$ music-dl --url https://soundcloud.com/artist_id/song_id
```
### Set audio quality and download all songs from playlist to specific directory
```
$ music-dl --url https://www.youtube.com/watch?v=video_id&list=playlist_id \
--dir ~/Downloads/Music \
--codec m4a \
--bitrate 128
$ music-dl --url https://soundcloud.com/artist_id/sets/playlist_id \
--dir ~/Downloads/Music \
--codec mp3 \
--bitrate 320
```
### Download songs from the 7th to 10th of playlist
```
$ music-dl --url https://www.youtube.com/watch?v=video_id&list=playlist_id \
--playlist-start 7 \
--playlist-end 10
$ music-dl --url https://soundcloud.com/artist_id/sets/playlist_id \
--playlist-start 7 \
--playlist-end 10
```
### Download songs from the 7th to the end of playlist
```
$ music-dl --url https://www.youtube.com/watch?v=video_id&list=playlist_id \
--playlist-start 7
$ music-dl --url https://soundcloud.com/artist_id/sets/playlist_id \
--playlist-start 7
```
### Download songs without adding track number to metadata
```
$ music-dl --url https://www.youtube.com/watch?v=video_id&list=playlist_id \
--no-track-number
$ music-dl --url https://soundcloud.com/artist_id/sets/playlist_id \
--no-track-number
```
# Known Issues
- If you requested an official YouTube playlist (aka YouTube Mix), downloaded songs are different from the playlist displayed on your browser, except for the first song. This is caused that YouTube generates a random playlist for each request.
If you request to resume downloading the same playlist, the consistency of track numbers registered in the metadata will be lost.
# Copyright
Music Downloader is released into the public domain by the copyright holders.
This README file was written by [Gumob](https://github.com/gumob) and is likewise released into the public domain.