music-watcher

music-watcher

A small CLI tool to keep track of latest releases from music artists you are interested in.

Installation

Run npm i -g music-watcher

Usage

music-watcher --help

Print a list of available commands

music-watcher init

Create a blank music-watcher.json file. Required to store saved configuration

music-watcher add <id>

Add an artist using the MusicBrainz ID

Optional flags:

• --ignore Add the artist to the ignore list
• --name <name> Override the name of the artist in the config file.

music-watcher remove <name>

Remove an artist from the music-watcher.json file by name.

music-watcher search <name>

Add an artist to the music-watcher.json file by searching for their entry in MusicBrainz

Example output:

> music-watcher search Eluveitie
Found 1 results for 'Eluveitie'
┌────────┬───────────┬──────┬─────────┬───────┐
│ Option │ Name      │ Desc │ Country │ Score │
├────────┼───────────┼──────┼─────────┼───────┤
│ 1      │ Eluveitie │      │ CH      │ 100   │
└────────┴───────────┴──────┴─────────┴───────┘
Select a result:

music-watcher list

List all artists in the music-watcher.json file.

Example output:

┌──────────────────┬─────────┬────────┐
│ Name             │ Ignored │ Cached │
├──────────────────┼─────────┼────────┤
│ Alkonost         │ No      │ Yes    │
│ Ashtar           │ No      │ Yes    │
│ Iron Maiden      │ Yes     │ No     │
│ L’Âme Immortelle │ No      │ Yes    │
│ Sirenia          │ No      │ Yes    │
└──────────────────┴─────────┴────────┘

music-watcher fetch

Fetch a list of recent releases by all non-ignored artists

Example output:

┌──────────────────┬───────────────────────────────┬───────┬──────┐
│ Artist           │ Title                         │ Types │ Year │
├──────────────────┼───────────────────────────────┼───────┼──────┤
│ Sirenia          │ Nine Destinies and a Downfall │ Album │ 2007 │
│ Alkonost         │ Каменного сердца кровь        │ Album │ 2007 │
│ L’Âme Immortelle │ Namenlos                      │ Album │ 2008 │
│ Sirenia          │ The 13th Floor                │ Album │ 2009 │
│ Alkonost         │ On The Wings Of The Call      │ Album │ 2010 │
│ Sirenia          │ The Enigma of Life            │ Album │ 2011 │
│ L’Âme Immortelle │ Momente                       │ Album │ 2012 │
│ L’Âme Immortelle │ Fragmente                     │ Album │ 2012 │
│ Alkonost         │ Сказки Странствий             │ Album │ 2013 │
│ Sirenia          │ Perils of the Deep Blue       │ Album │ 2013 │
│ L’Âme Immortelle │ Drahtseilakt                  │ Album │ 2014 │
│ Sirenia          │ The Seventh Life Path         │ Album │ 2015 │
│ Alkonost         │ Песни белой лилии             │ Album │ 2016 │
│ Sirenia          │ Dim Days of Dolor             │ Album │ 2016 │
│ L’Âme Immortelle │ Hinter dem Horizont           │ Album │ 2018 │
└──────────────────┴───────────────────────────────┴───────┴──────┘

Config file options

Ignore release types

{
    "ignore": {
        "types": [
            "Single",
            "Compilation",
            "Live",
            "Remix"
        ]
    }
}

Ignore artists from music-library fetch

{
    "ignore": {
        "artists": [
            "Artist name"
        ]
    }
}

Edit number of results returned

{
    "options": {
        "limit": 15
    }
}