Download youtube video or playlist, convert to mp3, store into a folder.
Project description
Download youtube video or playlist, convert to mp3, store into a folder.
Features:
Download all or subset of playlist
Download only new playlist additions, once local storage folder is created
Refresh local storage folder without respecifying link to playlist
Refresh multiple local storage folders
Installation
Install Python >= 3.9
Install dmp3 package from pypi
pip install dmp3
Install FFMPEG, it converts media formats.
Linux
sudo apt install ffmpeg
Windows
Install from ffmpeg download page, most likely use windows installer.
Add the bin folder that contains ffmpeg.exe to system path, so that it is available on command line.
Simple Usage
Linux:
cd /home/user/Projects/utube_playlist_mp3_downloader/tests/mp3_dir
dmp3 starcraft_terran -w https://www.youtube.com/playlist?list=PLEtYTVnkBVuZWJ4Gsxtt80tWbiiyy1bcy
Windows:
dmp3 "D:\media\music\game_theme\starcraft_terran" -w https://www.youtube.com/playlist?list=PLEtYTVnkBVuZWJ4Gsxtt80tWbiiyy1bcy
Example results:
mp3_dir/
├── diablo1
│ ├── .dmp3
│ ├── Diablo 1 [OST] - 01 - Intro-Y7P7vrvEQYc.mp3
│ ├── Diablo 1 [OST] - 02 - Town-SEpydfXj87M.mp3
│ ├── Diablo 1 [OST] - 03 - Dungeon-yQCg-uHOrZk.mp3
│ ├── Diablo 1 [OST] - 04 - Catacombs-FPQPJwVX-60.mp3
│ ├── Diablo 1 [OST] - 05 - Caves-J9OIyH21ZKo.mp3
│ └── Diablo 1 [OST] - 06 - Hell-5PBG92gkL7I.mp3
└── starcraft_terran
├── .dmp3
├── StarCraft - Terran Theme 1-mD4GbGmvNRc.mp3
├── Starcraft 2 Soundtrack - Terran 01-zAS8KivZX5s.mp3
├── Starcraft 2 Soundtrack - Terran 02-sNbTg0Li36k.mp3
├── Starcraft 2 Soundtrack - Terran 03-dssNa11htIM.mp3
├── Starcraft 2 Soundtrack - Terran 04-4YfQjho2IOk.mp3
├── Starcraft 2 Soundtrack - Terran 05-fQluJBSXM5I.mp3
├── Terran Theme 2 - Starcraft Soundtrack-_R1QLIo16DY.mp3
├── Terran Theme 3 - Starcraft Soundtrack-xcEHDqji74A.mp3
└── Terran Theme 4 (Brood War) - Starcraft Soundtrack-l9XSZw67QpY.mp3
Refresh multiple local storage folders, each tracking a playlist:
cd /home/user/Projects/utube_playlist_mp3_downloader/tests/mp3_dir
dmp3 . -r
Usage in python script:
from dmp3.dmp3 import dmp3
from pathlib import Path
folder = Path("/home/user/Projects/utube_playlist_mp3_downloader/tests/mp3_dir/starcraft_terran")
webpath = "https://www.youtube.com/playlist?list=PLEtYTVnkBVuZWJ4Gsxtt80tWbiiyy1bcy"
dmp3(folder=folder)
dmp3(folder=folder, webpath=webpath, start=1, end=3, refresh_folder_mode=False, mp3=True)
API
usage: dmp3 [-h] [-w WEBPATH] [-s START] [-e END] [-r] [-m MP3] folder Download youtube video or playlist, convert to mp3, store into a folder. If folder not exists, creates a folder. Otherwise, uses the folder, and will only download new videos from the playlist. If webpath is provided, creates a .dmp3 file in the folder to store the webpath for future use. If not provided, uses the webpath in the .dmp3 file in the folder stored previously. If not provided and no .dmp3 file is found in the folder, exits. If start and/or end are provided, download only the subset of the playlist. But will not download the videos that are already downloaded. positional arguments: folder Folder to store mp3 files options: -h, --help show this help message and exit -w WEBPATH, --webpath WEBPATH Webpath to download from, creates a .dmp3 file insdie folder to store webpath -s START, --start START Start index of the playlist -e END, --end END End index of the playlist -r, --refresh_folder_mode Refresh all mp3 folders in the folder, default is False. -m MP3, --mp3 MP3 Convert mp4 files to mp3 files in the folder (WIP) Examples: Entire playlist: cd /home/user/Projects/utube_playlist_mp3_downloader/tests/mp3_dir dmp3 starcraft_terran -w https://www.youtube.com/playlist?list=PLEtYTVnkBVuZWJ4Gsxtt80tWbiiyy1bcy Part of playlist: dmp3 starcraft_terran -w https://www.youtube.com/playlist?list=PLEtYTVnkBVuZWJ4Gsxtt80tWbiiyy1bcy -s 1 -e 2 Refresh entire playlist: dmp3 starcraft_terran Refresh part of playlist: dmp3 starcraft_terran -e 2 Refresh all folders: cd /home/user/Projects/utube_playlist_mp3_downloader/tests/mp3_dir dmp3 . -r
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.