Skip to content

sakai-akinobu/lastify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

81 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lastify

npm version GitHub license CircleCI

Generate Last.fm listening report for CLI.

Installation

npm install -g lastify

Usage

You need to pass the Last.fm username and API key as arguments. The API key for Last.fm can be obtained from here.

lastify --user ${LAST_FM_USER} --api-key ${LAST_FM_API_KEY}

You can also set it as environment variables if you like.

export LASTIFY_API_KEY=${LAST_FM_API_KEY}
export LASTIFY_USER=${LAST_FM_USER}

Options

option description
-k, --api-key [api-key] API key generated by Last.fm. See also https://www.last.fm/api
-u, --user [user] User name on Last.fm.
-p, --period [period] The time period over which to retrieve. default 1month. overall | 7day | 1month | 3month | 6month | 12month
-l, --limit [limit] The number of results to fetch. default 3.
-h, --help output usage information.

Examples

lastify
# Recent Tracks
┌─────────────────────────┬─────────────────────────┬────────────────────────────┬────────────────────┐
│ Artist                  │ Album                   │ Track                      │ Date               │
├─────────────────────────┼─────────────────────────┼────────────────────────────┼────────────────────┤
│ Envy                    │ Envy/Jesu Split         │ A Winter Quest For Fantasy │                    │
├─────────────────────────┼─────────────────────────┼────────────────────────────┼────────────────────┤
│ Envy                    │ Envy/Jesu Split         │ Conclusion of Existence    │ 17 Mar 2019, 08:43 │
├─────────────────────────┼─────────────────────────┼────────────────────────────┼────────────────────┤
│ Rob Crow's Gloomy Place │ You’re Doomed. Be Nice. │ Rest Your Soul             │ 17 Mar 2019, 08:29 │
├─────────────────────────┼─────────────────────────┼────────────────────────────┼────────────────────┤
│ Rob Crow's Gloomy Place │ You’re Doomed. Be Nice. │ No Shadow Left Behind      │ 17 Mar 2019, 08:25 │
└─────────────────────────┴─────────────────────────┴────────────────────────────┴────────────────────┘

# Top Albums
┌───────────────────────────┬─────────────────────────┬────────────┐
│ Album                     │ Artist                  │ Play count │
├───────────────────────────┼─────────────────────────┼────────────┤
│ Lost Inside The Machinery │ Self-Evident            │ 729        │
├───────────────────────────┼─────────────────────────┼────────────┤
│ Information Retrieved     │ Pinback                 │ 603        │
├───────────────────────────┼─────────────────────────┼────────────┤
│ You’re Doomed. Be Nice.   │ Rob Crow's Gloomy Place │ 548        │
└───────────────────────────┴─────────────────────────┴────────────┘

# Top Artists
┌──────────────┬────────────┐
│ Artist       │ Play count │
├──────────────┼────────────┤
│ Self-Evident │ 1020       │
├──────────────┼────────────┤
│ Pinback      │ 839        │
├──────────────┼────────────┤
│ Basement     │ 706        │
└──────────────┴────────────┘

# Top Tracks
┌──────────────┬─────────────────────────┬────────────┐
│ Artist       │ Track                   │ Play count │
├──────────────┼─────────────────────────┼────────────┤
│ Self-Evident │ Waiting Forever Tonight │ 276        │
├──────────────┼─────────────────────────┼────────────┤
│ Pinback      │ Sediment                │ 190        │
├──────────────┼─────────────────────────┼────────────┤
│ Basement     │ Summer's Colour         │ 139        │
└──────────────┴─────────────────────────┴────────────┘

License

MIT license