Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

The Clarify Python 2 Helper Library wraps the entire Clarify API in Python 2.x function calls.

Project description

Clarify Python 2 Helper Library

Python 2.x helper library for the Clarify API

* Free software: MIT license


.. code-block:: bash

$ pip install clarify_python_2

You may need to use sudo if you don't have permission to install.


If you are running an older version of the python helper library, please upgrade.

.. code-block:: bash

$ pip install --upgrade clarify_python_2

You may need to use sudo if you don't have permission to upgrade.

Quickstart Guide

Getting Started

This quickstart demonstrates a simple way to get started using the Clarify API. Following these steps, it should take you no more than 5-10 minutes to have a fully functional search for your audio.

Configuring Your Environment

While you can use any programming language you choose, we provide helping libraries in a few to get you started. In Python, you simply include the Clarify file from the python_2 module, and initialize the environment with your API key:

.. code-block:: python

from clarify_python_2 import clarify

clarify.set_key('my api key')

Loading Audio

Once you've initialied the environment with your API key, you load a file like this:

.. code-block:: python

clarify.create_bundle(name='test bundle', media_url='')

Naming the bundle is optional.

Here are some audio files you can use for testing:


Hint: You don't have to download these files. Instead you can pass us these urls via the create_bundle() method shown above.

Searching Audio

To search, we'll use the search() function. If you uploaded the *Wizard of Oz* audio clip, you can search for "dorothy":

.. code-block:: python'dorothy')

Then you can process and interact the results however you wish. The code below simply shows the resulting bundle id, bundle name, and the start/end offsets for each occurrence of the search terms. This assumes that the audio clip has been indexed by the time you search. If it hasn't, wait and try again in a few minutes.

.. code-block:: python

result ='dorothy')
results = result['item_results']
items = result['_links']['items']

index = 0
for item in items:
bundle = clarify.get_bundle(item['href'])

print bundle['name']

search_hits = results[index]['term_results'][0]['matches'][0]['hits']
for search_hit in search_hits:
print str(search_hit['start']) + ' -- ' + str(search_hit['end'])


And here are the results using the *Wizard of Oz* clip we loaded.


dorothy and her friends
2.35 -- 2.59
172.49 -- 172.83
224.82 -- 225.08
271.49 -- 271.8
329.1 -- 329.31
480.45 -- 480.92

Putting it all Together

From here, we can visualize our search results with the included audio player. The player should work with no additional configuration, but the bulk of the logic is here:

.. code-block:: python

import json

result ='dorothy')
search_terms = json.dumps(result['search_terms'])
item_results = json.dumps(result['item_results'])

bundleref = result['_links']['items'][0]['href']
bundle = clarify.get_bundle(bundleref)
tracksref = bundle['_links']['clarify:tracks']['href']
tracks = clarify.get_track_list(tracksref)['tracks']
mediaURL = tracks[0]['media_url']

History (Change Log)

See `HISTORY.rst <HISTORY.rst>`_


See `TODO.rst <TODO.rst>`_


1.0.0 (2014-08-26)

* Updated to the 1.0 API.
* NB: The semantics of delete_track() have changed. delete_track() now takes an href to a track. To delte a track by index you now need to call delete_track_at_index().

0.9.0 (2014-06-16)

* Removed 'source' attribute from bundle.

0.8.0 (2014-05-04)

* Simplified initialization (and removed threading restriction).
* Separated REST cover and object libraries.
* Moved configuration variables into module's file.

0.7.0 (2014-04-30)

* New repo name.

0.3.0 (2014-04-26)

* Code cleanup.
* get_bundle_href() changed to get_self_href().
* Switched to new style classes.

0.1.0 (2014-04-20)

* First release.

Project details

Release history Release notifications

This version
History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
clarify_python_2-1.0.1.macosx-10.10-intel.exe (76.6 kB) Copy SHA256 hash SHA256 Windows Installer any Nov 16, 2014
clarify_python_2-1.0.1.tar.gz (10.2 kB) Copy SHA256 hash SHA256 Source None Nov 16, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page