https://github.com/goto-bus-stop/get-artist-title

Get the artist and title from a string, eg. a YouTube video title.
https://github.com/goto-bus-stop/get-artist-title

music song-title

Last synced: 12 days ago
JSON representation

Get the artist and title from a string, eg. a YouTube video title.

• Host: GitHub
• URL: https://github.com/goto-bus-stop/get-artist-title
• Owner: goto-bus-stop
• License: mit
• Created: 2016-01-24T13:35:52.000Z (almost 9 years ago)
• Default Branch: default
• Last Pushed: 2022-12-09T04:04:10.000Z (almost 2 years ago)
• Last Synced: 2024-10-25T20:41:01.424Z (18 days ago)
• Topics: music, song-title
• Language: JavaScript
• Homepage: https://npmjs.com/get-artist-title
• Size: 91.8 KB
• Stars: 33
• Watchers: 3
• Forks: 3
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# get-artist-title

Get the artist and title from a full song name, eg. a YouTube video title.

## Installation

```bash

npm install get-artist-title

```

## Usage

### JavaScript

```js

const getArtistTitle = require('get-artist-title')

getArtistTitle('Taylor Swift - Out Of The Woods')

//→ ['Taylor Swift', 'Out Of The Woods']

let [artist, title] = getArtistTitle('FEMM - PoW! (Music Video)')

//→ ['FEMM', 'PoW!']

```

### CLI

```bash

$ npm install --global get-artist-title

$ format-artist-title

Usage

  $ format-artist-title 

Example

  $ format-artist-title "Ga-In (가인) - Nostalgia (노스텔지아) - Lyrics [Hangul+Translation] .mov"

  Ga-In (가인) – Nostalgia (노스텔지아)

```

## API

### `getArtistTitle(string, options={})`

Extract the artist and title from `string`. Returns an Array with two elements,

`[artist, title]`, or `null` if no artist/title can be found.

Possible `options` are:

  - `defaultArtist` - Artist name to use if an artist name/song title pair can't

    be extracted. The input string, minus any cruft, will be used as the song

    title.

  - `defaultTitle` - Song title to use if an artist name/song title pair can't

    be extracted. The input string, minus any cruft, will be used as the artist

    name.

It's useful to provide defaults if you're passing strings from an external

service. For example, a YouTube video title may not always contain the artist

name, but the name of the channel that uploaded it might be relevant.

```js

const [artist, title] = getArtistTitle('[MV] A Brand New Song!', {

  defaultArtist: 'Channel Name'

})

// → ['Channel Name', 'A Brand New Song!']

```

```js

// Assuming `video` is a Video resource from the YouTube Data API:

const [artist, title] = getArtistTitle(video.snippet.title, {

  defaultArtist: video.snippet.channelTitle

})

```

## Licence

[MIT](./LICENSE)