Metadata-Version: 2.1
Name: campdown
Version: 1.43
Summary: Bandcamp track and album downloader
Home-page: https://github.com/catlinman/campdown/
Author: Catlinman
Author-email: contact@catlinman.com
License: MIT
Keywords: bandcamp,downloader,utility
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Utilities
Requires-Dist: requests (>=2.22.0)
Requires-Dist: mutagen (>=1.42.0)
Requires-Dist: docopt (>=0.6.2)


# Campdown #

Campdown is a utility that can be used to automate downloading of tracks and
albums from Bandcamp. It requires the Python interpreter, version 3.4+ and is
not platform specific.

## PyPI ##

Campdown has been added to the Python package index and can now be easily downloaded
and installed (as well as updated) using the following command.

    $ pip install campdown --upgrade

## Setup ##

Campdown can be installed allowing you to directly run the `campdown` command.
This also installs any dependencies the script might have.

    $ python3 setup.py install

If you don't want to use the setup but would like to still use the script
directly or intend to use it within your project you will have to still install
*requests*, *mutagen* and *docopt* which you can download using *pip*.

    $ pip install -r requirements.txt

To run Campdown simply execute the following command.

    $ campdown <Track, album or discography URL>

If you want to use the CLI without the setup you can run the *campdown.py*
script in the project root directory. Make sure to have dependencies installed
beforehand.

## Notice ##

Campdown allows you to download tracks that are openly available on each of
Bandcamp's sub-domains. Keep in mind that these can be accessed without using
any special tools. Campdown only automates the otherwise tedious process of
searching each page's code for the link to the given file.

This however also means that the downloaded tracks only come with a low bitrate
of 128kbit/s. This is probably to reduce traffic while viewing and listening to
the songs that are openly available.

If you want the full quality of a given track you will have to buy it from
Bandcamp as you usually would. Also, if you like a song or album you should
probably think about supporting the artist/band.

## License ##

This repository is released under the MIT license. For more information please
refer to [LICENSE](https://github.com/catlinman/campdown/blob/master/LICENSE)


