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

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page