ACRCloud is a cloud platform that helps excellent companies and developers integrate the most advanced ACR (Automatic Content Recognition) techniques into their products to get the abilities to recognize audios and videos, monitor radio streams, detect live TV contents and so on.

Cross-platform SDKs and Documents. 
Contact us (contact@acrcloud.com) if you have any questions.

This repository contains step-by-step instructions of common audio recognition use cases.

Download or clone this repository to start (Linux x86-64 Environment needed).

Register an free account and login.

Create an "Audio & Video Recognition" project and select options as the follow picture (Make sure the "ACRCloud Music" bucket is selected).
Save the access_key and access_key of the project for further use.

Step 2

Edit test.py and replace '<...>' in the two lines below with access_key and access_key you saved.

'access_key':'<access_key of your project>',
'access_secret':'<access_secret of your project>',

Save the changes.

Step 3

Run the script: python test.py audio_with_noise.wav

Result will be:

recognizing by file ...
{"status":{"msg":"Success","code":0,"version":"1.0"},"metadata":{"music":[{"external_ids":{"isrc":"USAT21500254","upc":"075679928634"},"play_offset_ms":46360,"external_metadata":{"spotify":{"album":{"id":"0HfAFdxzAEOn1H9WQeaqgZ"},"artists":[{"id":"6VuMaDnrHyPL1p4EHjYLi7"},{"id":"6JL8zeS1NmiOftqZTRgdTz"}],"track":{"id":"1zxFtsKWwuVpz3nSqNYshe"}},"deezer":{"album":{"id":9602354},"artists":[{"id":1362735}],"genres":[{"id":132}],"track":{"id":94424876}}},"label":"Artist Partners","release_date":"2015-02-10","title":"Marvin Gaye (feat. Meghan Trainor)","duration_ms":"187741","album":{"name":"Marvin Gaye (feat. Meghan Trainor)"},"acrid":"aa1c08067d9e3071f8a4d319fc186cb3","genres":[{"name":"Pop"}],"artists":[{"name":"Charlie Puth"}]}],"timestamp_utc":"2015-12-01 09:41:32"},"result_type":0}

audio_with_noise.wav is recognised to be: "Marvin Gaye (feat. Meghan Trainor)" of "Charlie Puth".

Step 1

Create another project and select "Line-in Audio (Audio of original file or stream without noise)" for "Client-End Audio Source" option.

Step 2

Edit test.py with access_key and access_key of this project and save it.

Step 3

Run the script: python test.py audio_without_noise.wav

Result will be:

recognizing by file ...
{"status":{"msg":"Success","code":0,"version":"1.0"},"metadata":{"music":[{"external_ids":{"isrc":"USSM11500753","upc":"886445105360"},"play_offset_ms":46880,"external_metadata":{"spotify":{"album":{"id":"39WI8tjY7vH68xrNiDKNly"},"artists":[{"id":"3QLIkT4rD2FMusaqmkepbq"}],"track":{"id":"1m0E5D8cOJyO1A2IBX4w4i"}},"itunes":{"album":{"id":991946506},"artists":[{"id":431528675}],"track":{"id":991946508}},"deezer":{"album":{"id":9679444},"artists":[{"id":427604}],"genres":[{"id":132}],"track":{"id":95138146}}},"label":"Columbia","release_date":"2015-02-13","title":"Fight Song","duration_ms":"204066","album":{"name":"Fight Song"},"acrid":"7c8d984cfa4fd9f070da057875f09897","genres":[{"name":"Pop"}],"artists":[{"name":"Rachel Platten"}]}],"timestamp_utc":"2015-12-01 09:47:47"},"result_type":0}

audio_without_noise.wav is recognised to be: "Fight Song" of "Rachel Platten".