bandcamp_get 0.1.4
automated music downloading via selenium
License: MIT
Keywords: bandcamp-get bandcamp free music download guerrilla mail selenium webdriver downloader automated

# bandcamp-get [![Build Status](https://travis-ci.org/huntrar/bandcamp-get.svg?branch=master)](https://travis-ci.org/huntrar/bandcamp-get) [![PyPI](https://img.shields.io/pypi/dm/bandcamp-get.svg?style=flat)]()

## automated music downloading via selenium

bandcamp-get uses Selenium WebDriver to download free albums from the music website [bandcamp](https://bandcamp.com/). If run on default, bandcamp-get creates a disposable email address using [Guerrilla Mail](https://grr.la). Music sent to this inbox will be downloaded once all albums have been processed, no user interaction necessary.

## Installation
    pip install bandcamp-get

or

    pip install git+https://github.com/huntrar/bandcamp-get.git#egg=bandcamp-get

or

    git clone https://github.com/huntrar/bandcamp-get
    cd bandcamp-get
    python setup.py install

## Usage
    usage: bandcamp-get [-h] [-b BROWSER] [-e EMAIL] [-v] [USER]
    
    automated music downloading via selenium
    
    positional arguments:
      USER                  bandcamp user to download from
    
    optional arguments:
      -h, --help            show this help message and exit
      -b BROWSER, --browser BROWSER
                            enter chrome or firefox, defaults to firefox
      -e EMAIL, --email EMAIL
                            use your own email instead of a throwaway
      -v, --version         display current version

## Author
* Hunter Hammond (huntrar@gmail.com)

## Notes
* Supports both Python 2.x and Python 3.x.
* If you choose to use a throwaway email (chosen by default unless --email flag is used), then all emails sent to the throwaway will be opened and the download links followed by the WebDriver. This occurs once all albums have been emailed/otherwise downloaded.
* Closing the bandcamp browser window before all albums have been downloaded is fine and will end processing early. The links which have been emailed already will still be downloaded as long as the Guerrilla Mail window is left open.


News
====

0.1.4
------

 - cleaned up code using pylint as reference

0.1.3
------

 - pypi monthly downloads image added to readme

0.1.2
------

 - travis-ci status image added to readme

0.1.1
------

 - python 2.x and 3.x support
 - program header and description updated
 - .travis.yml and requirements.txt added

0.1.0
------

 - updated program description

0.0.11
------

 - updated setup.py classifiers

0.0.10
------

 - reformatting to conform with PEP 8
 - added shebang

0.0.9
------

 - updated some formatting and changed % to format()

0.0.8
------

 - Updated program description

0.0.7
------

 - Moved the check for straggler emails to auto_download rather than check_email

0.0.6
------

 - Firefox webdriver no longer asks before downloading .zip
 - Minor fix to download_link behavior

0.0.5
------

 - Added randomized user agent for requests and selenium drivers

0.0.4
------

 - Removed sys import

0.0.3
------

 - Made 0 or 1 positional arguments

0.0.2
------

 - Changed execution command to bandcamp-get

0.0.1
------

 - First entry