Metadata-Version: 2.1
Name: bestnewmusic
Version: 0.4.1
Summary: View music reviews and weekly radio charts in the terminal
Home-page: https://github.com/ddbourgin/bestnewmusic
Author: David Bourgin
Author-email: ddbourgin@gmail.com
License: MIT
Project-URL: Source, https://github.com/ddbourgin/bestnewmusic
Keywords: music,terminal
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: chromedriver-installer
Requires-Dist: requests
Requires-Dist: termcolor
Requires-Dist: beautifulsoup4
Requires-Dist: html5lib
Requires-Dist: selenium

# bestnewmusic
[![TravisCI](https://travis-ci.org/ddbourgin/bestnewmusic.svg)](https://travis-ci.org/ddbourgin/bestnewmusic)

View recent highly rated albums in the terminal. 

![bnm](images/bnm.gif "bnm p4k")

`bnm` supports the following sources:
- [Pitchfork 8.0+ Albums](https://pitchfork.com/best/high-scoring-albums/)
- [Resident Advisor Recommends](https://www.residentadvisor.net/reviews.aspx?format=recommend)
- [AllMusic Editor's Choice](https://www.allmusic.com/newreleases/editorschoice)
- [Forced Exposure Best Sellers](https://forcedexposure.com/Best/BestIndex.html)
- [Boomkat Best Sellers](https://boomkat.com/bestsellers)
- [Midheaven Weekly Best Sellers](https://www.midheaven.com/top-selling)
- [WFMU Heavily Played Records](http://www.wfmu.org/Playlists/Wfmu/#t)

## Installation
### OSX
Some commands use Selenium and chromedriver to render Javascript-driven pages. On OSX, the easiest way to install these (if you don't have them already) is to use homebrew:
```
brew update
brew cask install google-chrome
```
then
```
pip install bestnewmusic
```

### Ubuntu
Install the [google-chrome-stable](https://www.ubuntuupdates.org/ppa/google_chrome?dist=stable) package from the Google Linux repo:
```
wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add - 
sudo sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google.list'
sudo apt-get update 
sudo apt-get install google-chrome-stable
```

Install `bnm` with pip:
```
pip install bestnewmusic
```

## Usage
```
usage: bnm [-h] [-r] [-l LENGTH] {am, p4k, ra, bk, fe, mh, wfmu}

positional arguments:
  {am,p4k,ra,bk,fe,mh,wfmu}
    - am   : AllMusic Editor's Choice
    - p4k  : Pitchfork 8.0+ Albums
    - ra   : Resident Advisor Recommends
    - bk   : Boomkat Weekly Best Sellers
    - mh   : Midheaven Weekly Best Sellers
    - fe   : Forced Exposure Weekly Best Sellers
    - wfmu : WFMU Weekly Charts

optional arguments:
  -h, --help            Show this help message and exit
  -r, --reverse         Display items in reverse order (with most recent last)
  -l, --length          Number of items to display
```

## Example
Show the WFMU weekly play charts for the current week, organized by frequency:
```bash
bnm wfmu
```
Show the first five most recent 8.0+ albums on Pitchfork (incl. reissues):
```bash
bnm p4k -l 5
```
Show the weekly bestsellers on Forced Exposure, ordered from least to most
popular:
```bash
bnm fe -r
```


