-
-
Notifications
You must be signed in to change notification settings - Fork 1
mppdl.1
mppdl - download audio tracks from Bandcamp, Soundcloud, or a URL
mppdl [-a album] [-A artist] [-d music_dir] [-i] [-I] [-f fmt] [-l] [-t track] [-T title] bandcamp|soundcloud|downloads|URL
The mppdl command can be used to download audio tracks in a Bandcamp
collection, Soundcloud favorites, or a specified URL using yt-dlp
.
Bandcamp collections are downloaded into music_directory/Bandcamp/,
Soundcloud favorites are downloaded into music_directory/Soundcloud/, and
audio in the specified URL is downloaded into music_directory/Downloads/.
The music_directory path is that specified in $HOME/.config/mpd/mpd.conf
or $HOME/.config/mpprc
. By default this is $HOME/Music/
.
If a Beets import is specified with the -i
option then the import is
performed non-interactively. Beets tries to identify the audio using
metadata and filenames but may perform the matching incorrectly. When
automatically importing downloaded audio in this manner, verify the
import matching was properly performed. If an interactive Beets import
is preferred then do not use the -i
option to mppdl
and perform
the Beets import manually after the download completes.
Import already downloaded songs into Beets with the -I
option. Restrict
the import to Bandcamp downloads with mppdl -I bandcamp
, Soundcloud downloads
with mppdl -I soundcloud
, URL downloaded songs with mppdl -I downloads
, and
import all previously downloaded songs from Bandcamp, Soundcloud, or
a URL with mppdl -I
.
-a 'album' : saves the download in the subdirectory 'album'
-A 'artist' : saves the download with filename 'artist'-'title'.m4a
-d 'music_dir' : overrides the 'music_dir' location specified in config files
-i : indicates import audio into Beets after download completes
-I : indicates import previously downloaded audio into Beets
-f 'fmt' : saves the download in 'fmt' format (default m4a)
-t 'track' : saves the download with filename 'track'-'artist'-'title'.m4a
-T 'title' : saves the download with filename 'artist'-'title'.m4a
-l : indicates list available formats and info on URL
-u : displays this usage message and exits
The argument bandcamp, soundcloud, or URL indicates:
- Download Bandcamp collections
- Download Soundcloud favorites
- Download audio in URL
Written by Ronald Record github@ronrecord.com
MPPDL is distributed under an Open Source license. See the file LICENSE in the MPPDL source distribution for information on terms & conditions for accessing and otherwise using MPPDL and for a DISCLAIMER OF ALL WARRANTIES.
Submit bug reports online at:
https://github.com/doctorfree/MusicPlayerPlus/issues
beet(1), mpplus(1)
Full documentation and sources at: