Skip to main content

Scrape audio from various websites with a simple command-line interface.

Project description

Audio Scraper
=============

|Build Status| |PyPI| |PyPI| |license|

Scrape audio from various websites with a simple command-line interface.

Install
=======

First make sure Python and pip are installed, then run:

.. code:: sh

pip install audioscrape

Usage
=====

.. code:: sh

audioscrape "acoustic guitar"

See ``audioscrape --help`` for more details.

Python API
----------

You could also use the scraper directly in Python, as:

.. code:: py

import audioscrape

audioscrape.download(query='Cerulean Crayons',
include=['guitar'],
exclude=['remix'],
quiet=True)

SoundCloud API key and download limits
--------------------------------------

This program uses SoundCloud's official Python API which requires a
registered API key. SoundCloud says an API key can be used for 15,000
requests per any 24-hour time window, and a key has been included in the
program. However, in case the key stops working, register another one
`as described by SoundCloud
here <https://github.com/soundcloud/soundcloud-python#basic-use>`__, and
use the scraper after setting the environment variable
``SOUNDCLOUD_API_KEY``, as
``SOUNDCLOUD_API_KEY="your_key" audioscrape "piano music"``.

.. |Build Status| image:: https://travis-ci.org/carlthome/audio-scraper.svg?branch=master
:target: https://travis-ci.org/carlthome/audio-scraper
.. |PyPI| image:: https://img.shields.io/pypi/v/audioscrape.svg
:target: https://pypi.python.org/pypi/audioscrape
.. |PyPI| image:: https://img.shields.io/pypi/pyversions/audioscrape.svg
:target: http://py3readiness.org/
.. |license| image:: https://img.shields.io/github/license/mashape/apistatus.svg
:target: LICENSE

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for audioscrape, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size audioscrape-0.0.4-py2.7.egg (8.7 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size audioscrape-0.0.4-py3.5.egg (8.9 kB) File type Egg Python version 3.5 Upload date Hashes View
Filename, size audioscrape-0.0.4.tar.gz (4.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page