# song-dl

**Repository Path**: mirrors_mathisonian/song-dl

## Basic Information

- **Project Name**: song-dl
- **Description**: download a song from youtube
- **Primary Language**: Unknown
- **License**: ISC
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# song-dl
download the best matching song from youtube

NOTE - requires `ffmpeg` (on osx install with `brew install ffmpeg`)

## usage

### command line

```js
$ npm intall -g song-dl
$ sdl "song name and artist" -o outputfile.mp3 -k <YOUTUBE API KEY>
$ open outputfile.mp3
```

### node

```js
var sdl = require('song-dl');

sdl('songname and artist', 'output filename', 'youtube apikey', function(err) {
    if(!err) {
      console.log('download success');
    }
});
```