Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/julianfbeck/pl2mp3

👀 Watches Youtube Playlists and automatically downloads & converts Videos to mp3
https://github.com/julianfbeck/pl2mp3

download mp3 playlist watch youtube

Last synced: about 1 month ago
JSON representation

👀 Watches Youtube Playlists and automatically downloads & converts Videos to mp3

Host: GitHub
URL: https://github.com/julianfbeck/pl2mp3
Owner: julianfbeck
Created: 2019-02-19T09:09:33.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2022-04-13T21:54:45.000Z (almost 3 years ago)
Last Synced: 2024-12-09T03:44:01.907Z (about 1 month ago)
Topics: download, mp3, playlist, watch, youtube
Language: JavaScript
Homepage:
Size: 123 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 5
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# pl2mp3 [![npm version](https://badge.fury.io/js/pl2mp3.svg)](https://badge.fury.io/js/pl2mp3)

> 👀 Watches Youtube Playlists and automatically downloads & converts them to mp3

**pl2mp3** will watch multiple YT playlists to download newly added videos and convert them to MP3. Ideal for music or podcast playlists.

Install **pl2mp3**:

```shell
npm install -g pl2mp3
```
## Usage:
```shell
Usage
$ pl2mp3

Options
--init, -i create a new download Directory
--update , -u check for playlist updates every mins. Default 10min
--reset, -r resets database, removes downloaded videos

Examples
$ pl2mp3 --init // to create a new download Directory
$ pl2mp3 // to start watching for new videos
$ pl2mp3 --update 20 // to watch every 20min for changes.
```
## Setup:
### Setup Download folder:
* In order to use **pl2mp3**, you first have to create a download Directory. This Directory will be used by pl2mp3 to download and convert new videos. Run the following command to create a new download Directory

```shell
pl2mp3 --init
```
* This will create a new directory with a *db.json* file and a *config.json* file.
### Setup config.json:
* After running the `--init` command, **pl2mp3** created a *config.json* file. The *config.json* file is used to specify the playlists you want to download and other options.
* When adding new playlists to the config.json, make sure that the Youtube playlists are **public**.
#### Sample config:
* The following config will download and watch two Playlists.
```json
{
"playlists": [
{
"link": "https://www.youtube.com/playlist?list=PLfpHPxe91z9NEwLMsxfmAehlZnoTzRFB8"
},
{
"link": "https://www.youtube.com/playlist?list=PLfpHPxe91z9OsVABLuXljh78LwiP8ToXq"
}
]
}
```
#### Split option:
* You can add the following option to split mp3s into smaller clips
```json
{
"playlists": [
{
"link": "https://www.youtube.com/playlist?list=PLfpHPxe91z9NEwLMsxfmAehlZnoTzRFB8",
"split":true,
"split-duration":"03:00"
}
]
}
```
*This will split every mp3 file into 3 min clips, with proper names.

### Start pl2mp3:
* After creating a Download Directory and customizing the config.json you can start **pl2mp3** with the following command:
```shell
pl2mp3
```
* **pl2mp3** will create a separate folder for each playlist and will start downloading and converting all videos inside the playlists.
* After that **pl2mp3** will look every 10 min for newly added videos to download them too. You can change the time by using the `--update ` flag.